API Reference

This page provides a comprehensive reference for all Geomi APIs. Choose an API below to view endpoints, authentication, and examples.

Overview

Geomi provides access to multiple Aptos blockchain APIs:

Node API - Direct blockchain access (REST)
Indexer API - Advanced queries (GraphQL)
Transaction Stream - Real-time data (GRPC)
NFT Aggregator API - Marketplace data (GraphQL)
NFT Analytics API - Market intelligence (REST)

Authentication

While anonymous API access is available with rate limits, we strongly recommend using a Geomi API key for significantly higher limits and usage tracking. Learn how to create one or get started now by creating a new API key in Geomi.

curl "https://api.mainnet.aptoslabs.com/v1" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

Rate Limits & Billing

All APIs use a Compute Unit (CU) based billing system. For detailed pricing and limits, see the Billing Documentation.

Anonymous requests are limited to 50,000 CUs per 5 minutes per IP. API key usage provides significantly higher limits.

About Compute Units (CUs)

CUs measure the relative infrastructure cost of a request.
More complex or longer‑running requests consume more CUs.
For current formulas, limits, and prices, see Billing.

Node API (Fullnode REST API)

Direct access to the Aptos blockchain for reading state and submitting transactions.

Base URLs

Mainnet: https://api.mainnet.aptoslabs.com/v1
Testnet: https://api.testnet.aptoslabs.com/v1
Devnet: https://api.devnet.aptoslabs.com/v1

Key Features

Read blockchain state
Submit transactions
Transaction simulation
Low latency access

Example: Get Account

curl "https://api.mainnet.aptoslabs.com/v1/accounts/0x1" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example: Get Account Resources

curl "https://api.mainnet.aptoslabs.com/v1/accounts/0x1/resources" \
  -H "Authorization: Bearer YOUR_API_KEY"

Documentation

Indexer API (GraphQL)

High-level GraphQL interface for complex blockchain queries.

Base URLs

Mainnet: https://api.mainnet.aptoslabs.com/v1/graphql
Testnet: https://api.testnet.aptoslabs.com/v1/graphql
Devnet: https://api.devnet.aptoslabs.com/v1/graphql

Key Features

GraphQL queries with filtering
NFT and Aptos Objects support
Historical data access
Custom Move contract queries

Interactive Explorer

Open GraphiQL Interface

Example Query: Get Token Data

query GetTokenData {
  current_token_datas_v2(
    where: {collection_id: {_eq: "0x123..."}}
    limit: 10
  ) {
    token_name
    token_uri
    collection_data {
      collection_name
    }
  }
}

Execute with curl:

curl "https://api.mainnet.aptoslabs.com/v1/graphql" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "query GetTokenData { current_token_datas_v2(where: {collection_id: {_eq: \"0x123...\"}}, limit: 10) { token_name token_uri collection_data { collection_name } } }"}'

Example Query: Get Account Transactions

query GetAccountTransactions($address: String!) {
  account_transactions(
    where: {account_address: {_eq: $address}}
    limit: 20
    order_by: {transaction_timestamp: desc}
  ) {
    transaction_version
    transaction_timestamp
    transaction_type
  }
}

Execute with curl:

curl "https://api.mainnet.aptoslabs.com/v1/graphql" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "query GetAccountTransactions($address: String!) { account_transactions(where: {account_address: {_eq: $address}}, limit: 20, order_by: {transaction_timestamp: desc}) { transaction_version transaction_timestamp transaction_type } }", "variables": {"address": "0x1"}}'

Documentation

Full API Reference

Transaction Stream Service (GRPC)

Real-time transaction streaming for custom indexing.

Endpoints

Mainnet: grpc.mainnet.aptoslabs.com:443
Testnet: grpc.testnet.aptoslabs.com:443
Devnet: grpc.devnet.aptoslabs.com:443

Key Features

Historical and real-time transactions
Custom indexing processors
High throughput streaming
Event monitoring

Use Cases

Custom application indexers
Real-time data processing
Analytics pipelines
Event monitoring systems

Example: Stream Transactions with grpcurl

grpcurl -d '{ "starting_version": 0 }' \
  -max-msg-sz 30000000 \
  -H "authorization: Bearer YOUR_API_KEY" \
  grpc.mainnet.aptoslabs.com:443 \
  aptos.indexer.v1.RawData/GetTransactions

Note: Requires grpcurl to be installed.

Documentation

NFT Aggregator API (GraphQL)

Unified interface for NFT marketplace data across the Aptos ecosystem.

Base URL

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

Interactive Explorer

Open GraphiQL Interface

Key Features

Real-time marketplace listings
Cross-marketplace aggregation
Normalized NFT data
Rich metadata access

Example Query: Get Active Listings

query GetActiveListings {
  current_nft_marketplace_listings(
    where: {is_deleted: {_eq: false}}
    limit: 10
  ) {
    token_name
    price
    marketplace
    seller
    current_token_data {
      token_name
      token_uri
      description
      cdn_asset_uris {
        cdn_image_uri
      }
    }
  }
}

Execute with curl:

curl "https://api.mainnet.aptoslabs.com/nft-aggregator/v1/graphql" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "query GetActiveListings { current_nft_marketplace_listings(where: {is_deleted: {_eq: false}}, limit: 10) { token_name price marketplace seller current_token_data { token_name token_uri description cdn_asset_uris { cdn_image_uri } } } }"}'

Example Query: Get Collection 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
  }
}

Documentation

NFT Analytics API (REST)

Market intelligence and historical NFT data.

Base URL

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

Key Features

Collection rankings
Top traders
Historical trends
Floor price tracking

Example: Top Collections by Volume

curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/collection/list_by_volume?limit=10&time_period=24h" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example: Collection Floor Price

curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/collection/floor_price?collection_id=COLLECTION_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example: Top Traders

curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/trader/top_traders?limit=20&time_period=30d" \
  -H "Authorization: Bearer YOUR_API_KEY"

Documentation

SDKs

Aptos provides official SDKs for multiple languages. For full documentation, installation guides, and examples, see the SDK documentation on aptos.dev.

Quick Start:

TypeScript: npm install @aptos-labs/ts-sdk - Docs
Python: pip install aptos-sdk - Docs
Rust: Installation Guide
Go: Installation Guide

Next Steps

API Keys No-Code Indexing