Get Auction Summary

In this tutorial, you will learn how to get the Moxie protocol's auction summary data, which includes:

• total auctions
• total bidding value
• total orders
• etc.

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 Moxie protocol's auction summary, you can use the following query:

Query

query MyQuery {
summaries {
  totalAuctions
  totalBiddingValue
  totalOrders
}
}

Response

{
"data": {
  "summaries": [
    {
      "totalAuctions": "41",
      "totalBiddingValue": "543157600000000000000000",
      "totalOrders": "65"
    }
  ]
}
}

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 {
summaries {
  totalAuctions
  totalBiddingValue
  totalOrders
}
}
`;



try {
  const data = await graphQLClient.request(query);
  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 {
summaries {
  totalAuctions
  totalBiddingValue
  totalOrders
}
}
`;



try {
  const data = await graphQLClient.request(query);
  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": {
  "summaries": [
    {
      "totalAuctions": "41",
      "totalBiddingValue": "543157600000000000000000",
      "totalOrders": "65"
    }
  ]
}
}

Congrats! 🥳🎉 You've just fetched Moxie protocol's auction summary!

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.