Skip to main content

Get All Bids On Certain Auction

In this tutorial, you will learn how to get all bids, regardless of status (e.g. created, cancelled, claimed), on a certain 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 all bids registered on a certain auction, you can use the following query:

query MyQuery($auctionId: String!) {
orders(where: { auction: $auctionId }) {
  buyAmount
  encodedOrderId
  isExactOrder
  price
  sellAmount
  status
  timestamp
  txHash
  user {
    address
  }
  userWalletAddress
  volume
}
}
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: String!) {
orders(where: { auction: $auctionId }) {
  buyAmount
  encodedOrderId
  isExactOrder
  price
  sellAmount
  status
  timestamp
  txHash
  user {
    address
  }
  userWalletAddress
  volume
}
}
`;

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": {
  "orders": [
    {
      "buyAmount": "1000000000000000000000",
      "encodedOrderId": "0x00000000000000010000003635c9adc5dea000000000003635c9adc5dea00000",
      "isExactOrder": true,
      "price": "1",
      "sellAmount": "1000000000000000000000",
      "status": "Placed",
      "timestamp": "1720255300",
      "txHash": "0x031e467c48cfdfac9fffeee6edfd10135c27748ad304ef14c9062ce4381031f5",
      "user": {
        "address": "0x3199219bda5dbc9ee45bb3dfad180be56a7ebfd0"
      },
      "userWalletAddress": "0x3199219bda5dbc9ee45bb3dfad180be56a7ebfd0",
      "volume": "1000"
    }
  ]
}
}

Congrats! 🥳🎉 You've just fetched all the bids registered on a certain 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.