Get All Member Fan Tokens Owned By Certain User
In this tutorial, you will learn how to get all the member-type fan tokens owned by a certain user in the Moxie protocol by calling the Moxie Protocol Subgraph API.
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 the member fan tokens owned by a certain user. To get user's vesting contract addresses, click here.
Pre-requisites
Install dependenciesgraphql
and graphql-request
to your project :- npm
- yarn
- pnpm
- bun
npm install graphql graphql-request
yarn add graphql graphql-request
pnpm add graphql graphql-request
bun install graphql graphql graphql-request
Step 1: Add The API Query To Your Code
To get all the member-type fan tokens owned by a certain user in the Moxie protocol, you can use the following query:
- Query
- Variable
- Response
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
}
}
}
}
{
"userAddresses": [
"0x075b108fc0a6426f9dec9a5c18e87eb577d1346a"
],
// Check if the symbol starts with "fid:" to include only member-type fan tokens
"symbol_starts_with": "fid:"
}
{
"data": {
"users": [
{
"portfolio": [
{
"balance": "13020342330530893",
"subjectToken": {
"address": "0x9b4b438398c11c7dafdcc0cd2ef5240b58b709ba",
"name": "horsefacts.eth",
"symbol": "fid:3621",
"decimals": "18"
}
}
]
}
]
}
}
graphql-request
library:- TypeScript
- JavaScript
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": [
"0x075b108fc0a6426f9dec9a5c18e87eb577d1346a"
],
// Check if the symbol starts with "fid:" to include only member-type fan tokens
"symbol_starts_with": "fid:"
}
try {
const data = await graphQLClient.request(query, variable);
console.log(data);
} catch (e) {
throw new Error(e);
}
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($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": [
"0x075b108fc0a6426f9dec9a5c18e87eb577d1346a"
],
// Check if the symbol starts with "fid:" to include only member-type fan tokens
"symbol_starts_with": "fid:"
}
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:
- TypeScript
- JavaScript
ts-node index.ts
node index.js
If it runs successfully, you should see the data returned in the terminal:
{
"data": {
"users": [
{
"portfolio": [
{
"balance": "13020342330530893",
"subjectToken": {
"address": "0x9b4b438398c11c7dafdcc0cd2ef5240b58b709ba",
"name": "horsefacts.eth",
"symbol": "fid:3621",
"decimals": "18"
}
}
]
}
]
}
}
Congrats! 🥳🎉 You've just fetched all the member-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.