Get User's Auction Bids

In this tutorial, you will learn how to get user's auction bids by calling the Moxie Auction Subgraph API.

Pre-requisites

Install dependencies graphql and graphql-request to your project :

npm

npm install graphql graphql-request 

yarn

yarn add graphql graphql-request 

pnpm

pnpm add graphql graphql-request 

bun

bun install graphql graphql graphql-request 

Step 1: Add The API Query To Your Code

To get user's auction bids, you can use the following query:

Query

query MyQuery($userAddress: Bytes!) {
users(where: { address: $userAddress }) {
  orders {
    buyAmount
    sellAmount
    price
    status
    timestamp
    txHash
  }
}
}

Variable

{
"userAddress": "0x1a45675bd474c8e3056a7dbd19e738d7849c0d26"
}

Response

{
"data": {
  "users": [
    {
      "orders": [
        {
          "buyAmount": "50000000000000000000",
          "sellAmount": "100000000000000000000",
          "price": "2",
          "status": "Cancelled",
          "timestamp": "1721122810",
          "txHash": "0x0681eec905142e218f3feb45280f05164d3cfdc132ca59cc3bed05944ff60d9e"
        }
      ]
    }
  ]
}
}

With this GraphQL query, you can add it to your source code and call the API with the graphql-request library:

TypeScript

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($userAddress: Bytes!) {
users(where: { address: $userAddress }) {
  orders {
    buyAmount
    sellAmount
    price
    status
    timestamp
    txHash
  }
}
}
`;

const variable = {
"userAddress": "0x1a45675bd474c8e3056a7dbd19e738d7849c0d26"
}


try {
  const data = await graphQLClient.request(query, variable);
  console.log(data);
} catch (e) {
  throw new Error(e);
}

JavaScript

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($userAddress: Bytes!) {
users(where: { address: $userAddress }) {
  orders {
    buyAmount
    sellAmount
    price
    status
    timestamp
    txHash
  }
}
}
`;


const variable = {
"userAddress": "0x1a45675bd474c8e3056a7dbd19e738d7849c0d26"
}


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

ts-node index.ts

JavaScript

node index.js

If it runs successfully, you should see the data returned in the terminal:

{
"data": {
  "users": [
    {
      "orders": [
        {
          "buyAmount": "50000000000000000000",
          "sellAmount": "100000000000000000000",
          "price": "2",
          "status": "Cancelled",
          "timestamp": "1721122810",
          "txHash": "0x0681eec905142e218f3feb45280f05164d3cfdc132ca59cc3bed05944ff60d9e"
        }
      ]
    }
  ]
}
}

Congrats! 🥳🎉 You've just fetched user's auction bids!

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.