# Aptos (APT) On-Chain API
> Live on-chain data from the Aptos blockchain (APT), a high-throughput Move-based Layer 1, served straight from the official public Aptos fullnode REST API — no key, nothing cached. The account endpoint returns any address's state: its sequence number, authentication key, APT balance and how many on-chain resources it holds. The balance endpoint returns the balance of APT or any coin or fungible asset for an address, handling both the classic coin standard and the newer fungible-asset standard in one call. The resources endpoint lists the Move resource types an account holds — its coins, stores, staking and module data — the structural view of what lives at an address. The transactions endpoint returns the account's most recent transactions with the version, hash, entry function, success flag, gas used and time. The network endpoint returns the live chain state: chain id, the latest ledger version and block height, the epoch and the ledger timestamp. Everything is read live from the fullnode, nothing stored. This is the Aptos on-chain layer for any wallet, explorer, payments, gaming or analytics app. Distinct from the XRP Ledger, Stellar, TRON, EVM and Solana on-chain APIs and from price feeds — this is Aptos account state, balances, Move resources, transactions and ledger health. 5 endpoints, no key on our side.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/aptos-api/..."
```

## Pricing
- **Free** (Free) — 4,500 calls/Mo, 5 req/s
- **Starter** ($12/Mo) — 110,000 calls/Mo, 12 req/s
- **Pro** ($31/Mo) — 640,000 calls/Mo, 30 req/s
- **Mega** ($76/Mo) — 3,400,000 calls/Mo, 80 req/s

## Endpoints

### Aptos

#### `GET /v1/account` — An address's state

**Parameters:**
- `address` (query, required, string) — Aptos address (0x...) Example: `0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/aptos-api/v1/account?address=0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d"
```

**Response:**
```json
{
    "data": {
        "source": "Aptos",
        "address": "0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d",
        "apt_balance": 32794.6384777,
        "resource_count": 1,
        "sequence_number": 31015,
        "authentication_key": "0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d"
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:51.673Z",
        "request_id": "59304cc8-b8e1-482a-bae3-9645fd30144e"
    },
    "status": "ok",
    "message": "Account retrieved successfully",
    "success": true
}
```

#### `GET /v1/balance` — Balance of APT or any asset

**Parameters:**
- `address` (query, required, string) — Aptos address (0x...) Example: `0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d`
- `asset` (query, optional, string) — APT (default), an FA address or a coin type Example: `APT`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/aptos-api/v1/balance?address=0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d&asset=APT"
```

**Response:**
```json
{
    "data": {
        "asset": "0xa",
        "source": "Aptos",
        "address": "0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d",
        "balance": 32794.6300932,
        "balance_raw": "3279463009320",
        "decimals_assumed": 8
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:51.935Z",
        "request_id": "06c3b36d-68ca-402b-89f5-c882e5ec96c7"
    },
    "status": "ok",
    "message": "Balance retrieved successfully",
    "success": true
}
```

#### `GET /v1/network` — Live Aptos chain state

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/aptos-api/v1/network"
```

**Response:**
```json
{
    "data": {
        "epoch": 16115,
        "source": "Aptos",
        "chain_id": 1,
        "git_hash": "7f0840cc711a8415e765e15a6bf06955107df741",
        "node_role": "full_node",
        "block_height": "820275931",
        "ledger_version": "5654251983",
        "ledger_timestamp": "2026-06-09T20:24:51.978Z"
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:52.176Z",
        "request_id": "1dbffce3-e122-420a-9256-a64772c58945"
    },
    "status": "ok",
    "message": "Network state retrieved successfully",
    "success": true
}
```

#### `GET /v1/resources` — Move resource types an account holds

**Parameters:**
- `address` (query, required, string) — Aptos address (0x...) Example: `0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d`
- `limit` (query, optional, string) — Max types (default 100) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/aptos-api/v1/resources?address=0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d&limit=50"
```

**Response:**
```json
{
    "data": {
        "source": "Aptos",
        "address": "0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d",
        "resources": [
            "0x1::account::Account"
        ],
        "resource_count": 1
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:52.422Z",
        "request_id": "5c2778d4-9dc5-476e-a9f6-4015586addec"
    },
    "status": "ok",
    "message": "Resources retrieved successfully",
    "success": true
}
```

#### `GET /v1/transactions` — Recent transactions

**Parameters:**
- `address` (query, required, string) — Aptos address (0x...) Example: `0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d`
- `limit` (query, optional, string) — Max transactions (1-100, default 20) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/aptos-api/v1/transactions?address=0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d&limit=10"
```

**Response:**
```json
{
    "data": {
        "count": 10,
        "source": "Aptos",
        "address": "0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d",
        "transactions": [
            {
                "hash": "0xd17c9e4ecaa7d6095eb288661e30398bb11df6a30f2c5b799426a2c68949d764",
                "time": "2026-05-11T11:19:27.127Z",
                "type": "user_transaction",
                "sender": "0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d",
                "success": true,
                "version": "5222674214",
                "function": "0x50ead22afd6ffd9769e3b3d6e0e64a2a350d68e8b102c4e72e33d0b8cfdfdb06::dex_accounts_entry::cancel_order_to_subaccount",
                "gas_used": 229,
                "vm_status": "Executed successfully"
            },
            {
                "hash": "0xd4c680d9a55653df00d7a8ebe89278ecad2995b288c6b44ce42b17e897e668a4",
                "time": "2026-05-11T11:19:29.168Z",
                "type": "user_transaction",
                "sender": "0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d",
                "success": true,
                "version": "5222674548",
                "function": "0x50ead22afd6ffd9769e3b3d6e0e64a2a350d68e8b102c4e72e33d0b8cfdfdb06::dex_accounts_entry::cancel_order_to_subaccount",
                "gas_used": 223,
                "vm_status": "Executed successfully"
            },
            {
                "hash": "0x920c41810fc3dd7dd2ae1542edf596f4fb22ca
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/aptos-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Aptos public fullnode REST API (live)",
        "service": "aptos-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/account": "An address's state (address=0xd503b95164384a5ebbccbb5c4bdc8b4a5893d9651e9953abda8e1c22fcc1181d).",
            "GET /v1/balance": "Balance of APT or any coin/FA (address=, asset=APT).",
            "GET /v1/network": "Live Aptos chain state: chain id, ledger version, block height, epoch.",
            "GET /v1/resources": "The Move resource types an account holds (address=).",
            "GET /v1/transactions": "An address's recent transactions (address=, limit)."
        },
        "description": "Live on-chain data from the Aptos blockchain (APT), a high-throughput Move Layer 1, from the official public fullnode REST API: any address's state (sequence number, auth key, APT balance, resource count); the balance of APT or any coin/fungible asset (handling both the coin and fungible-asset standards); the Move resource types an account holds; the account's recent transactions (version, hash, entry function, success, gas, time); and the live chain state (chain id, ledger version, block height, epoch, timestamp). Live, no key, nothing stored. Distinct from the XRP Ledger, Stellar, TRON, EVM and Solana on-chain APIs and from price feeds — this is Aptos account state, balances, Move resources, transactions and ledger health.",
        "upstream_status": "ok"
    },
    "meta
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/aptos-api
OpenAPI spec: https://www.oanor.com/api/aptos-api/openapi.json