Skip to main content

Get Details Of Certain Fan Token Auction

In this tutorial, you will learn how to get details of a certain fan token auction by calling the Moxie Auction Subgraph API.

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 details of a certain fan token auction, you can use the following query:

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
  }
}
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_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:

ts-node index.ts

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 fan token auction!

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.