🦸Moxie Heroes

Learn how to fetch all the Farcaster users that are currently designated as Moxie Heroes and the variable boost they received on their FarScore.

Moxie Heroes are designated each week based on their prior week's quality and diversity of engagement. Every week Moxie Heroes get a variable boost to their FarScore based on their existing score.

Heroes can keep these powers for themselves or transfer to another user. Heroes' superpowers last for a full week. A new set of heroes is launched each week based on previous week diversity and quality of engagement. It will be rotated so no one is hero in consecutive weeks.

Table Of Contents

• Get All The Current Moxie Heroes

• Get The Moxie Hero Multiplier Of A User

Pre-requisites

• An Airstack API key. To access this, you'll need to hold at least 1 /airstack Channel Fan Token.

• 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 All The Current Moxie Heroes

You can get the Farcaster users that are currently Moxie Heroes by using the FarScores API and configure the API by setting the heroBoost filter to greater than 0 to only fetch those with Hero boost:

Try Demo

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

Show me all the current Moxie Heroes

Code

Query

query MyQuery {
  FarScores(
    input: {
      filter: {
        # Only get user that have hero boost
        heroBoost: {_gt: 0}
      },
      limit: 200
    }
  ) {
    FarScore {
      farScore
      heroBoost
      social {
        profileName
        fid: userId
      }
    }
  }
}

Response

{
  "data": {
    "FarScores": {
      "FarScore": [
        {
          "farScore": 87.00799974768002,
          "heroBoost": 86.888154018,
          "social": {
            "profileName": "banthafodderdan",
            "fid": "379581"
          }
        },
        {
          "farScore": 94.05552537371149,
          "heroBoost": 70.5416440302836,
          "social": {
            "profileName": "aaronv.eth",
            "fid": "354795"
          }
        },
        // Other Moxie Heroes
      ]
    }
  }
}

Get The Moxie Hero Multiplier Of A User

You can get the Moxie Hero Multiplier by using the Socials API and inputting the user's FID in userId input and first getting the Moxie Hero Boost:

Try Demo

https://app.airstack.xyz/query/8y1QynQiRM

Show me the Moxie Hero Boost of FID 488178

Code

Query

query MyQuery {
  Socials(
    input: {
      filter: {
        dappName: {_eq: farcaster},
        userId: {_eq: "488178"}
      },
      blockchain: ethereum
    }
  ) {
    Social {
      userId
      profileName
      farcasterScore {
        farBoost
        farRank
        farScore
        farScoreRaw
        heroBoost
        liquidityBoost
        powerBoost
        tvl
        tvlBoost
      }
    }
  }
}

Response

{
  "data": {
    "Socials": {
      "Social": [
        {
          "userId": "488178",
          "profileName": "nikomfer.eth",
          "farcasterScore": {
            "farBoost": 290.87599810419005,
            "farRank": 3,
            "farScore": 582.6746181312901,
            "farScoreRaw": "58267461813129.003488414568103642",
            // This is the Moxie Hero Boost of the user
            "heroBoost": 291.337309065645,
            "liquidityBoost": 0,
            "powerBoost": 288.56944329691504,
            "tvl": "828868042240291844385275",
            "tvlBoost": 2.306554807275
          }
        },
        // Other Farcaster users
      ]
    }
  }
}

Once you get the Moxie Hero boost of the user, you can use the formula here to get the multiplier.

Developer Support

If you have any questions or need help regarding fetching FarScore & FarBoosts data, please join our Airstack's Telegram group.

More Resources

• FarScores, FarBoost, and Cast Scores

• Socials API References

• FarScores API References