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 Moxie Official Warpcast channel and ask your questions there.

Our team is always ready to help you with any questions you may have.