💸Token Transfers

Learn how to use Airstack to fetch all ERC20/721/1155 token transfers data, from or to user(s), across Ethereum, Base, Degen Chain, and other Airstack supported chains.

Airstack provides a TokenTransfers API for you to fetch all ERC20/721/1155 token transfer data from either a user or multiple users on Ethereum, Base, Degen Chain, and other Airstack-supported chains.

Table Of Contents

In this guide you will learn how to use Airstack to:

• Get Token Transfers Sent From A User

• Get Token Transfers Received By A User

• Get The Most Recent Token Transfers Sent From A User

• Get The Most Recent Token Transfers Received 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.

Get Token Transfers Sent From A User

You can fetch all token transfers sent from a given user, e.g. betashop.eth, on Ethereum, Base, Degen Chain, and other Airstack-supported chains by using the TokenTransfers API:

For fetching token transfers data from multiple chains, check out Cross-Chain Queries.

Try Demo

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

Show me token transfers sent from betashop.eth on Ethereum

Code

Query

query GetTokenTransfers {
  TokenTransfers(
    input: {
      filter: {
        # Only get token transfers from betashop.eth
        from: {_eq: "betashop.eth"},
        # Remove all minting/burning + self-transfer
        _nor: {
          from: {_in: ["0x0000000000000000000000000000000000000000", "0x000000000000000000000000000000000000dEaD"]},
          to: {_in: ["0x0000000000000000000000000000000000000000", "0x000000000000000000000000000000000000dEaD", "betashop.eth"]}
        }
      },
      blockchain: ethereum,
      limit: 50
    }
  ) {
    TokenTransfer {
      formattedAmount
      tokenType
      token {
        name
      }
    }
  }
}

Response

{
  "data": {
    "TokenTransfers": {
      "TokenTransfer": [
        {
          "formattedAmount": 25,
          "tokenType": "ERC20",
          "token": {
            "name": "USD Coin"
          }
        },
        {
          "formattedAmount": 25,
          "tokenType": "ERC20",
          "token": {
            "name": "USD Coin"
          }
        }
        // Other token transfers from betashop.eth on Ethereum
      ]
    }
  }
}

Get Token Transfers Received By A User

You can fetch all token transfers received by a given user, e.g. betashop.eth, on Ethereum, Base, Degen Chain, and other Airstack-supported chains by using the TokenTransfers API:

For fetching token transfers data from multiple chains, check out Cross-Chain Queries.

Try Demo

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

Show me token transfers received by betashop.eth on Ethereum

Code

Query

query GetTokenTransfers {
  TokenTransfers(
    input: {
      filter: {
        # Only get token transfers to betashop.eth
        to: {_eq: "betashop.eth"},
        # Remove all minting/burning + self-transfer
        _nor: {
          from: {_in: ["0x0000000000000000000000000000000000000000", "0x000000000000000000000000000000000000dEaD", "betashop.eth"]},
          to: {_in: ["0x0000000000000000000000000000000000000000", "0x000000000000000000000000000000000000dEaD"]}
        }
      },
      blockchain: ethereum,
      limit: 50
    }
  ) {
    TokenTransfer {
      formattedAmount
      tokenType
      token {
        name
      }
    }
  }
}

Response

{
  "data": {
    "TokenTransfers": {
      "TokenTransfer": [
        {
          "formattedAmount": 1,
          "tokenType": "ERC721",
          "token": {
            "name": "ETHGlobal Pragma Lisbon"
          }
        },
        {
          "formattedAmount": 0.00005,
          "tokenType": "ERC20",
          "token": {
            "name": "Wrapped Ether"
          }
        }
        // Other Token Transfers received by betashop.eth on Ethereum
      ]
    }
  }
}

Get The Most Recent Token Transfers Sent From A User(s)

You can fetch all most recent token transfers sent from a given user, e.g. betashop.eth, across multiple chains, such as Ethereum, Base, Degen Chain, and other Airstack-supported chains, by using the TokenTransfers API:

For fetching most recent token transfers data from multiple chains, check out Cross-Chain Queries.

Try Demo

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

Show me the most recent token transfers sent from betashop.eth on Ethereum

Code

Query

query GetTokenTransfers {
  TokenTransfers(
    input: {
      filter: {
        # Only get token transfers from betashop.eth
        from: { _eq: "betashop.eth" }
      }
      blockchain: ethereum
      limit: 50
      order: { blockTimestamp: DESC } # Order transfers by blocktimestamp in descending order
    }
  ) {
    TokenTransfer {
      formattedAmount
      tokenType
      token {
        name
      }
    }
  }
}

Response

{
  "data": {
    "TokenTransfers": {
      "TokenTransfer": [
        {
          "formattedAmount": 125,
          "tokenType": "ERC20",
          "token": {
            "name": "USD Coin"
          }
        }
        // Other most recent token transfers sent by betashop.eth on Ethereum
      ]
    }
  }
}

Get The Most Recent Token Transfers Received By A User

You can fetch most recent token transfers received by a given user, e.g. betashop.eth, across multiple chains, such as Ethereum, Base, Degen Chain, and other Airstack-supported chains, by using the TokenTransfers API:

For fetching most recent token transfers data from multiple chains, check out Cross-Chain Queries.

Try Demo

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

Show me the most recent token transfers received by betashop.eth on Ethereum

Code

Query

query GetTokenTransfers {
  TokenTransfers(
    input: {
      filter: {
        # Only get token transfers to betashop.eth
        to: {_eq: "betashop.eth"},
      },
      blockchain: ethereum,
      limit: 50,
      order: { blockTimestamp: DESC } # Order transfers by blocktimestamp in descending order
    }
  ) {
    TokenTransfer {
      formattedAmount
      tokenType
      token {
        name
      }
    }
  }
}

Response

{
  "data": {
    "TokenTransfers": {
      "TokenTransfer": [
        {
          "formattedAmount": 1250,
          "tokenType": "ERC20",
          "token": {
            "name": "USD Coin"
          }
        }
        // Other most recent token transfers received by betashop.eth on Ethereum
      ]
    }
  }
}

Developer Support

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

More Resources

• TokenTransfers API Reference

• On-Chain Graph

• Token Mints Guides