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:
- Create an API key in your project dashboard
- Choose your target network (Only mainnet is supported for now) and corresponding API endpoint
- Set up authentication by including your API key in the Authorization header
- 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.