Get Nft Editions

Get information about all the edition NFTs for a specific master NFT.

Overview

Retrieve all the NFT editions associated with a specific master NFT . This is an efficient way to get all the printable editions for a master edition NFT.

getNftEditions

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.

getNftEditions

params*object

Response

200400401403404429500

Successful response

Body

application/json

totalinteger

The total number of NFT editions found.

limitinteger

The maximum number of NFT editions requested.

pageinteger

The current page of results.

editionsarray

An array of editions.

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

Response

{
  "total": 2,
  "limit": 100,
  "page": 1,
  "editions": []
}

Examples

How to get all the NFT editions for a specific master edition:

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

const getNftEditions = async () => {
  const response = await fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      jsonrpc: "2.0",
      method: "getNftEditions",
      id: "helius-test",
      params: {
        mint: "Ey2Qb8kLctbchQsMnhZs5DjY32To2QtPuXNwWvk4NosL"
        page: 1,
        limit: 2
      },
    }),
  });
  const data = await response.json();

  if (!data.result) {
    console.error("No result in the response", data);
    return;
  }

  console.log(JSON.stringify(data.result, null, 2));
};

getNftEditions();

Response:

{
    "jsonrpc": "2.0",
    "result": {
        "total": 2,
        "limit": 2,
        "page": 1,
        "master_edition_address": "8SHfqzJYABeGfiG1apwiEYt6TvfGQiL1pdwEjvTKsyiZ",
        "supply": 66,
        "max_supply": 69,
        "editions": [
            {
                "mint": "GJvFDcBWf6aDncd1TBzx2ou1rgLFYaMBdbYLBa9oTAEw",
                "edition_address": "AoxgzXKEsJmUyF5pBb3djn9cJFA26zh2SQHvd9EYijZV",
                "edition": 1
            },
            {
                "mint": "9yQecKKYSHxez7fFjJkUvkz42TLmkoXzhyZxEf2pw8pz",
                "edition_address": "giWoA4jqHFkodPJgtbRYRcYtiXbsVytnxnEao3QT2gg",
                "edition": 2
            }
        ]
    },
    "id": "0"
}