Get Assets by Group

Get a list of assets by a group key and value.

You can use this endpoint to fetch mint lists for an NFT collection!

Overview

This will return the asset information for a specific group provided (i.e Collection). This can return compressed or standard NFTs.

The page parameter in the request starts at 1 .

getAssetsByGroup

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

Query parameters

Body

application/json

jsonrpcenum

The version of the JSON-RPC protocol.

2.0

idstring

An ID to identify the request.

methodenum

The name of the DAS method to invoke.

getAssetsByGroup

paramsobject

Response

200400401403404429500

Successful response

Body

application/json

assetsobject

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({}),
});
const data = await response.json();

Response

{
  "assets": {
    "total": 2,
    "limit": 100,
    "page": 1,
    "items": [
      {
        "interface": "V1_NFT",
        "id": "text",
        "authorities": [],
        "creators": [],
        "mutable": false,
        "burnt": false,
        "inscription": {
          "contentType": "text",
          "encoding": "text",
          "validationHash": "text",
          "inscriptionDataAccount": "text",
          "authority": "text"
        }
      }
    ]
  }
}

Suggested Use Cases

• NFT Collection Page

• NFT Mintlist

• Token Gated dApps

Example

Mad Lads Mint List

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

const getAssetsByGroup = async () => {
    const response = await fetch(url, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        jsonrpc: '2.0',
        id: 'my-id',
        method: 'getAssetsByGroup',
        params: {
          groupKey: 'collection',
          groupValue: 'J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w',
          page: 1, // Starts at 1
          limit: 1000,
        },
      }),
    });
    const { result } = await response.json();
    console.log("Assets by Group: ", result.items);
};
getAssetsByGroup(); 

Pagination with Mad Lads

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

const getAssetsByGroup = async () => {
  console.time("getAssetsByGroup"); // Start the timer
  let page = 1;
  let assetList = [];

  while (page) {
    const response = await fetch(url, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        jsonrpc: "2.0",
        id: "my-id",
        method: "getAssetsByGroup",
        params: {
          groupKey: "collection",
          groupValue: "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w",
          page: page,
          limit: 1000,
        },
      }),
    });
    const { result } = await response.json();

    assetList.push(...result.items);
    if (result.total !== 1000) {
      page = false;
    } else {
      page++;
    }
  }
  const resultData = {
    totalResults: assetList.length,
    results: assetList,
  };
  console.log("Mad Lads Assets: ", resultData);
};
getAssetsByGroup();