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.

Include User's Vesting Addresses

Moxie protocol users have Moxie token currently vesting in their vesting contract. A huge portion of them use these to bid on auctions and buy/sell fan tokens on the Moxie protocol.

Therefore, it is important that you include the user's vesting addresses in the query to get user's auction bids. To get user's vesting contract addresses, click here.

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($userAddresses: [Bytes!]) {
users(where: { address_in: $userAddresses }) {
  orders {
    buyAmount
    sellAmount
    price
    status
    timestamp
    txHash
  }
}
}

Variable

{
"userAddresses": [
  "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($userAddresses: [Bytes!]) {
users(where: { address_in: $userAddresses }) {
  orders {
    buyAmount
    sellAmount
    price
    status
    timestamp
    txHash
  }
}
}
`;

const variable = {
"userAddresses": [
  "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($userAddresses: [Bytes!]) {
users(where: { address_in: $userAddresses }) {
  orders {
    buyAmount
    sellAmount
    price
    status
    timestamp
    txHash
  }
}
}
`;


const variable = {
"userAddresses": [
  "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.