Skip to main content

Get All Channel Fan Tokens Owned By Certain User

In this tutorial, you will learn how to get all the channel-type fan tokens owned by a certain user in the Moxie protocol by calling the Moxie Protocol Subgraph API.

Include User's Vesting Addresses

Moxie protocol users have Moxie token currently vesting in their vesting contract. A huge portion of them use these to bid on auctions and buy/sell fan tokens on the Moxie protocol.

Therefore, it is important that you include the user's vesting addresses in the query to get all channel fan tokens owned by a certain user. To get user's vesting contract addresses, click here.

Pre-requisites

Install dependencies graphql and graphql-request to your project :
npm install graphql graphql-request

Step 1: Add The API Query To Your Code​

To get all the channel-type fan tokens owned by a certain user in the Moxie protocol, you can use the following query:

query MyQuery($userAddresses: [ID!], $symbol_starts_with: String) {
  users(where: { id_in: $userAddresses }) {
    portfolio(where: {subjectToken_: {symbol_starts_with: $symbol_starts_with}}) {
      balance
      subjectToken {
        address: id
        name
        symbol
        decimals
      }
    }
  }
}
With this GraphQL query, you can add it to your source code and call the API with the graphql-request library:
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($userAddresses: [ID!], $symbol_starts_with: String) {
  users(where: { id_in: $userAddresses }) {
    portfolio(where: {subjectToken_: {symbol_starts_with: $symbol_starts_with}}) {
      balance
      subjectToken {
        address: id
        name
        symbol
        decimals
      }
    }
  }
}
`;

const variable = {
  "userAddresses": [
    "0x062c86ca636061e49193307d8462017c51b4834b"
  ],
  // Check if the symbol starts with "cid:" to include only channel-type fan tokens
  "symbol_starts_with": "cid:"
}


try {
  const data = await graphQLClient.request(query, variable);
  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:

ts-node index.ts

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

{
  "data": {
    "users": [
      {
        "portfolio": [
          {
            "balance": "13020342330530893",
            "subjectToken": {
              "address": "0x30bf797423ae6691c244daba96a96019816cb624",
              "name": "/founders",
              "symbol": "cid:founders",
              "decimals": "18"
            }
          }
        ]
      }
    ]
  }
}

Congrats! 🥳🎉 You've just fetched all the channel-type fan tokens owned by a certain user in 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.