Skip to main content

getAsset

Returns the metadata information of a compressed or standard asset.

Parameters

  • id: (string) [required] - The base58 encoded public key of the asset to query.
  • config: (object) [optional] - Optional flags to return additional information about the asset:
    • showFungible: (boolean) - Whether to return the token_info object about the asset.
    • showUnverifiedCollections: (boolean) - Whether to return an asset from an unverified collection.
    • showCollectionMetadata: (boolean) - Whether to return the collection metadata.

Returns

result - An object with the following fields:

  • interface - The interface type of the asset. Return types include: V1_NFT, V1_PRINT, LEGACY_NFT, V2_NFT, FungibleAsset, FungibleToken, Custom, Identity, Executable, ProgrammableNFT.
  • id - The ID of the asset.
  • content - Metadata and content information:
    • $schema - The schema URI.
    • json_uri - The URI pointing to the asset's JSON metadata.
    • files - List of associated files with uri, mime, and optional contexts.
    • metadata - Metadata fields:
      • name - The name of the asset.
      • symbol - The symbol of the asset.
      • description - A description of the asset.
      • attributes - List of attributes with trait_type and value.
      • token_standard - The token standard of the asset.
  • ownership - An object containing the ownership details:
    • owner - The owner's public key.
    • frozen - Whether the asset is frozen.
    • delegated - Whether the asset is delegated.
    • delegate - The delegate's public key.
    • ownership_model - The ownership model, for example single or token.
  • compression - An object containing the asset compression details:
    • eligible - Whether the asset is eligible for compression.
    • compressed - Whether the asset is compressed.
    • data_hash - The data hash of the asset.
    • creator_hash - The creator hash of the asset.
    • asset_hash - The asset hash.
    • tree - The Merkle tree ID.
    • seq - The sequence number.
    • leaf_id - The leaf ID.
  • royalty - An object containing the royalty details:
    • royalty_model - The royalty model (creators, fanout, or single).
    • target - The target address for royalties.
    • percent - The royalty percentage.
    • basis_points - The royalty in basis points.
    • primary_sale_happened - Whether the primary sale has occurred.
    • locked - Whether the royalty is locked.
  • creators - List of creators:
    • address - The creator's public key.
    • share - The creator's share percentage.
    • verified - Whether the creator is verified.
  • grouping - Grouping details:
    • group_key - The group key (for example, collection).
    • group_value - The group value.
  • uses - An object containing the usage details:
    • use_method - The usage method (burn, multiple, or single).
    • remaining - The remaining uses.
    • total - The total uses.
  • supply - Supply details:
    • print_max_supply - The maximum supply for prints.
    • print_current_supply - The current supply for prints.
    • edition_nonce - The edition nonce.
  • mutable - Whether the asset is mutable.
  • burnt - Whether the asset is burnt.
  • token_info - Additional token info which is returned via the showFungible parameter:
    • supply - The supply of the asset.
    • decimals - The decimals supported by the asset.
    • token_program - The token program of the asset.
    • mint_authority - The mint authority of the asset.
    • freeze_authority - The freeze authority of the asset.

Example

Replace <YOUR-API-KEY> with your API key.

Request

curl https://solana-mainnet.infura.io/v3/<YOUR-API-KEY> \
-X POST \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "getAsset", "params": ["GEciJX32EwG7DeHrXgosvpDAgjiuPo3uSEUAfJPLoSBD"]}'

Response

{
"jsonrpc": "2.0",
"result": {
"interface": "Custom",
"id": "GEciJX32EwG7DeHrXgosvpDAgjiuPo3uSEUAfJPLoSBD",
"content": {
"$schema": "https://schema.metaplex.com/nft1.0.json",
"json_uri": "https://arweave.net/I657C0VaPHIN7G4iL8Lr_8nctJhoIecFIyzlMCVF6IQ",
"files": [
{
"uri": "https://arweave.net/IxZAe2W4quFYdtae3d_NFZ8kAAcledOkK6_C7H352es",
"mime": "image/png"
},
{
"uri": "https://arweave.net/IxZAe2W4quFYdtae3d_NFZ8kAAcledOkK6_C7H352es?ext=png",
"mime": "image/png"
}
],
"metadata": {
"attributes": [
{
"value": "Green",
"trait_type": "Background"
},
{
"value": "Green / Green",
"trait_type": "Fur / Skin"
},
{
"value": "Policeman's Cap",
"trait_type": "Head"
},
{
"value": "Sandwich",
"trait_type": "Mouth"
},
{
"value": "No Traits",
"trait_type": "Teeth"
},
{
"value": "Police Uniform",
"trait_type": "Clothing"
},
{
"value": "No Traits",
"trait_type": "Eyewear"
},
{
"value": 1,
"trait_type": "generation",
"display_type": "number"
},
{
"value": 2463,
"trait_type": "sequence",
"display_type": "number"
}
],
"description": "Deep in the heart of Dingus Forest echoes the sleepless cries of a troop of 10,000 apes. These aren’t just regular apes, however. These are degenerate apes.",
"name": "Degen Ape #2463",
"symbol": "DAPE"
},
"links": {
"external_url": "",
"image": "https://arweave.net/IxZAe2W4quFYdtae3d_NFZ8kAAcledOkK6_C7H352es"
}
},
"authorities": [
{
"address": "DC2mkgwhy56w3viNtHDjJQmc7SGu2QX785bS4aexojwX",
"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": "DSwfRF1jhhu6HpSuzaig1G19kzP73PfLZBPLofkw6fLD"
}
],
"royalty": {
"royalty_model": "creators",
"target": null,
"percent": 0.042,
"basis_points": 420,
"primary_sale_happened": true,
"locked": false
},
"creators": [
{
"address": "9BKWqDHfHZh9j39xakYVMdr6hXmCLHH5VfCpeq2idU9L",
"share": 39,
"verified": false
},
{
"address": "9FYsKrNuEweb55Wa2jaj8wTKYDBvuCG3huhakEj96iN9",
"share": 25,
"verified": false
},
{
"address": "HNGVuL5kqjDehw7KR63w9gxow32sX6xzRNgLb8GkbwCM",
"share": 25,
"verified": false
},
{
"address": "7FzXBBPjzrNJbm9MrZKZcyvP3ojVeYPUG2XkBPVZvuBu",
"share": 10,
"verified": false
},
{
"address": "DC2mkgwhy56w3viNtHDjJQmc7SGu2QX785bS4aexojwX",
"share": 1,
"verified": true
}
],
"ownership": {
"frozen": false,
"delegated": false,
"delegate": null,
"ownership_model": "single",
"owner": "1BWutmTvYPwDtmw9abTkS4Ssr8no61spGAvW1X6NDix"
},
"supply": {
"print_max_supply": 0,
"print_current_supply": 0,
"edition_nonce": 255
},
"mutable": false,
"burnt": false
},
"id": 0
}