Skip to content
🎉 Welcome to the new Aptos Docs! Click here to submit an issue.

GraphQL API

The GraphQL API provides real-time access to NFT marketplace activity across the Aptos ecosystem.

Endpoints

  • Hasura Console: API Explorer
  • Mainnet Endpoint:
    https://api.mainnet-staging.aptoslabs.com/nft-aggregator/v1/graphql

Schema

The API follows standard GraphQL conventions.

You can explore all available queries and types using the API Explorer linked above.

Some key types:

  • current_nft_marketplace_listings: Get active listings
  • current_nft_marketplace_token_offers: See offers made on specific tokens
  • current_nft_marketplace_collection_offers: Track offers made at the collection level
  • nft_marketplace_activities: Monitor all marketplace activities

➡️ Full Schema Reference

Example Queries

Get Active Listings with Token Metadata

Retrieve active NFT listings enriched with token metadata.

Try it yourself! Adjust filters like marketplace, limit, and sorting to explore more results.

Loading...

No variables are required for this query by default, but you can adjust the where filter directly inside the editor.


Get Collection Offers with Collection Metadata

Retrieve active collection-level offers along with detailed collection metadata.

Try it yourself! Adjust marketplace filter and pagination to explore more offers.

Loading...

Get Token Offers with Token Metadata

Retrieve active token-specific offers along with detailed token metadata.

Try it yourself! Adjust the token_data_id and other filters to explore specific token offers.

Loading...