👛NFT Mints

Learn how to use Airstack to fetch all NFT mints data, from or to user(s), across Ethereum, Base, Degen Chain, and other Airstack-supported chains.

All tokens minted are essentially NFT transfers from a null address (0x00...00) to a user address that are executed by the receiving user itself. Thus, with Airstack, you can use the TokenTransfers API to fetch all user's token mints by specifying the input as follows:

Input Filter	Value	Description
operator	user's 0x address, ENS, cb.id, Lens, or Farcaster	Executor of the transaction.
from	0x0000000000000000000000000000000000000000	Sender in the ERC721/1155 token transfers.
to	user's 0x address, ENS, cb.id, Lens, or Farcaster	Receiver in the ERC721/1155 token transfers.

Table Of Contents

In this guide you will learn how to use Airstack to get NFT mints by a user.

Pre-requisites

• An Airstack account

• Basic knowledge of GraphQL

Get Started

JavaScript/TypeScript/Python

If you are using JavaScript/TypeScript or Python, Install the Airstack SDK:

npm

React

npm install @airstack/airstack-react

Node

npm install @airstack/node

yarn

React

yarn add @airstack/airstack-react

Node

yarn add @airstack/node

pnpm

React

pnpm install @airstack/airstack-react

Node

pnpm install @airstack/node

pip

pip install airstack

Then, add the following snippets to your code:

React

import { init, useQuery } from "@airstack/airstack-react";

init("YOUR_AIRSTACK_API_KEY");

const query = `YOUR_QUERY`; // Replace with GraphQL Query

const Component = () => {
  const { data, loading, error } = useQuery(query);

  if (data) {
    return <p>Data: {JSON.stringify(data)}</p>;
  }

  if (loading) {
    return <p>Loading...</p>;
  }

  if (error) {
    return <p>Error: {error.message}</p>;
  }
};

Node

import { init, fetchQuery } from "@airstack/node";

init("YOUR_AIRSTACK_API_KEY");

const query = `YOUR_QUERY`; // Replace with GraphQL Query

const { data, error } = await fetchQuery(query);

console.log("data:", data);
console.log("error:", error);

Python

import asyncio
from airstack.execute_query import AirstackClient

api_client = AirstackClient(api_key="YOUR_AIRSTACK_API_KEY")

query = """YOUR_QUERY""" # Replace with GraphQL Query

async def main():
    execute_query_client = api_client.create_execute_query_object(
        query=query)

    query_response = await execute_query_client.execute_query()
    print(query_response.data)

asyncio.run(main())

Other Programming Languages

To access the Airstack APIs in other languages, you can use https://api.airstack.xyz/gql as your GraphQL endpoint.

🤖 AI Natural Language​

Airstack provides an AI solution for you to build GraphQL queries to fulfill your use case easily. You can find the AI prompt of each query in the demo's caption or title for yourself to try.

Airstack AI (Demo)

Get NFT Mints By A User

You can fetch all NFTs minted by a user, e.g. betashop.eth, across multiple chains, such as Ethereum, Base, Degen Chain, and other Airstack-supported chains, by using the TokenTransfers API:

Try Demo

https://app.airstack.xyz/query/wY674s1t90

Show me all NFTs minted by betashop.eth

Code

Query

query MyQuery {
  Ethereum: TokenTransfers(
    input: {
      filter: {
        # Only get mints that are executed by the same user
        operator: {_eq: "betashop.eth"},
        # Mints are token transfers that has null address as `from`
        from: {_eq: "0x0000000000000000000000000000000000000000"},
        # Set this to the user that receive the token mints
        to: {_eq: "betashop.eth"},
        # Get only NFTs (ERC721/1155)
        tokenType: {_in: [ERC721, ERC1155]},
      },
      blockchain: ethereum,
      order: {blockTimestamp: DESC}
    }
  ) {
    TokenTransfer {
      blockchain
      formattedAmount
      tokenAddress
      tokenId
      tokenNft {
        metaData {
          name
        }
        contentValue {
          image {
            medium
          }
        }
      }
      tokenType
    }
  }
  Base: TokenTransfers(
    input: {
      filter: {
        # Only get mints that are executed by the same user
        operator: {_eq: "betashop.eth"},
        # Mints are token transfers that has null address as `from`
        from: {_eq: "0x0000000000000000000000000000000000000000"},
        # Set this to the user that receive the token mints
        to: {_eq: "betashop.eth"},
        # Get only NFTs (ERC721/1155)
        tokenType: {_in: [ERC721, ERC1155]},
      },
      blockchain: base,
      order: {blockTimestamp: DESC}
    }
  ) {
    TokenTransfer {
      blockchain
      formattedAmount
      tokenAddress
      tokenId
      tokenNft {
        metaData {
          name
        }
        contentValue {
          image {
            medium
          }
        }
      }
      tokenType
    }
  }
}

Response

{
  "data": {
    "Ethereum": {
      "TokenTransfer": [
        {
          "blockchain": "ethereum",
          "formattedAmount": 1,
          "tokenAddress": "0x0f92612c5f539c89dc379e8aa42e3ba862a34b7e",
          "tokenId": "8",
          "tokenNft": {
            "metaData": {
              "name": "Venture Club Alpha Membership NFT"
            },
            "contentValue": {
              "image": {
                "medium": "https://assets.uat.airstack.xyz/image/nft/li5d4XIGDPxtahI+EMjNmOiSymdFmCR0OsRC2p13nDaZQijmEYVpYlbV0t57GD8K/medium.jpg"
              }
            }
          },
          "tokenType": "ERC721"
        }
        // Other NFTs minted by betashop.eth on Ethereum
      ]
    },
    "Base": {
      "TokenTransfer": [
        {
          "blockchain": "base",
          "formattedAmount": 1,
          "tokenAddress": "0xba5e05cb26b78eda3a2f8e3b3814726305dcac83",
          "tokenId": "118",
          "tokenNft": {
            "metaData": {
              "name": null
            },
            "contentValue": {
              "image": null
            }
          },
          "tokenType": "ERC1155"
        }
      ]
    }
  }
}

Developer Support

If you have any questions or need help regarding fetching NFT mints data into your application, please join our Airstack's Telegram group.

More Resources

• TokenTransfers API Reference

• On-Chain Graph

• TokenTransfers Guides

• Token Mints Guides

• NFT Details

• NFT Balances

• NFT Holders

• Spam NFT