Skip to content
This repository was archived by the owner on Jul 30, 2025. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 4 additions & 8 deletions apps/nextra/pages/en/build/indexer/nft-aggregator.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,7 @@ title: "NFT Aggregator API"
import { IndexerBetaNotice, Card, Cards } from '@components/index';
import { Callout } from 'nextra/components';

<Callout type="info">
The NFT Aggregator API is currently in beta. If you're building an aggregator or need real-time event streaming via gRPC, please reach out to our team for early access and support!
</Callout>

We're building a **universal NFT aggregator** for the Aptos ecosystem - normalized activity across all major marketplaces, including **Tradeport**, **Wapal**, **Bluemove**, **Rarible**, and more. We also maintain historical data for deprecated marketplaces like **Topaz**.
We've built a **universal NFT aggregator** for the Aptos ecosystem - normalized activity across all major marketplaces, including **Tradeport**, **Wapal**, **Bluemove**, **Rarible**, and more. We also maintain historical data for deprecated marketplaces like **Topaz**.

At its core, the aggregator captures marketplace events in real-time (like listings, token offers, and collection-wide offers) and converts them into clean, structured data. This allows developers to work with a unified data format — no need to handle different marketplace-specific formats manually.

Expand All @@ -31,10 +27,10 @@ Query real-time marketplace activity across all integrated marketplaces. Use thi
- Aggregated data (e.g. how many listings are there for a given collection)

You can explore it by hand by viewing the Hasura Explorer below for the network you are interested in.
- Hasura Console: https://console.nft-aggregator-staging.gcp.aptosdev.com/console/api/api-explorer
- Hasura Console: https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/nft-aggregator/v1/graphql

For direct GraphQL queries to the Aptos-Labs hosted Indexer API, use these endpoints:
- Mainnet Graphql Endpoint: https://api.mainnet.aptoslabs.com/nft-aggregator-staging/v1/graphql
- Mainnet Graphql Endpoint: https://api.mainnet.aptoslabs.com/nft-aggregator/v1/graphql

you can find the full API reference [here](./nft-aggregator/graphql-api.mdx).

Expand Down Expand Up @@ -69,4 +65,4 @@ If you'd like your marketplace to be included, please reach out to our team. We
Ready to dive deeper?
- 👉 [GraphQL API](./nft-aggregator/graphql-api.mdx)
- 👉 [Analytics REST API](./nft-aggregator/analytics-api.mdx)
- 👉 [Integrated Marketplaces](./nft-aggregator/marketplaces.mdx)
- 👉 [Integrated Marketplaces](./nft-aggregator/marketplaces.mdx)
Original file line number Diff line number Diff line change
Expand Up @@ -13,9 +13,9 @@ The GraphQL API provides real-time access to NFT marketplace activity across the

## Endpoints

- **Hasura Console:** [API Explorer](https://console.nft-aggregator-staging.gcp.aptosdev.com/console/api/api-explorer)
- **Hasura Console:** [API Explorer](https://cloud.hasura.io/public/graphiql?endpoint=https://api.mainnet.aptoslabs.com/nft-aggregator/v1/graphql)
- **Mainnet Endpoint:**
`https://api.mainnet-staging.aptoslabs.com/nft-aggregator/v1/graphql`
`https://api.mainnet.aptoslabs.com/nft-aggregator/v1/graphql`

## Schema

Expand Down Expand Up @@ -150,4 +150,4 @@ Try it yourself! Adjust the token_data_id and other filters to explore specific
variables={`{
"token_data_id": "0x8142a7fde5039839509e81615e456413bac1c53a1d6c6447f2daf64e84665948"
}`}
/>
/>
Original file line number Diff line number Diff line change
Expand Up @@ -152,6 +152,7 @@ Tracks current active token offers by token and buyer.
| token_amount | Option\<i64> | Token quantity |
| token_name | Option\<String> | Token name |
| standard_event_type | String | Normalized event type |
| bid_key | Option\<i64> | Unique bid key |
| is_deleted | bool | Offer active status |
| marketplace | String | Marketplace name |
| contract_address | String | Marketplace contract address |
Expand Down