Get All Channel Creator Coins Owned By Certain User
In this tutorial, you will learn how to get all the channel-type Creator Coins 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 Creator Coins on the Moxie protocol.
Therefore, it is important that you include the user's vesting addresses in the query to get all channel Creator Coins 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 channel-type Creator Coins 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": [
"0x062c86ca636061e49193307d8462017c51b4834b"
],
// Check if the symbol starts with "cid:" to include only channel-type Creator Coins
"symbol_starts_with": "cid:"
}
{
"data": {
"users": [
{
"portfolio": [
{
"balance": "13020342330530893",
"subjectToken": {
"address": "0x30bf797423ae6691c244daba96a96019816cb624",
"name": "/founders",
"symbol": "cid:founders",
"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": [
"0x062c86ca636061e49193307d8462017c51b4834b"
],
// Check if the symbol starts with "cid:" to include only channel-type Creator Coins
"symbol_starts_with": "cid:"
}
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": [
"0x062c86ca636061e49193307d8462017c51b4834b"
],
// Check if the symbol starts with "cid:" to include only channel-type Creator Coins
"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:
- 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": "0x30bf797423ae6691c244daba96a96019816cb624",
"name": "/founders",
"symbol": "cid:founders",
"decimals": "18"
}
}
]
}
]
}
}
Congrats! 🥳🎉 You've just fetched all the channel-type Creator Coins 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 Moxie Official Warpcast channel and ask your questions there.
Our team is always ready to help you with any questions you may have.