Skip to content

NFT APIs

Geomi supports APIs for NFT aggregation by capturing 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.

What We Provide

  • NFT Aggregator API for querying activities
  • NFT Analytics API for aggregated analytics

Our API supports two main use cases:

  • Historical Data tracking: Listings, NFT Token Offers, NFT Collection Offers — in real-time.
  • Analytics & Trends: Aggregate data, market insights, top traders, and more.

NFT Aggregator API

Query real-time marketplace activity across all integrated marketplaces. Use this for:

  • Basic historical data
  • Aggregated data (e.g. how many listings are there for a given collection)

Endpoints:

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

Use Cases:

  • Query NFT collections and individual tokens
  • Access marketplace listings and sales data
  • Retrieve NFT metadata and properties
  • Build NFT marketplaces and portfolio trackers

NFT Analytics API

Get high-level insights and historical data on the NFT market. Use this analytics API for:

Endpoints:

  • Mainnet REST Endpoint: https://api.mainnet.aptoslabs.com/v1/analytics/nft

Use Cases:

  • Total sales volumes
  • Top buyers and sellers
  • Marketplace trends
  • Market analytics and trading volume data
  • Price history and trend analysis
  • Collection performance metrics

Getting Started

To start using these APIs, you’ll need to:

  1. Create an API key in your project dashboard
  2. Choose your target network (Only mainnet is supported for now) and corresponding API endpoint
  3. Set up authentication by including your API key in the Authorization header
  4. Build requests to fetch the specific NFT data you need (GraphQL for Aggregator, REST for Analytics)

Both APIs are designed to work together, providing a complete solution for NFT data needs on Aptos. The Aggregator API handles real-time data access, while the Analytics API provides historical insights and market intelligence.