> ## 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.
# getAsset
> Solana NFT、圧縮NFT、またはトークンの詳細情報を、メタデータ、所有権、価格データ、オンチェーン属性を含めて取得します
## 価格データのキャッシュ
getAssetによって返される価格データはキャッシュされており、新鮮ではない場合があります。価格情報は600秒間キャッシュされるため、データは最大600秒前のものである可能性があります。
価格データは24時間のボリュームで上位10,000のトークンに利用可能であり、レスポンスの指定されたセクションにあります。リアルタイムの価格を必要とするアプリケーションでは、追加の検証を検討してください。
## MPLコア エージェントとMIP-11グループ
存在する場合、レスポンスには指定された値やMIP-11メンバーシップ用のオブジェクトを含むことがあります。同じオプションフィールドは指定されたフィルターによって返されます。[アセット検索ガイド](/ja/das/search)を参照してください。
## リクエストパラメータ
Solana NFTまたはデジタルアセットを取得するための一意識別子です。通常、これはNFTまたはトークンのミントアドレスです。
アセットデータレスポンスの表示とフォーマットオプション。
未検証コレクションのグループ情報を表示し、それらをスキップしません。
コレクションのメタデータを表示します。
所有者が保有する代替可能トークンを表示します。
## OpenAPI
````yaml ja/openapi/das-api/getAsset.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応答には、DASインデックスが完全であることが保証される最後のスロットを示す`last_indexed_slot`フィールドが含まれます。このスロットまでのオンチェーンデータがすべてインデックスされています。このスロットを超えたデータもすでにインデックスされている場合がありますが、保証されません。
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を識別するための圧縮状態を確認
- NFTコレクション分析のためのコレクショングループの表示
operationId: rpc
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: >-
この資産がエージェントアイデンティティを持っているかどうか。MPL
Core資産でAgentIdentity外部プラグインアダプタを使用するもののみがtrueになります。デフォルトはfalseで、falseの場合は応答から省略されます。
agent_token:
type: string
description: >-
Agent
RegistryプログラムからのエージェントトークンのBase58エンコードされたミントアドレス。対応するレジストリエントリがない場合は省略されます。
asset_signer:
type: string
description: >-
MPL
Core資産のために資産IDから決定的に導出された、資産に代わって署名するために使用されるBase58エンコードされたPDA。該当しない場合は省略されます。
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: Merkle木のアドレス。
seq:
type: integer
description: シーケンス番号。
leaf_id:
type: integer
description: Merkle木内の葉識別子。
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: MPL CoreグループアカウントのBase58アドレス。
member_number:
type: integer
description: グループ内のメンバー番号。
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: Fock it.
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)で入手可能です。
````