Skip to content

Latest commit

 

History

History
260 lines (187 loc) · 7.29 KB

erc20-mints.md

File metadata and controls

260 lines (187 loc) · 7.29 KB
description
Learn how to use Airstack to fetch all ERC20 token mints data, from or to user(s), across Ethereum, Base, Degen Chain, and other Airstack-supported chains.

👛 ERC20 Mints

All ERC20 tokens minted are essentially ERC20 token 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 ERC20 token mints by specifying the input as follows:

Input FilterValueDescription
operatoruser's 0x address, ENS, cb.id, Lens, or FarcasterExecutor of the transaction.
from0x0000000000000000000000000000000000000000Sender in the ERC20 token transfers.
touser's 0x address, ENS, cb.id, Lens, or FarcasterReceiver in the ERC20 token transfers.

Table Of Contents

In this guide you will learn how to use Airstack to get ERC20 token 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:

{% tabs %} {% tab title="npm" %} React

npm install @airstack/airstack-react

Node

npm install @airstack/node

{% endtab %}

{% tab title="yarn" %} React

yarn add @airstack/airstack-react

Node

yarn add @airstack/node

{% endtab %}

{% tab title="pnpm" %} React

pnpm install @airstack/airstack-react

Node

pnpm install @airstack/node

{% endtab %}

{% tab title="pip" %}

pip install airstack

{% endtab %} {% endtabs %}

Then, add the following snippets to your code:

{% tabs %} {% tab title="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>;
  }
};

{% endtab %}

{% tab title="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);

{% endtab %}

{% tab title="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())

{% endtab %} {% endtabs %}

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 ERC20 Token Mints By A User

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

Try Demo

{% embed url="https://app.airstack.xyz/query/lpLjUCQZmI" %} Show me all ERC20 tokens minted by ipeciura.eth {% endembed %}

Code

{% tabs %} {% tab title="Query" %}

query MyQuery {
  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 ERC20 tokens
        tokenType: {_eq: ERC20},
      },
      blockchain: ethereum,
      order: {blockTimestamp: DESC}
    }
  ) {
    TokenTransfer {
      blockchain
      formattedAmount
      tokenAddress
      tokenNft {
        metaData {
          name
        }
        contentValue {
          image {
            medium
          }
        }
      }
      tokenType
    }
  }
}

{% endtab %}

{% tab title="Response" %}

{
  "data": {
    "Ethereum": {
      "TokenTransfer": null // No ERC20 token minted on Ethereum
    },
    "Polygon": {
      "TokenTransfer": [
        {
          "blockchain": "polygon",
          "formattedAmount": 0.01697896348647009,
          "tokenAddress": "0xadbf1854e5883eb8aa7baf50705338739e558e5b",
          "tokenNft": null,
          "tokenType": "ERC20"
        },
        // Other ERC20 tokens minted by ipeciura.eth on Polygon
      ]
    },
    "Base": {
      "TokenTransfer": null // No ERC20 token minted on Base
    }
  }
}

{% endtab %} {% endtabs %}

Developer Support

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

More Resources