Aptos Network Documentation

Aptos RPC
With Dwellir, you get access to our global Aptos network which always routes your API requests to the nearest available location, ensuring low latency and the fastest speeds.

Get your API key →

Why Build on Aptos

• 160K+ TPS via Block-STM parallel execution
• Sub-second finality (~250 ms blocks) with AptosBFT v4
• Resource-oriented Move language with formal verification
• Native sponsored and multi-agent transactions
• Object model for powerful composition
• Evolving token standards (Fungible Asset and Digital Asset)

Quick Start

🔗 RPC Endpoints

Aptos MainnetChain ID: 1

Mainnet

HTTPS

https://api-aptos-mainnet.n.dwellir.com/YOUR_API_KEY/v1

✓ Archive Node✓ REST API✓ Indexer GraphQL✓ Streaming (coming)

Quick Connect:

curl -X GET https://api-aptos-mainnet.n.dwellir.com/YOUR_API_KEY/v1 \
  -H "Accept: application/json"

TypeScript SDK (@aptos-labs/ts-sdk)

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

const config = new AptosConfig({
  network: Network.MAINNET,
  fullnode: "https://api-aptos-mainnet.n.dwellir.com/YOUR_API_KEY/v1",
});
const aptos = new Aptos(config);

const info = await aptos.getLedgerInfo();
console.log(info.chain_id, info.ledger_version);

Python SDK (aptos-sdk)

from aptos_sdk.client import RestClient

client = RestClient("https://api-aptos-mainnet.n.dwellir.com/YOUR_API_KEY/v1")
info = client.get_ledger_info()
print(info["chain_id"], info["ledger_version"])  # 1 APT = 100,000,000 Octas

Rust SDK

use aptos_sdk::rest_client::Client;

let client = Client::new("https://api-aptos-mainnet.n.dwellir.com/YOUR_API_KEY/v1".parse()?);
let info = client.get_ledger_information().await?;
println!("{} {}", info.inner().chain_id, info.inner().ledger_version);

cURL

curl -s "https://api-aptos-mainnet.n.dwellir.com/YOUR_API_KEY/v1" -H "Accept: application/json"

Network Information

Chain ID

1

Mainnet

Native Token

APT

1 APT = 100,000,000 Octas

Consensus

AptosBFT v4

~250 ms blocks

Execution

Block-STM

Parallel transactions

REST API Reference

• Base path: /v1
• Auth: Add your key in the URL path: https://api-aptos-mainnet.n.dwellir.com/YOUR_API_KEY/v1
• JSON responses, snake_case fields, bcs-encoded payloads for transactions

REST API Endpoints

Accounts

Account info, resources, and modules

+

Blocks

Query blocks by height or version

+

Events

Query events by creation number or handle

+

Tables

Access on-chain tables by handle

+

Transactions

Submit, query, encode, and simulate

+

View Functions

Gas-free reads via Move views

+

General

Ledger info, health, and spec

+

Need mainnet access? Get your API key.

Get your API key →

GraphQL API Reference

• Indexer GraphQL endpoint: https://api-aptos-mainnet.n.dwellir.com/YOUR_API_KEY/v1/graphql
• Advanced queries for transactions, tokens, ANS, aggregations
• Real-time subscription support (see Streaming for gRPC)

See the GraphQL section for examples and schema notes.

Transaction Stream Service

• gRPC-based real-time transaction stream
• Historical replay from genesis, checkpointing, custom processors
• Early access available — email support@dwellir.com

Move Development

• Entry functions (transactions) vs view functions (read-only)
• Modules, resources, and abilities (key, store, drop, copy)
• Testing with Move unit tests and Move Prover

Object Model

• Globally addressable objects enable safe composition
• Reference types: ConstructorRef, MutatorRef, DeleteRef
• Ownership hierarchies and type-safe conversions

Token Standards

• Legacy: 0x1::coin, 0x3::token
• Current: Fungible Asset (FA) and Digital Asset (DA)
• Migration patterns and compatibility tips

Unique Aptos Features

• Sponsored transactions (fee payer)
• Multi-agent transactions (multiple signers)
• Key rotation (proven/unproven)
• Aggregator V2 counters
• Orderless transactions

Code Examples

Find end-to-end examples for transfers, NFTs, module publish, and token ops in the respective sections.

Performance Optimization

• Parallel-friendly design patterns (minimize write conflicts)
• Gas optimization via simulation and views
• Aggregators for scalable counters
• Batching reads and writes when appropriate

Troubleshooting

• Common REST errors, transaction failures, module verification
• Gas estimation pitfalls and how to resolve them

Resources & Tools

• Official SDKs (TS, Python, Rust)
• Explorers, faucets, testing tools, community links