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.