🎖️Farcaster Power Badge

Learn how to fetch Farcaster power badge data and its various use cases to check if a user is a power user on Farcaster.

Table Of Contents

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

• Check If Farcaster User(s) Have A Power Badge

• Get All Farcaster Followers That Also Have A Power Badge

• Get All Farcaster Followings That Also Have A Power Badge

• Get All Farcaster Channel Participants That Also Have A Power Badge

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.

Check If Farcaster User(s) Have A Power Badge

You can check if Farcaster user(s) have a power badge by using the Socials API:

Try Demo

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

Check if Farcaster user(s) have power badge

Code

Query

query MyQuery {
  Socials(
    input: {
      filter: {
        profileName: {
          _in: ["betashop.eth"] # provide FC user profile name(s)
        },
        dappName: {_eq: farcaster}
      },
      blockchain: ethereum
    }
  ) {
    Social {
      isFarcasterPowerUser
      profileName
    }
  }
}

Response

{
  "data": {
    "Socials": {
      "Social": [
        {
          "isFarcasterPowerUser": true, // this user has power badge
          "profileName": "betashop.eth"
        }
      ]
    }
  }
}

Get All Farcaster Followers That Also Have A Power Badge

You can fetch all Farcaster followers of a Farcaster user and check if they have a power badge by using the SocialFollowers API:

Try Demo

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

Show me all the followers of betashop.eth that also have power badge

Code

Query

query MyQuery {
  SocialFollowers(
    input: {
      filter: {
        identity: {_eq: "betashop.eth"},
        dappName: {_eq: farcaster}
      },
      blockchain: ALL,
      order: {followerSince: DESC}
    }
  ) {
    Follower {
      followerProfileId
      followerAddress {
        addresses
        socials {
          profileName
          isFarcasterPowerUser
        }
      }
    }
  }
}

Response

{
  "data": {
    "SocialFollowers": {
      "Follower": [
        {
          "followerProfileId": "411529",
          "followerAddress": {
            "addresses": [
              "0xbc0b2add51010730563159a84d613eddc7d21e4c"
            ],
            "socials": [
              {
                "profileName": "defi-degen",
                "isFarcasterPowerUser": false // This user have no power badge
              }
            ]
          }
        },
        // other followers
      ]
    }
  }
}

Get All Farcaster Followings That Also Have A Power Badge

You can fetch all Farcaster followings of a Farcaster user and check if they have a power badge by using the SocialFollowings API:

Try Demo

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

Show me all the followings of betashop.eth that also have power badge

Code

Query

query MyQuery {
  SocialFollowings(
    input: {
      filter: {
        identity: {_eq: "betashop.eth"},
        dappName: {_eq: farcaster}
      },
      blockchain: ALL,
      order: {followingSince: DESC}
    }
  ) {
    Following {
      followingProfileId
      followingAddress {
        addresses
        socials {
          profileName
          isFarcasterPowerUser
        }
      }
    }
  }
}

Response

{
  "data": {
    "SocialFollowings": {
      "Following": [
        {
          "followingProfileId": "378310",
          "followingAddress": {
            "addresses": [
              "0x765f844900da37dbc6f3c82e0ccdea5e01a303dc",
              "2TkvxGAuEXWFeYB7qP2MY2MSjhmcsnsCotyxu7fQyKH3"
            ],
            "socials": [
              {
                "profileName": "0xbuildr",
                "isFarcasterPowerUser": false // This user have no power badge
              }
            ]
          }
        },
      ]
    }
  }
}

Get All Farcaster Channel Participants That Also Have A Power Badge

You can fetch all the channel participants of a Farcaster channel and check if they have a power badge by using the FarcasterChannelParticipants API:

Try Demo

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

Show me all participants of /airstack channel that also have power badge

Code

Query

query MyQuery {
  FarcasterChannelParticipants(
    input: {
      filter: {
        channelId: {_eq: "airstack"}
      },
      blockchain: ALL
    }
  ) {
    FarcasterChannelParticipant {
      participantId
      participant {
        profileName
        isFarcasterPowerUser
      }
    }
  }
}

Response

{
  "data": {
    "FarcasterChannelParticipants": {
      "FarcasterChannelParticipant": [
        {
          "participantId": "247143",
          "participant": {
            "profileName": "kylepatrick",
            "isFarcasterPowerUser": true // This user have power badge
          }
        },
        {
          "participantId": "5701",
          "participant": {
            "profileName": "chriscocreated",
            "isFarcasterPowerUser": false // This user have no power badge
          }
        },
      ]
    }
  }
}

Developer Support

If you have any questions or need help regarding fetching Farcaster power badge data, please join our Airstack's Telegram group.

More Resources

• Socials API Reference

• SocialFollowers API Reference

• SocialFollowings API Reference

• FarcasterChannelParticipants API Reference