Get Trending Fan Tokens

In this tutorial, you will learn how to get all-time trending fan tokens sorted by the number of fan token buy volume by calling the Moxie Protocol Subgraph API.

Pre-requisites

Install dependencies graphql and graphql-request to your project :

npm

npm install graphql graphql-request 

yarn

yarn add graphql graphql-request 

pnpm

pnpm add graphql graphql-request 

bun

bun install graphql graphql graphql-request 

Step 1: Add The API Query To Your Code

To get all-time trending fan tokens sorted by the number of fan token buy volume, you can use the following query:

Query

query MyQuery {
  subjectTokens(orderBy: buySideVolume, orderDirection: desc) {
    buySideVolume
    currentPriceInMoxie
    currentPriceInWeiInMoxie
    address: id
    name
    symbol
    decimals
    createdAtBlockInfo {
      id
    }
  }
}

Response

{
  "data": {
    "subjectTokens": [
      {
        "buySideVolume": "563062459174562961980060",
        "currentPriceInMoxie": "25.0558059346061332666",
        "currentPriceInWeiInMoxie": "25055805934606133266.6",
        "address": "0xb4d00a5bfea5ec43c062f7eb046b923240cefa76",
        "name": "nickcherry",
        "symbol": "fid:145",
        "decimals": "18",
        "createdAtBlockInfo": {
          "id": "12954031"
        }
      }
    ]
  }
}

With this GraphQL query, you can add it to your source code and call the API with the graphql-request library:

TypeScript

index.ts

import { gql, GraphQLClient } from "graphql-request";


const graphQLClient = new GraphQLClient(
  "https://api.studio.thegraph.com/query/23537/moxie_protocol_stats_mainnet/version/latest"
);

const query = gql`
query MyQuery {
  subjectTokens(orderBy: buySideVolume, orderDirection: desc) {
    buySideVolume
    currentPriceInMoxie
    currentPriceInWeiInMoxie
    address: id
    name
    symbol
    decimals
    createdAtBlockInfo {
      id
    }
  }
}
`;



try {
  const data = await graphQLClient.request(query);
  console.log(data);
} catch (e) {
  throw new Error(e);
}

JavaScript

index.js

const { gql, GraphQLClient } = require("graphql-request");


const graphQLClient = new GraphQLClient(
  "https://api.studio.thegraph.com/query/23537/moxie_protocol_stats_mainnet/version/latest"
);

const query = gql`
query MyQuery {
  subjectTokens(orderBy: buySideVolume, orderDirection: desc) {
    buySideVolume
    currentPriceInMoxie
    currentPriceInWeiInMoxie
    address: id
    name
    symbol
    decimals
    createdAtBlockInfo {
      id
    }
  }
}
`;



try {
  const data = await graphQLClient.request(query);
  console.log(data);
} catch (e) {
  throw new Error(e);
}

Step 2: Execute Your Code

Once you have your code ready, you can execute it by running the following command:

TypeScript

ts-node index.ts

JavaScript

node index.js

If it runs successfully, you should see the data returned in the terminal:

{
  "data": {
    "subjectTokens": [
      {
        "buySideVolume": "563062459174562961980060",
        "currentPriceInMoxie": "25.0558059346061332666",
        "currentPriceInWeiInMoxie": "25055805934606133266.6",
        "address": "0xb4d00a5bfea5ec43c062f7eb046b923240cefa76",
        "name": "nickcherry",
        "symbol": "fid:145",
        "decimals": "18",
        "createdAtBlockInfo": {
          "id": "12954031"
        }
      }
    ]
  }
}

Congrats! 🥳🎉 You've just fetched all-time trending fan tokens on the Moxie protocol!

Developer Support

If you have any questions or need help with other use cases, feel free to join the /airstack Warpcast channel and ask your questions there.

Our team is always ready to help you with any questions you may have.