⚖️POAP Balances

Learn how to fetch POAPs held by various web3 identities, such as 0x addresses, ENS domains, Lens profiles, and Farcasters. You will also learn how to fetch commonly held POAPs between multiple users.

Airstack provides easy-to-use APIs for enriching POAP applications and for integrating POAP on-chain data indexed directly from both Ethereum and Gnosis.

Table Of Contents

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

• Get POAPs Held By 0x Address(es)

• Get POAPs Held By ENS Domain(s)

• Get POAPs Held By Lens Profile(s)

• Get POAPs Held By Farcaster User(s)

• Get POAPs In Common Held By Multiple Users

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 POAPs Held By 0x Address(es)

You can fetch all the POAPs held by by providing it as an input to the owner filter input:

Try Demo

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

Show me all poaps hold by 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

Code

Query

query MyQuery {
  Poaps(
    input: {
      filter: { owner: { _in: ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"] } }
      blockchain: ALL
    }
  ) {
    Poap {
      eventId
      tokenId
      poapEvent {
        eventName
        description
      }
    }
  }
}

Response

{
  "data": {
    "Poaps": {
      "Poap": [
        {
          "eventId": "80393",
          "tokenId": "5860961",
          "poapEvent": {
            "eventName": "You met Cryptocomical at Lisbon 2022",
            "description": "You met Cryptocomical at Lisbon 2022\r\n\r\nConheceu a Cryptocomical em Lisboa 2022"
          }
        },
        {
          "eventId": "79011",
          "tokenId": "5819739",
          "poapEvent": {
            "eventName": "ITU Blockchain - Devcon Satellite",
            "description": "This POAP is a memory of İTÜ Blockchain’s Devcon Satellite event."
          }
        },
        {
          "eventId": "15678",
          "tokenId": "3055722",
          "poapEvent": {
            "eventName": "Assets9 community members",
            "description": "Poap distributed for Assets9 community members"
          }
        }
      ]
    }
  }
}

Get POAPs Held By ENS Domain(s)

You can fetch all the POAPs held by ENS Domain(s) by providing it as an input to the owner filter input:

Try Demo

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

Show me all POAPs hold by vitalik.eth

Code

Query

query MyQuery {
  Poaps(
    input: { filter: { owner: { _in: ["vitalik.eth"] } }, blockchain: ALL }
  ) {
    Poap {
      eventId
      tokenId
      poapEvent {
        eventName
        description
      }
    }
  }
}

Response

{
  "data": {
    "Poaps": {
      "Poap": [
        {
          "eventId": "80393",
          "tokenId": "5860961",
          "poapEvent": {
            "eventName": "You met Cryptocomical at Lisbon 2022",
            "description": "You met Cryptocomical at Lisbon 2022\r\n\r\nConheceu a Cryptocomical em Lisboa 2022"
          }
        },
        {
          "eventId": "79011",
          "tokenId": "5819739",
          "poapEvent": {
            "eventName": "ITU Blockchain - Devcon Satellite",
            "description": "This POAP is a memory of İTÜ Blockchain’s Devcon Satellite event."
          }
        },
        {
          "eventId": "15678",
          "tokenId": "3055722",
          "poapEvent": {
            "eventName": "Assets9 community members",
            "description": "Poap distributed for Assets9 community members"
          }
        }
      ]
    }
  }
}

Get POAPs Held By Lens Profile(s)

You can fetch all the POAPs held by Lens profile(s) by providing either the Lens profile name or ID as an input to the owner filter input:

Try Demo

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

Show me all POAPs hold by lens/@vitalik

Code

Query

query MyQuery {
  Poaps(
    input: { filter: { owner: { _in: ["lens/@vitalik"] } }, blockchain: ALL }
  ) {
    Poap {
      eventId
      tokenId
      poapEvent {
        eventName
        description
      }
    }
  }
}

Response

{
  "data": {
    "Poaps": {
      "Poap": [
        {
          "eventId": "80393",
          "tokenId": "5860961",
          "poapEvent": {
            "eventName": "You met Cryptocomical at Lisbon 2022",
            "description": "You met Cryptocomical at Lisbon 2022\r\n\r\nConheceu a Cryptocomical em Lisboa 2022"
          }
        },
        {
          "eventId": "79011",
          "tokenId": "5819739",
          "poapEvent": {
            "eventName": "ITU Blockchain - Devcon Satellite",
            "description": "This POAP is a memory of İTÜ Blockchain’s Devcon Satellite event."
          }
        },
        {
          "eventId": "15678",
          "tokenId": "3055722",
          "poapEvent": {
            "eventName": "Assets9 community members",
            "description": "Poap distributed for Assets9 community members"
          }
        }
      ]
    }
  }
}

Get POAPs Held By Farcaster User(s)

You can fetch all the POAPs held by Farcaster(s) by providing the of fid as an input to the owner filter input:

Try Demo

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

Show me all poaps hold by Farcaster user fname vitalik.eth and fid 602

Code

Query

query MyQuery {
  Poaps(
    input: {
      filter: { owner: { _in: ["fc_fname:vitalik.eth", "fc_fid:602"] } }
      blockchain: ALL
      limit: 200
    }
  ) {
    Poap {
      eventId
      tokenId
      poapEvent {
        eventName
        description
      }
    }
  }
}

Response

{
  "data": {
    "Poaps": {
      "Poap": [
        {
          "eventId": "80393",
          "tokenId": "5860961",
          "poapEvent": {
            "eventName": "You met Cryptocomical at Lisbon 2022",
            "description": "You met Cryptocomical at Lisbon 2022\r\n\r\nConheceu a Cryptocomical em Lisboa 2022"
          }
        },
        {
          "eventId": "79011",
          "tokenId": "5819739",
          "poapEvent": {
            "eventName": "ITU Blockchain - Devcon Satellite",
            "description": "This POAP is a memory of İTÜ Blockchain’s Devcon Satellite event."
          }
        },
        {
          "eventId": "15678",
          "tokenId": "3055722",
          "poapEvent": {
            "eventName": "Assets9 community members",
            "description": "Poap distributed for Assets9 community members"
          }
        }
      ]
    }
  }
}

Get POAPs In Common Held By Multiple Users

You can fetch all the POAPs commonly held by multiple users, in the following example take 2 users betashop.eth and ipeciura.eth:

Try Demo

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

Show me common POAPs hold by both betashop.eth and ipeciura.eth

Code

Query

query CommonPOAPs {
  Poaps(
    input: {
      filter: { owner: { _eq: "betashop.eth" } }
      blockchain: ALL
      limit: 200
    }
  ) {
    Poap {
      poapEvent {
        poaps(input: { filter: { owner: { _eq: "ipeciura.eth" } } }) {
          poapEvent {
            eventName
            eventId
            endDate
            country
            city
          }
        }
      }
    }
    pageInfo {
      nextCursor
      prevCursor
    }
  }
}

Response

{
  "data": {
    "Poaps": {
      "Poap": [
        {
          "poapEvent": {
            "poaps": [
              {
                "poapEvent": { // POAP owned by both betashop.eth and ipeciura.eth
                  "eventName": "You've met Lucas in Summer 23",
                  "eventId": "141662",
                  "endDate": "2023-09-21T00:00:00Z",
                  "country": "Worldwide",
                  "city": "Summer 23"
                }
              }
            ]
          }
        },
        {
          "poapEvent": {
            "poaps": [] // POAP hold by betashop.eth, but not hold by ipeciura.eth
          }
        }
      ]
    }
  }
}

Developer Support

If you have any questions or need help regarding fetching POAP balances, please join our Airstack's Telegram group.

More Resources

• Poaps API Reference

• Combinations

  • Multiple POAPs

  • Combinations of ERC20s, NFTs, and POAPs

• Tokens In Common

  • POAPs

• Search POAPs