Aptos APIs

Use these APIs to read chain state, submit transactions, index historical data, and fund test accounts. Most application code should go through an official SDK; the HTTP, GraphQL, and gRPC endpoints below are the underlying services those SDKs call.

Choose an API

You need	Use
Latest on-chain state, transaction submission, or simulation	Fullnode REST API
NFTs, objects, historical activity, or aggregated tables	Indexer GraphQL API
A real-time or historical transaction feed for a custom indexer	Transaction Stream (gRPC)
Test APT on Devnet or Testnet	Faucet API
SQL, dashboards, or third-party RPC	Data providers

Official Aptos Labs endpoints

Aptos Labs operates these deployments for each Aptos network on behalf of the Aptos Foundation. fullnode.{network}.aptoslabs.com is an alias of api.{network}.aptoslabs.com; prefer the api. hostnames.

Network	REST API (`/v1`)	Indexer GraphQL	Transaction Stream gRPC	Faucet
Mainnet	`https://api.mainnet.aptoslabs.com/v1`	`https://api.mainnet.aptoslabs.com/v1/graphql`	`grpc.mainnet.aptoslabs.com:443`	—
Testnet	`https://api.testnet.aptoslabs.com/v1`	`https://api.testnet.aptoslabs.com/v1/graphql`	`grpc.testnet.aptoslabs.com:443`	Mint page and `https://faucet.testnet.aptoslabs.com` (Google sign-in)
Devnet	`https://api.devnet.aptoslabs.com/v1`	`https://api.devnet.aptoslabs.com/v1/graphql`	`grpc.devnet.aptoslabs.com:443`	`https://faucet.devnet.aptoslabs.com` (programmatic)

The Node API spec is published on this site as OpenAPI JSON and a browsable REST API reference. Live Swagger UIs also run on each fullnode at /v1/spec.

Fullnode REST API

This API ships with every fullnode. It is the low-latency path for reading state, submitting transactions, and simulating transactions.

REST API reference Browsable docs generated from the Aptos Node API OpenAPI spec

REST API guide Rate limits, pruning, view functions, and how to query state

Mainnet explorer Live Swagger UI against api.mainnet.aptoslabs.com

Testnet explorer Live Swagger UI against api.testnet.aptoslabs.com

Devnet explorer Live Swagger UI against api.devnet.aptoslabs.com

Indexer

Indexer GraphQL API High-level GraphQL for NFTs, Aptos Objects, fungible assets, and custom contract data

Transaction Stream API gRPC stream of historical and real-time transactions for Aptos Core Indexing and app-specific processors

Faucet (Devnet and Testnet)

Faucet API Mint test APT on Devnet programmatically, or on Testnet through Google sign-in / the mint page

Geomi and data providers

Geomi API keys, higher rate limits, gas station, and no-code indexing for Aptos Labs hosted APIs

Data providers SQL datasets, analytics dashboards, and third-party RPC endpoints

The Node API, Indexer, Transaction Stream, and faucet implementations are open source in aptos-core. Anyone can run them; independent operators and builders do so worldwide. Additional RPC vendors are listed in the Aptos ecosystem directory.

Authentication and rate limits

Labs-hosted Node, Indexer, and Transaction Stream APIs allow anonymous access with a low per-IP rate limit. For higher limits and usage metrics, create a Geomi API key and send it as a bearer token.

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

import { Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";

const aptos = new Aptos(
  new AptosConfig({
    network: Network.MAINNET,
    clientConfig: { API_KEY: process.env.APTOS_API_KEY },
  }),
);