Get Asset

Get an asset by its ID.

This method is the fastest way to lookup NFTs (including metadata) on Solana.

Overview

This method will return all relevant information for a given standard or compressed NFT.

getAsset

POSThttps://mainnet.helius-rpc.com/?api-key=<api_key>

Query parameters

Body

application/json

jsonrpc*enum

The version of the JSON-RPC protocol.

2.0

id*string

An ID to identify the request.

method*enum

The name of the DAS method to invoke.

getAsset

params*object

Response

200400401403404429500

Successful response

Body

application/json

interfaceenum

The interface of the asset.

V1_NFTV1_PRINTLEGACY_NFTV2_NFTFungibleAssetFungibleTokenCustomIdentityExecutableProgrammableNFT

idstring

The ID of the asset.

contentobject

The content of the asset.

authoritiesobject

compressionobject

groupingobject

royaltyobject

creatorsobject

ownershipobject

mint_extensionsobject

The mint extensions details for Token2022.

supplynullable object

Supply details of master or edition NFT.

token_infoobject

Details about the specific token.

inscriptionobject

spl20object

Request

JavaScriptCurl

const response = await fetch('https://mainnet.helius-rpc.com/?api-key=<api_key>', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "text",
      "method": "getAsset",
      "params": {}
    }),
});
const data = await response.json();

Response

{
  "interface": "V1_NFT",
  "id": "string",
  "content": {
    "$schema": "text",
    "json_uri": "text",
    "files": [],
    "metadata": {
      "attributes": [],
      "description": "text",
      "name": "text",
      "symbol": "text"
    },
    "links": {
      "external_url": "text"
    }
  },
  "authorities": {
    "address": "text",
    "scopes": [
      "text"
    ]
  },
  "compression": {
    "eligible": false,
    "compressed": false,
    "data_hash": "text",
    "creator_hash": "text",
    "asset_hash": "text",
    "tree": "text"
  },
  "grouping": {
    "group_key": "text",
    "group_value": "text"
  },
  "royalty": {
    "royalty_model": "text",
    "target": "text",
    "percent": 0,
    "primary_sale_happened": false,
    "locked": false
  },
  "creators": {
    "address": "text",
    "verified": false
  },
  "ownership": {
    "frozen": false,
    "delegated": false,
    "delegate": "text",
    "ownership_model": "text",
    "owner": "text",
    "supply": "text",
    "mutable": false,
    "burnt": false
  },
  "mint_extensions": {
    "confidential_transfer_mint": {
      "authority": "text",
      "auto_approve_new_accounts": false,
      "auditor_elgamal_pubkey": "text"
    },
    "confidential_transfer_fee_config": {
      "authority": "text",
      "withdraw_withheld_authority_elgamal_pubkey": "text",
      "harvest_to_mint_enabled": false,
      "withheld_amount": "text"
    },
    "transfer_fee_config": {
      "transfer_fee_config_authority": "text",
      "withdraw_withheld_authority": "text",
      "older_transfer_fee": {
        "epoch": "text",
        "maximum_fee": "text",
        "transfer_fee_basis_points": "text"
      },
      "newer_transfer_fee": {
        "epoch": "text"
      }
    },
    "metadata_pointer": {
      "authority": "text",
      "metadata_address": "text"
    },
    "mint_close_authority": {
      "close_authority": "text"
    },
    "permanent_delegate": {
      "delegate": "text"
    },
    "transfer_hook": {
      "authority": "text",
      "program_id": "text"
    },
    "interest_bearing_config": {
      "rate_authority": "text"
    },
    "default_account_state": "text",
    "confidential_transfer_account": {
      "approved": false,
      "elgamal_pubkey": "text",
      "pending_balance_lo": "text",
      "pending_balance_hi": "text",
      "available_balance": "text",
      "decryptable_available_balance": "text",
      "allow_confidential_credits": false,
      "allow_non_confidential_credits": false
    },
    "metadata": {
      "update_authority": "text",
      "mint": "text",
      "name": "text",
      "symbol": "text",
      "uri": "text",
      "additional_metadata": [
        {
          "key": "text",
          "value": "text"
        }
      ]
    }
  },
  "supply": {
    "master_edition_mint": "text"
  },
  "token_info": {
    "symbol": "text",
    "token_program": "text",
    "price_info": {
      "price_per_token": 0,
      "currency": "text"
    },
    "mint_authority": "text",
    "freeze_authority": "text"
  },
  "inscription": {
    "contentType": "text",
    "encoding": "text",
    "validationHash": "text",
    "inscriptionDataAccount": "text",
    "authority": "text"
  }
}

Fungible Token Extension

At Helius, we've extended this method to support all tokens (SPL and Token22). We include all token information (supply, balance, and price), and parse Token22 extensions. To enable this feature, set the showFungible flag to true.

To learn more, please visit Fungible Token Extension (Beta).

Inscriptions & SPL-20

You can optionally display inscription and SPL-20 token data with the showInscription flag. You can learn more about inscriptions and SPL-20 here.

Please note that this is an experimental feature.

The Helius API does not verify SPL-20 tokens. Trade at your own risk. For more information, please use the validator tool or join the Libreplex Discord channel.

Example

Get info on Mad Lad #8613

const url = `https://mainnet.helius-rpc.com/?api-key=<api_key>`

const getAsset = async () => {
  const response = await fetch(url, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: 'my-id',
      method: 'getAsset',
      params: {
        id: 'F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk'
      },
    }),
  });
  const { result } = await response.json();
  console.log("Asset: ", result);
};
getAsset();

Fungible token example

const url = `https://mainnet.helius-rpc.com/?api-key=<api_key>`

const getAsset = async () => {
  const response = await fetch(url, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: 'my-id',
      method: 'getAsset',
      params: {
        id: 'J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn',
        displayOptions: {
	    showFungible: true //return details about a fungible token
	}
      },
    }),
  });
  const { result } = await response.json();
  console.log("Asset: ", result);
};
getAsset();

Inscription & SPL-20 example

const url = `https://mainnet.helius-rpc.com/?api-key=<api_key>`

const getAsset = async () => {
    const response = await fetch(url, {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
        },
        body: JSON.stringify({
            jsonrpc: '2.0',
            id: 'my-id',
            method: 'getAsset',
            params: {
                id: 'AKo9P7S8FE9NYeAcrtZEpimwQAXJMp8Lrt8p4dMkHkY2',
                displayOptions: {
                    showInscription: true, // shows inscription and spl-20 data
                },
            },
        }),
    });
    const { result } = await response.json();
    console.log([result.inscription, result.spl20]);
};
getAsset();

// Example output:
// [
//     {
//         order: 308332,
//         size: 52,
//         contentType: 'application/text',
//         encoding: 'base64',
//         validationHash: '907e00a18f952ade319c21b90764e5d0a08ec31c92e792f806a995e8524535ca',
//         inscriptionDataAccount: '9qM9ThkVPxjq4TyBjCs1qpY15VYVim2Qh7uR5yG1Da3T',
//     },
//     { p: 'spl-20', op: 'mint', tick: 'helius', amt: '1' },
// ];