跳转到主要内容
POST
getAsset
curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getAsset",
  "params": {
    "id": "F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk"
  }
}
'
{
  "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": "性别"
          },
          {
            "value": "国王",
            "trait_type": "类型"
          },
          {
            "value": "皇家",
            "trait_type": "表情"
          },
          {
            "value": "疯狂皇冠",
            "trait_type": "帽子"
          },
          {
            "value": "疯狂",
            "trait_type": "眼睛"
          },
          {
            "value": "疯狂盔甲",
            "trait_type": "服装"
          },
          {
            "value": "皇家地毯",
            "trait_type": "背景"
          }
        ],
        "description": "管它呢。",
        "name": "疯狂小子 #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"
    }
  }
}

​
价格数据缓存

getAsset返回的价格数据是缓存的，可能不是最新的。价格信息有600秒的缓存，这意味着数据可能有最多600秒的延迟。
价格数据可用于24小时交易量排名前1万的代币，可以在响应的token_info.price_info部分找到。对于需要实时定价的应用程序，请考虑实施额外的验证。

​
MPL Core 代理和 MIP-11 组

当存在时，响应可以包括 is_agent、agent_token、asset_signer、interface 等值，例如 MplCoreGroup，以及一个用于 MIP-11 成员资格的 plugins.groups 对象。相同的可选字段由 getAssetBatch、getAssetsByOwner、getAssetsByGroup、getAssetsByCreator、getAssetsByAuthority 和 searchAssets 返回。请参阅 资产搜索指南 以获取 searchAssets 过滤器。

​
请求参数

​
id
string
要检索的 Solana NFT 或数字资产的唯一标识符。通常是 NFT 或代币的铸造地址。
​
options
object
资产数据响应的显示和格式选项。
​
options.showUnverifiedCollections
boolean
默认值:"false"
显示未验证集合的分组信息，而不是跳过它们。
​
options.showCollectionMetadata
boolean
默认值:"false"
显示集合的元数据。
​
options.showFungible
boolean
默认值:"false"
显示持有者持有的可替代代币。
​
options.showInscription
boolean
默认值:"false"
显示链上记录的资产的铭文详情。

授权

​
api-key
string
query
必填

您的 Helius API 密钥。您可以在仪表板中免费获取一个。

请求体

application/json
​
jsonrpc
enum<string>
默认值:2.0
必填

JSON-RPC 协议版本。

可用选项:
2.0
​
id
string
默认值:1
必填

请求的唯一标识符。

示例:

"1"

​
method
enum<string>
默认值:getAsset
必填

要调用的RPC方法的名称。

可用选项:
getAsset
​
params
object
必填

响应

成功响应

​
jsonrpc
enum<string>

JSON-RPC协议的版本。

可用选项:
2.0
​
id
string

用于标识请求的ID。

​
result
object