Get Details Of Certain Creator Coin Auction
In this tutorial, you will learn how to get details of a certain Creator Coin auction by calling the Moxie Auction Subgraph API.
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 details of a certain Creator Coin auction, you can use the following query:
- Query
- Variable
- Response
query MyQuery($auctionId: BigInt!) {
auctionDetails(where: { auctionId: $auctionId }) {
auctionId
allowListManager
allowListSigner
auctionEndDate
currentBiddingAmount
currentClearingOrderBuyAmount
currentClearingOrderSellAmount
currentClearingPrice
currentVolume
interestScore
isAtomicClosureAllowed
isCleared
isPrivateAuction
minFundingThreshold
minimumBiddingAmountPerOrder
orderCancellationEndDate
startingTimeStamp
totalOrders
txHash
uniqueBidders
}
}
{
"auctionId": "1"
}
{
"data": {
"auctionDetails": [
{
"auctionId": "1",
"allowListManager": "0x7e6dd7ee0cd8a395b8ed5b21d8c40535cc1d4640",
"allowListSigner": "0x",
"auctionEndDate": "1720257100",
"currentBiddingAmount": "111000000000000000000",
"currentClearingOrderBuyAmount": "1000000000000000000000",
"currentClearingOrderSellAmount": "1000000000000000000000",
"currentClearingPrice": "1",
"currentVolume": "111000000000000000000",
"interestScore": "111",
"isAtomicClosureAllowed": false,
"isCleared": false,
"isPrivateAuction": true,
"minFundingThreshold": "0",
"minimumBiddingAmountPerOrder": "100000000000000000000",
"orderCancellationEndDate": "1720257099",
"startingTimeStamp": "1720255300",
"totalOrders": "1",
"txHash": "0x031e467c48cfdfac9fffeee6edfd10135c27748ad304ef14c9062ce4381031f5",
"uniqueBidders": "1"
}
]
}
}
graphql-request
library:- TypeScript
- JavaScript
index.ts
import { gql, GraphQLClient } from "graphql-request";
const graphQLClient = new GraphQLClient(
"https://api.studio.thegraph.com/query/23537/moxie_auction_stats_mainnet/version/latest"
);
const query = gql`
query MyQuery($auctionId: BigInt!) {
auctionDetails(where: { auctionId: $auctionId }) {
auctionId
allowListManager
allowListSigner
auctionEndDate
currentBiddingAmount
currentClearingOrderBuyAmount
currentClearingOrderSellAmount
currentClearingPrice
currentVolume
interestScore
isAtomicClosureAllowed
isCleared
isPrivateAuction
minFundingThreshold
minimumBiddingAmountPerOrder
orderCancellationEndDate
startingTimeStamp
totalOrders
txHash
uniqueBidders
}
}
`;
const variable = {
"auctionId": "1"
}
try {
const data = await graphQLClient.request(query, variable);
console.log(data);
} catch (e) {
throw new Error(e);
}
index.js
const { gql, GraphQLClient } = require("graphql-request");
const graphQLClient = new GraphQLClient(
"https://api.studio.thegraph.com/query/23537/moxie_auction_stats_mainnet/version/latest"
);
const query = gql`
query MyQuery($auctionId: BigInt!) {
auctionDetails(where: { auctionId: $auctionId }) {
auctionId
allowListManager
allowListSigner
auctionEndDate
currentBiddingAmount
currentClearingOrderBuyAmount
currentClearingOrderSellAmount
currentClearingPrice
currentVolume
interestScore
isAtomicClosureAllowed
isCleared
isPrivateAuction
minFundingThreshold
minimumBiddingAmountPerOrder
orderCancellationEndDate
startingTimeStamp
totalOrders
txHash
uniqueBidders
}
}
`;
const variable = {
"auctionId": "1"
}
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": {
"auctionDetails": [
{
"auctionId": "1",
"allowListManager": "0x7e6dd7ee0cd8a395b8ed5b21d8c40535cc1d4640",
"allowListSigner": "0x",
"auctionEndDate": "1720257100",
"currentBiddingAmount": "111000000000000000000",
"currentClearingOrderBuyAmount": "1000000000000000000000",
"currentClearingOrderSellAmount": "1000000000000000000000",
"currentClearingPrice": "1",
"currentVolume": "111000000000000000000",
"interestScore": "111",
"isAtomicClosureAllowed": false,
"isCleared": false,
"isPrivateAuction": true,
"minFundingThreshold": "0",
"minimumBiddingAmountPerOrder": "100000000000000000000",
"orderCancellationEndDate": "1720257099",
"startingTimeStamp": "1720255300",
"totalOrders": "1",
"txHash": "0x031e467c48cfdfac9fffeee6edfd10135c27748ad304ef14c9062ce4381031f5",
"uniqueBidders": "1"
}
]
}
}
Congrats! 🥳🎉 You've just fetched details of a certain Creator Coin auction!
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.