🔎Search POAPs

Learn how to use Airstack RegEx Filter to search for POAPs that fulfill the given criteria

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

Using the _regex operator in PoapEvents API, now you can search for POAPs easily with any standard regex patterns and build your very own POAP search engine into your application.

Table Of Contents

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

• Search All POAPs Starting With Given Words

• Search All POAPs In Case Insensitive Manner

• Search All POAPs That Does Not Contain Given Words

Keep in mind that you can combine the regex from each of these use cases into your query to build more complex search feature that suits your app use cases.

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)

Best Practices

Here are some best practices to keep in mind to use the _regex filter optimally:

1. Case Insensitivity

If case insensitivity is not necessary, avoid using the case-insensitive flag (i) in your regex, as it may slow down the query.

If you need case-insensitive search, it is best practice that you use (?i)devcon pattern instead of other patterns (e.g. [Dd]evcon) for most optimal response time.

2. Avoid Wildcard

Structure your regex pattern as specific as possible and avoid using wildcard (.*) in your regex if possible, as it can lead to more extensive scans and longer response times.

Search All POAPs Starting With Given Words

You can search all POAP events that start with given word by using the PoapEvents API:

Try Demo

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

Search all POAPs that starts with ETHGlobal

Code

Query

query MyQuery {
  PoapEvents(
    input: {
      filter: {
        eventName: {_regex: "^ETHGlobal"} # ^ to indicate starts with in regex
      },
      blockchain: ALL
    }
  ) {
    PoapEvent {
      eventName
      eventId
    }
  }
}

Response

{
  "data": {
    "PoapEvents": {
      "PoapEvent": [
        {
          "eventName": "ETHGlobal HackMoney2021 Staked Hacker",
          "eventId": "5470"
        },
        {
          "eventName": "ETHGlobal Paris 2023 Speaker",
          "eventId": "146356"
        },
        {
          "eventName": "ETHGlobal Paris 2023 Volunteer",
          "eventId": "146354"
        }
        // Other POAP events that starts with "ETHGlobal"
      ]
    }
  }
}

Search All POAPs In Case Insensitive Manner

You can search all POAP events that contain a given word in a case-insensitive manner by using the PoapEvents API:

When doing case-insensitive search, it is best practice that you use (?i)devcon pattern instead of others (e.g. [Dd]evcon).

Try Demo

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

Search all POAPs that contain devcon (case insensitive)

Code

Query

query MyQuery {
  PoapEvents(
    input: {
      filter: {
        # Regex to search all POAP containing 'devcon' in case insensitive manner
        eventName: {_regex: "(?i)devcon"}
      },
      blockchain: ALL
    }
  ) {
    PoapEvent {
      eventName
      eventId
    }
  }
}

Response

{
  "data": {
    "PoapEvents": {
      "PoapEvent": [
        {
          "eventName": "I met sandramaria.eth at Devcon 6",
          "eventId": "73929"
        },
        {
          "eventName": "Devcon VI in Bogotá",
          "eventId": "60695"
        },
        {
          "eventName": "I met 0xmono.eth at Devcon 6",
          "eventId": "75713"
        }
        // Other POAP events that contain devcon (case insensitive)
      ]
    }
  }
}

Search All POAPs That Does Not Contain Given Words

You can search all POAP events that DOES NOT contain a given word in by using the PoapEvents API:

Try Demo

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

Search all POAPs that does not contain "Devconnect"

Code

Query

query MyQuery {
  PoapEvents(
    input: {
      filter: {
        # This regex excludes all POAPs that contain "Devconnect" in their name
        eventName: {_regex: "^(?!Devconnect).*"}
      },
      blockchain: ALL
    }
  ) {
    PoapEvent {
      eventName
      eventId
    }
  }
}

Response

{
  "data": {
    "PoapEvents": {
      "PoapEvent": [
        {
          "eventName": "ByDyorSide Beta Tester",
          "eventId": "149953"
        },
        {
          "eventName": "CH90 MOD Sharing  24th May 2022",
          "eventId": "47455"
        },
        {
          "eventName": "Reunión BIAS / IAS Comms",
          "eventId": "21524"
        }
        // Other POAP events that does not contain "Devconnect"
      ]
    }
  }
}

Developer Support

If you have any questions or need help regarding search POAP events using RegEx, please join our Airstack's Telegram group.

More Resources

• POAP Balances

• POAP Holders

• POAP Events

• POAP Token Gating

• PoapEvents API Reference