NFT Aggregator API

The NFT Aggregator API provides a unified GraphQL interface to access normalized NFT marketplace data across the Aptos ecosystem by capturing real-time marketplace events (listings, token offers, and collection-wide offers) from major marketplaces. This enables developers to build NFT marketplaces, portfolio trackers, and analytics applications without handling different data formats manually.

What You Can Build

• NFT Marketplaces: Display active listings from multiple marketplaces including your own marketplace
• Portfolio Trackers: Monitor NFT holdings and values
• Analytics Dashboards: Track marketplace activity and trends
• Price Discovery Tools: Compare prices across marketplaces

Getting Started with Geomi

Authentication

All NFT Aggregator API requests require a Geomi API key. Learn how to create one.

curl "https://api.mainnet.aptoslabs.com/nft-aggregator/v1/graphql" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json"

Base URL

Mainnet: https://api.mainnet.aptoslabs.com/nft-aggregator/v1/graphql

Interactive GraphiQL Explorer

Test and explore the API interactively using the Hasura GraphiQL interface:

Open GraphiQL Explorer

Rate Limits & Billing

For detailed pricing, rate limits, and billing information, see the Billing Documentation.

Example Queries

Collection-Specific Listings

query GetCollectionListings($collection_id: String!) {
  current_nft_marketplace_listings(
    where: {
      collection_id: {_eq: $collection_id}
      is_deleted: {_eq: false}
    }
    order_by: {price: asc}
    limit: 50
  ) {
    token_name
    price
    marketplace
    seller
    current_token_data {
      token_uri
      cdn_asset_uris {
        cdn_image_uri
      }
    }
  }
}

Active Marketplace Listings

query GetMarketplaceListings {
  current_nft_marketplace_listings(
    limit: 10
    where: {is_deleted: {_eq: false}}
    order_by: {last_transaction_timestamp: desc}
  ) {
    token_name
    token_data_id
    seller
    price
    marketplace
    listing_id
    last_transaction_timestamp
    collection_id
    collection_data {
      collection_name
      uri
      creator_address
    }
    current_token_data {
      token_uri
      token_name
      description
      cdn_asset_uris {
        cdn_image_uri
        asset_uri
      }
    }
  }
}

Full API Reference on aptos.dev

For comprehensive NFT Aggregator API documentation, visit aptos.dev/build/indexer/nft-aggregator/graphql-api.

What you’ll find there:

• Interactive GraphQL Editor:Test queries in real-time with live data
• Complete schema reference with all available fields and types
• Advanced query examples (collection offers, token offers, marketplace activities)
• Filtering, sorting, and pagination patterns
• Full table schema documentation

The interactive editor lets you experiment with queries, adjust filters, and see results instantly - much more powerful than static examples!