Get Assets by Creator

Get a list of assets created by an address.

Overview

This will return a list of assets for the given creator provided. This can define compressed or standard NFTs.

The page parameter in the request starts at 1

getAssetsByCreator

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

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.

getAssetsByCreator

params*object

Response

200400401403404429500

Successful response

Body

application/json

jsonrpcstring

Example: "2.0"

resultobject

Request

JavaScriptCurlPython

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

Response

200400401403404429500

{
  "jsonrpc": "2.0",
  "result": {
    "total": 1,
    "limit": 1,
    "page": 1,
    "items": [
      {
        "interface": "Custom",
        "id": "JEH7cJxAKdprFG5AvdsY2c4ZqojxLBjFmw19zADV6oK5",
        "content": {
          "$schema": "https://schema.metaplex.com/nft1.0.json",
          "json_uri": "https://famousfoxes.com/metadata/7045.json",
          "files": [
            {
              "uri": "https://famousfoxes.com/hd/7045.png",
              "cdn_uri": "https://cdn.helius-rpc.com/cdn-cgi/image//https://famousfoxes.com/hd/7045.png",
              "mime": "image/png"
            }
          ]
        },
        "authorities": [
          {
            "address": "3pMvTLUA9NzZQd4gi725p89mvND1wRNQM3C8XEv1hTdA",
            "scopes": [
              "full"
            ]
          }
        ],
        "compression": {
          "eligible": false,
          "compressed": false,
          "data_hash": "",
          "creator_hash": "",
          "asset_hash": "",
          "tree": "",
          "seq": 0,
          "leaf_id": 0
        },
        "grouping": [
          {
            "group_key": "collection",
            "group_value": "BUjZjAS2vbbb65g7Z1Ca9ZRVYoJscURG5L3AkVvHP9ac"
          }
        ],
        "royalty": {
          "royalty_model": "creators",
          "target": null,
          "percent": 0.042,
          "basis_points": 420,
          "primary_sale_happened": true,
          "locked": false
        },
        "creators": [
          {
            "address": "D3XrkNZz6wx6cofot7Zohsf2KSsu2ArngNk8VqU9cTY3",
            "share": 0,
            "verified": true
          }
        ],
        "ownership": {
          "frozen": false,
          "delegated": false,
          "delegate": null,
          "ownership_model": "single",
          "owner": "1BWutmTvYPwDtmw9abTkS4Ssr8no61spGAvW1X6NDix"
        }
      }
    ]
  }
}

Use Cases

• NFT creator portfolio

• NFT Search Engine

• NFT-specific blockchain explorer

Code Example

Degen Poet Created NFTs

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

const getAssetsByCreator = async () => {
  const response = await fetch(url, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: 'my-id',
      method: 'getAssetsByCreator',
      params: {
        creatorAddress: 'D3XrkNZz6wx6cofot7Zohsf2KSsu2ArngNk8VqU9cTY3',
        onlyVerified: true,
        page: 1, // Starts at 1
        limit: 1000
      },
    }),
  });
  const { result } = await response.json();
  console.log("Assets by Creator: ", result.items);
};
getAssetsByCreator();