🤝Tokens In Common

Learn how to fetch ERC20, NFTs, or POAPs in common from multiple Farcaster users.

🤝 Tokens In Common

Airstack provides easy-to-use APIs for enriching Farcaster applications and for integrating onchain and offchain data with Farcaster.

Table Of Contents

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

• ERC20 Tokens In Common Owned By Farcaster User(s)

• NFTs In Common Owned By Farcaster User(s)

• POAPs Tokens In Common Owned By Farcaster User(s)

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.

ERC20 Tokens In Common Owned By Farcaster User(s)

You can fetch common ERC20 tokens of multiple Farcaster user(s):

Try Demo

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

Show common ERC20 tokens of two Farcaster users

Code

Query

query MyQuery {
  TokenBalances(
    input: {
      filter: {
        owner: { _eq: "fc_fname:betashop.eth" }
        tokenType: { _eq: ERC20 }
      }
      blockchain: base
    }
  ) {
    TokenBalance {
      token {
        tokenBalances(
          input: {
            filter: {
              owner: { _eq: "fc_fname:sarvesh" }
              tokenType: { _eq: ERC20 }
            }
          }
        ) {
          id
          token {
            address
            symbol
            name
          }
        }
      }
    }
  }
}

Response

{
  "data": {
    "TokenBalances": {
      "TokenBalance": [
        {
          "token": {
            "tokenBalances": [
              {
                "id": "af2c9253761bbc7a547caa471e99a9641b1f5029d01a2374bd3c872017f61d33",
                "token": {
                  "address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
                  "symbol": "DEGEN",
                  "name": "Degen"
                }
              }
            ]
          }
        },
        {
          "token": {
            "tokenBalances": [] // Owned by betashop.eth, but not owned by sarvesh
          }
        }
      ]
    }
  }
}

NFTs In Common Owned By Farcaster User(s)

You can fetch common NFTs of multiple Farcaster user(s):

Try Demo

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

Show common NFTs of two Farcaster users

Code

Query

query MyQuery {
  TokenBalances(
    input: {
      filter: {
        owner: { _eq: "fc_fname:betashop.eth" }
        tokenType: { _in: [ERC721, ERC1155] }
      }
      blockchain: base
    }
  ) {
    TokenBalance {
      token {
        tokenBalances(
          input: {
            filter: {
              owner: { _eq: "fc_fname:sarvesh" }
              tokenType: { _in: [ERC721, ERC1155] }
            }
          }
        ) {
          id
          token {
            address
            symbol
            name
          }
        }
      }
    }
  }
}

Response

{
  "data": {
    "TokenBalances": {
      "TokenBalance": [
        {
          "token": {
            "tokenBalances": [
              {
                "id": "09adff7901e6b3ed411a037abf0be67365cb2dabe24e48921768d32abf64203a",
                "token": {
                  "address": "0x4c17ff12d9a925a0dec822a8cbf06f46c626855c",
                  "symbol": "FC-HZN",
                  "name": "Farcaster Horizon"
                }
              }
            ]
          }
        },
        {
          "token": {
            "tokenBalances": [] // Owned by betashop.eth, but not owned by sarvesh
          }
        }
      ]
    }
  }
}

POAPs In Common Owned By Farcaster User(s)

You can fetch common POAPs of multiple Farcaster user(s):

Try Demo

https://app.airstack.xyz/query/7RtCNBtLUA

Show common POAPs of two Farcaster users

Code

Query

query MyQuery {
  Poaps(
    input: {
      filter: { owner: { _eq: "fc_fname:betashop.eth" } }
      blockchain: ALL
      order: { createdAtBlockNumber: DESC }
    }
  ) {
    Poap {
      poapEvent {
        poaps(input: { filter: { owner: { _eq: "fc_fname:ipeciura" } } }) {
          poapEvent {
            eventName
            eventId
            endDate
            country
            city
          }
        }
      }
    }
  }
}

Response

{
  "data": {
    "Poaps": {
      "Poap": [
        {
          "poapEvent": {
            "poaps": [
              {
                "poapEvent": {
                  "eventName": "Airstack Amazing Race Dubai",
                  "eventId": "145995",
                  "endDate": "2023-07-30T00:00:00Z",
                  "country": "UAE",
                  "city": "Dubai"
                }
              }
            ]
          }
        },
        {
          "poapEvent": {
            "poaps": [] // owned by betsahop.eth, but not ipeciura
          }
        }
      ]
    }
  }
}

Developer Support

If you have any questions or need help regarding fetching common ERC20 tokens, NFTs, or POAPs of multiple Farcaster users, please join our Airstack's Telegram group.

More Resources

• Tokens In Common Guides

• Nested Queries

• POAPs API Reference

• TokenBalances API Reference