Get Asset Batch

Get multiple assets by their IDs.

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

You can pass up to 1,000 IDs in this request.

Overview

This method will return valuable NFT metadata for compressed or standard NFTs.

getAssetBatch

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.

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
    }
  }
]

Example

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

const getAssetBatch = async () => {
  const response = await fetch(url, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: 'my-id',
      method: 'getAssetBatch',
      params: {
        ids: [
          '81bxPqYCE8j34nQm7Rooqi8Vt3iMHLzgZJ71rUVbQQuz',
          'CWHuz6GPjWYdwt7rTfRHKaorMwZP58Spyd7aqGK7xFbn'
        ]
      },
    }),
  });
  const { result } = await response.json();
  console.log("Assets: ", result);
};
getAssetBatch();