Get Asset

Get an asset by its ID.

Overview

This method will return all relevant information, including metadata for a given Token or Any NFT (cNFT, pNFT, core NFT). To support tokens (Fungible Extensions), set the showFungible flag to true. You can optionally display inscription and SPL-20 token data with the showInscription flag.

getAsset

post

Body

jsonrpcstring · enumRequired

The version of the JSON-RPC protocol.

Possible values:

idstring · enumRequired

An ID to identify the request.

Possible values:

methodstring · enumRequired

The name of the DAS method to invoke.

Possible values:

Responses

200

Successful response

application/json

400

Invalid request.

application/json

401

Unauthorized request.

application/json

403

Request was forbidden.

application/json

404

The specified resource was not found.

application/json

429

Exceeded rate limit..

application/json

500

The server encountered an unexpected condition that prevented it from fulfilling the request.

application/json

post

HTTPcURLJavaScriptPython

POST / HTTP/1.1
Host: mainnet.helius-rpc.com
Content-Type: application/json
Accept: */*
Content-Length: 112

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "getAsset",
  "params": {
    "id": "F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk"
  }
}

{
  "jsonrpc": "2.0",
  "id": "text",
  "result": {
    "interface": "V1_NFT",
    "id": "text",
    "content": {
      "$schema": "text",
      "json_uri": "text",
      "files": [
        {}
      ],
      "metadata": {
        "name": "text",
        "symbol": "text"
      },
      "links": {}
    },
    "authorities": [
      {
        "address": "text",
        "scopes": [
          "text"
        ]
      }
    ],
    "compression": {
      "eligible": true,
      "compressed": true,
      "data_hash": "text",
      "creator_hash": "text",
      "asset_hash": "text",
      "tree": "text",
      "seq": 1,
      "leaf_id": 1
    },
    "grouping": [
      {
        "group_key": "text",
        "group_value": "text"
      }
    ],
    "royalty": {
      "royalty_model": "text",
      "target": "text",
      "percent": 1,
      "basis_points": 1,
      "primary_sale_happened": true,
      "locked": true
    },
    "creators": [
      {
        "address": "text",
        "share": 1,
        "verified": true
      }
    ],
    "ownership": {
      "frozen": true,
      "delegated": true,
      "delegate": "text",
      "ownership_model": "text",
      "owner": "text"
    },
    "supply": {
      "print_max_supply": 1,
      "print_current_supply": 1,
      "edition_nonce": 1
    },
    "mutable": true,
    "burnt": true,
    "token_info": {
      "supply": 1,
      "decimals": 1,
      "token_program": "text",
      "mint_authority": "text",
      "freeze_authority": "text"
    }
  }
}

Code 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' },
// ];