> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# getCompressedTokenBalancesByOwnerV2
> 返回给定所有者的代币余额。V2 版本解决了一个小的命名问题。
## 请求参数
一个base 58编码的字符串。
作为base58字符串表示的Solana公钥。
作为base58字符串表示的Solana公钥。
## OpenAPI
````yaml zh/openapi/zk-compression/getCompressedTokenBalancesByOwnerV2.yaml POST /
openapi: 3.1.0
info:
title: Solana Digital Asset Standard (DAS) API
version: 1.0.0
description: >
Solana Digital Asset
Standard（DAS）APIは、SolanaブロックチェーンのNFTおよびデジタルアセットへの包括的かつ標準化されたアクセスを提供します。強力なAPIセットにより、開発者はSolana上のあらゆるデジタルアセットに関する詳細情報を取得でき、トークン標準に関係なく一貫したデータフォーマットで提供されます。
すべてのDASレスポンスには、`last_indexed_slot`フィールドが含まれており、DASインデックスが完全であることが保証される最も最近のスロットを示します。このスロットまでのオンチェーンデータがすべてインデックスされました。このスロット以降のデータもすでにインデックスされている可能性がありますが、保証はされていません。
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: メインネット RPCエンドポイント
- url: https://devnet.helius-rpc.com
description: Devnet RPCエンドポイント
security: []
paths:
/:
post:
tags:
- RPC
summary: getAsset
description: >
任意のSolana
NFTまたはデジタルアセットのユニークな識別子に基づいて、包括的なデータを取得します。このエンドポイントは、すべてのオンチェーンおよびオフチェーンのメタデータ、所有権の詳細、ロイヤリティ情報、コレクションデータ、および圧縮状態を提供します。getAssetメソッドは、圧縮されたNFT（cNFT）、プログラム可能なNFT（pNFT）、および従来のSPLトークンを含むすべてのトークン標準に対応しています。
このエンドポイントを利用して、以下のことを行います：
- NFTマーケットプレイスのリスティングの完全なメタデータを取得
- ウォレット統合のためのアセット所有情報を取得
- ロイヤリティの施行のためのロイヤリティおよびクリエイターデータへのアクセス
- 圧縮ステータスを確認してコスト効率の良い圧縮NFTを特定
- コレクション分析のためのコレクショングルーピングを表示
operationId: getAsset
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
description: JSON-RPCプロトコルのバージョン。
enum:
- '2.0'
default: '2.0'
id:
type: string
description: リクエストの一意の識別子。
example: '1'
default: '1'
method:
type: string
description: 起動するRPCメソッドの名前。
enum:
- getAsset
default: getAsset
params:
type: object
default:
id: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
properties:
id:
type: string
description: >-
情報を取得するSolana
NFTまたはデジタルアセットのユニークな識別子。通常はNFTまたはトークンのミントアドレスです。
example: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
options:
type: object
description: アセットデータレスポンスの表示およびフォーマットオプション。
properties:
showUnverifiedCollections:
type: boolean
default: false
description: 未検証のコレクションに関するグループ情報をスキップせずに表示します。
showCollectionMetadata:
type: boolean
default: false
description: コレクションのメタデータを表示します。
showFungible:
type: boolean
description: オーナーが保有するファンジブルトークンを表示します。
default: false
responses:
'200':
description: 成功した応答
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: JSON-RPCプロトコルのバージョン。
id:
type: string
description: リクエストを識別するために使用されるID。
result:
type: object
properties:
last_indexed_slot:
type: integer
description: このスロットまでのすべてのデータがインデックスされていることが保証されます。
interface:
type: string
description: Solanaデジタルアセットのインターフェースタイプであり、トークン標準と実装を示します。
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplBubblegumV2
- MplCoreCollection
- MplCoreGroup
is_agent:
type: boolean
description: >-
このアセットがAgent Identityを持つかどうか。MPL
CoreアセットでAgentIdentity外部プラグインアダプタを使用するもののみtrueです。デフォルトはfalseで、falseの場合はレスポンスから省略されます。
agent_token:
type: string
description: >-
Agent
RegistryプログラムからのagentトークンのBase58エンコード済みミントアドレス。対応するレジストリエントリがない場合は省略されます。
asset_signer:
type: string
description: >-
アセットの代理で署名するために使用されるBase58エンコード済みPDA；MPL
CoreアセットのためにアセットIDから決定論的に導出されます。該当しない場合は省略されます。
id:
type: string
description: アセットの一意の識別子。
content:
type: object
description: Solanaデジタルアセットのコンテンツ情報、メタデータ、ファイル、リンクを含む。
properties:
$schema:
type: string
description: アセットメタデータのスキーマURL。
json_uri:
type: string
description: >-
通常はArweaveまたは他の分散ストレージ上にホストされているSolana
NFTのJSONメタデータを指すURI。
files:
type: array
description: アセットに関連付けられたファイルの配列。
items:
type: object
metadata:
type: object
description: >-
Solanaデジタルアセットに関する完全なメタデータ情報、名前、シンボル、属性、およびトークン標準を含む。
properties:
name:
type: string
description: アセットの名前。
symbol:
type: string
description: アセットのシンボル。
attributes:
type: array
description: 属性の配列。
items:
type: object
properties:
value:
type: string
description: 属性の値。
trait_type:
type: string
description: 属性のタイプ。
description:
type: string
description: アセットの説明。
token_standard:
type: string
description: 使用されるトークン標準。
links:
type: object
description: アセットに関連する外部リンク。
authorities:
type: array
description: アセットに関連付けられた権限のリスト。
items:
type: object
properties:
address:
type: string
description: 権限のアドレス。
scopes:
type: array
description: 権限の範囲。
items:
type: string
compression:
type: object
description: >-
Solanaデジタルアセットの圧縮に関する詳細であり、圧縮されたNFTが状態証明の検証を持つかどうかを示します。
properties:
eligible:
type: boolean
description: アセットが圧縮可能かどうか。
compressed:
type: boolean
description: >-
Solanaの状態圧縮技術を使用してアセットが現在圧縮されているかどうかを示し、ストレージコストを削減します。
data_hash:
type: string
description: アセットデータのハッシュ。
creator_hash:
type: string
description: クリエーターデータのハッシュ。
asset_hash:
type: string
description: アセット全体のハッシュ。
tree:
type: string
description: マークルツリーのアドレス。
seq:
type: integer
description: シーケンス番号。
leaf_id:
type: integer
description: マークルツリーのリーフ識別子。
grouping:
type: array
description: アセットのグルーピング情報。
items:
type: object
properties:
group_key:
type: string
description: グループを識別するキー。
group_value:
type: string
description: グループに関連付けられた値。
royalty:
type: object
description: >-
Solanaデジタルアセットのロイヤリティ情報であり、マーケットプレイス料金の計算およびクリエイターへの支払いに使用されます。
properties:
royalty_model:
type: string
description: ロイヤリティのために使用されるモデル。
target:
type:
- string
- 'null'
description: ロイヤリティのターゲットアドレス。
percent:
type: number
description: ロイヤリティのパーセンテージ。
basis_points:
type: integer
description: ロイヤリティのベーシスポイント。
primary_sale_happened:
type: boolean
description: プライマリセールが発生したかどうか。
locked:
type: boolean
description: ロイヤリティがロックされているかどうか。
creators:
type: array
description: アセットのクリエイターのリスト。
items:
type: object
properties:
address:
type: string
description: クリエイターのアドレス。
share:
type: integer
description: クリエイターのシェアパーセンテージ。
verified:
type: boolean
description: クリエイターが検証されているかどうか。
ownership:
type: object
description: Solanaデジタルアセットの所有権の詳細を含む、現在のオーナー、委任状態、凍結情報を含む。
required:
- frozen
- delegated
- ownership_model
- owner
properties:
frozen:
type: boolean
description: アセットが凍結されているかどうか。
delegated:
type: boolean
description: アセットが委任されているかどうか。
delegate:
type:
- string
- 'null'
description: 委任されている場合の委任先のアドレス。
ownership_model:
type: string
description: 所有権のモデル。
owner:
type: string
description: オーナーのアドレス。
supply:
type:
- object
- 'null'
description: アセットの供給情報。
properties:
print_max_supply:
type: integer
description: 印刷可能な最大供給量。
print_current_supply:
type: integer
description: 現在の印刷供給量。
edition_nonce:
type: integer
description: エディションのノンス。
mutable:
type: boolean
description: アセットが変更可能かどうか。
burnt:
type: boolean
description: アセットが焼却されているかどうか。
token_info:
type: object
description: トークン固有の情報。
properties:
supply:
type: integer
description: 合計トークン供給量。
decimals:
type: integer
description: 小数点以下の桁数。
token_program:
type: string
description: トークンプログラムID。
mint_authority:
type: string
description: ミント権限のアドレス。
freeze_authority:
type: string
description: 凍結権限のアドレス。
plugins:
type: object
description: >-
MPL
Coreプラグインのペイロード。アセットおよびコレクションには`groups`プラグイン（MIP-11）が含まれている場合があります。
additionalProperties: true
properties:
groups:
type: object
description: メンバーシップメタデータを持つMIP-11 Groupsプラグイン。
properties:
authority:
type: object
description: 'プラグイン権限（例: UpdateAuthority）。'
additionalProperties: true
data:
type: object
properties:
groups:
type: array
description: このアセットまたはコレクションのグループメンバーシップ。
items:
type: object
properties:
group_address:
type: string
description: >-
Base58 address of the MPL Core group
account.
member_number:
type: integer
description: Member number within the group.
examples:
success:
value:
jsonrpc: '2.0'
id: test
result:
last_indexed_slot: 365749093
interface: ProgrammableNFT
id: F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk
content:
$schema: https://schema.metaplex.com/nft1.0.json
json_uri: >-
https://madlads.s3.us-west-2.amazonaws.com/json/8420.json
files:
- uri: >-
https://madlads.s3.us-west-2.amazonaws.com/images/8420.png
cdn_uri: >-
https://cdn.helius-rpc.com/cdn-cgi/image//https://madlads.s3.us-west-2.amazonaws.com/images/8420.png
mime: image/png
- uri: >-
https://arweave.net/qJ5B6fx5hEt4P7XbicbJQRyTcbyLaV-OQNA1KjzdqOQ/0.png
cdn_uri: >-
https://cdn.helius-rpc.com/cdn-cgi/image//https://arweave.net/qJ5B6fx5hEt4P7XbicbJQRyTcbyLaV-OQNA1KjzdqOQ/0.png
mime: image/png
metadata:
attributes:
- value: Male
trait_type: Gender
- value: King
trait_type: Type
- value: Royal
trait_type: Expression
- value: Mad Crown
trait_type: Hat
- value: Madness
trait_type: Eyes
- value: Mad Armor
trait_type: Clothing
- value: Royal Rug
trait_type: Background
description: 説明
name: 'Mad Lads #8420'
symbol: MAD
token_standard: ProgrammableNonFungible
links:
image: >-
https://madlads.s3.us-west-2.amazonaws.com/images/8420.png
external_url: https://madlads.com
authorities:
- address: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
scopes:
- full
compression:
eligible: false
compressed: false
data_hash: ''
creator_hash: ''
asset_hash: ''
tree: ''
seq: 0
leaf_id: 0
grouping:
- group_key: collection
group_value: J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w
royalty:
royalty_model: creators
target: null
percent: 0.042
basis_points: 420
primary_sale_happened: true
locked: false
creators:
- address: 5XvhfmRjwXkGp3jHGmaKpqeerNYjkuZZBYLVQYdeVcRv
share: 0
verified: true
- address: 2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW
share: 100
verified: true
ownership:
frozen: true
delegated: false
delegate: null
ownership_model: single
owner: 4zdNGgAtFsW1cQgHqkiWyRsxaAgxrSRRynnuunxzjxue
supply:
print_max_supply: 0
print_current_supply: 0
edition_nonce: 254
mutable: true
burnt: false
token_info:
supply: 1
decimals: 0
token_program: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
mint_authority: TdMA45ZnakQCBt5XUvm7ib2htKuTWdcgGKu1eUGrDyJ
freeze_authority: TdMA45ZnakQCBt5XUvm7ib2htKuTWdcgGKu1eUGrDyJ
'400':
description: 不正なリクエストです。サーバーは無効な構文のためリクエストを理解できません。
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32602
message:
type: string
example: 無効なリクエストパラメータです。
id:
type: string
example: '1'
'401':
description: 認証されていません。クライアントは要求された応答を得るために認証を行う必要があります。
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32001
message:
type: string
example: 認証に失敗しました。不足しているか無効なAPIキーです。
id:
type: string
example: '1'
'403':
description: 禁止されています。クライアントはコンテンツにアクセスする権限がありません。
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32003
message:
type: string
example: このリソースにアクセスする権限がありません。
id:
type: string
example: '1'
'404':
description: 見つかりません。サーバーが要求されたリソースを見つけることができません。
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32004
message:
type: string
example: 要求されたアセットが見つかりませんでした。
id:
type: string
example: '1'
'429':
description: リクエストが多すぎます。ユーザーは指定された時間内に多くのリクエストを送信しました。
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32029
message:
type: string
example: レートリミットを超えました。後でもう一度やり直してください。
id:
type: string
example: '1'
'500':
description: 内部サーバーエラー。サーバーが処理方法がわからない状況に遭遇しました。
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32000
message:
type: string
example: サーバーで予期しないエラーが発生しました。
id:
type: string
example: '1'
security:
- ApiKeyQuery: []
components:
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
あなたのHelius
APIキー。無料で[ダッシュボード](https://dashboard.helius.dev/api-keys)で取得できます。
````