# Nano API
> Live on-chain data from the Nano network (XNO), a feeless, instant cryptocurrency with a block-lattice architecture where every account has its own blockchain and consensus is reached by Open Representative Voting (ORV): an account's confirmed XNO balance, receivable balance, block count and delegated representative; an account's own chain of blocks; a single block's amount, balance, height and confirmation; and the network's total, cemented and unchecked block counts plus the online voting weight securing it.

## 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/nano-api/..."
```

## Pricing
- **Free** (Free) — 9,000 calls/Mo, 3 req/s
- **Basic** ($8/Mo) — 135,000 calls/Mo, 8 req/s
- **Pro** ($21/Mo) — 880,000 calls/Mo, 15 req/s
- **Scale** ($55/Mo) — 4,620,000 calls/Mo, 30 req/s

## Endpoints

### Network

#### `GET /v1/network` — Live Nano block counts and online ORV voting weight

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

**Response:**
```json
{
    "data": {
        "chain": "nano",
        "source": "Nano",
        "feeless": true,
        "consensus": "Open Representative Voting (ORV)",
        "native_token": "XNO",
        "total_blocks": 220091712,
        "cemented_blocks": 220091712,
        "unchecked_blocks": 2286,
        "peers_stake_total_nano": 86766181.53094324,
        "online_stake_total_nano": 86938967.62229627,
        "online_weight_minimum_nano": 60000000,
        "online_weight_quorum_percent": 67
    },
    "meta": {
        "timestamp": "2026-06-10T13:59:45.068Z",
        "request_id": "e84b78c1-6f04-428f-9bd1-2444f6903659"
    },
    "status": "ok",
    "message": "Network state retrieved successfully",
    "success": true
}
```

### Account

#### `GET /v1/account` — An account XNO balance, receivable and representative

**Parameters:**
- `account` (query, required, string) — Nano account (nano_...) Example: `nano_1nanode8ngaakzbck8smq6ru9bethqwyehomf79sae1k7xd47dkidjqzffeg`

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

**Response:**
```json
{
    "data": {
        "source": "Nano",
        "account": "nano_1nanode8ngaakzbck8smq6ru9bethqwyehomf79sae1k7xd47dkidjqzffeg",
        "frontier": "44DF0057D33D38C317A35CF9F034B9189BAE031DE032B385E3F453E5FD5ED279",
        "modified": "2021-02-22T22:55:19.000Z",
        "balance_raw": "437022401290003970326450322946",
        "block_count": 52,
        "balance_nano": 0.4370224,
        "representative": "nano_1anrzcuwe64rwxzcco8dkhpyxpi8kd7zsjc1oeimpc3ppca4mrjtwnqposrs",
        "receivable_nano": 1.0e-5
    },
    "meta": {
        "timestamp": "2026-06-10T13:59:45.360Z",
        "request_id": "38929330-8656-45ac-9a11-3cf29b59ed5f"
    },
    "status": "ok",
    "message": "Account retrieved successfully",
    "success": true
}
```

#### `GET /v1/history` — An account own chain of blocks (block-lattice)

**Parameters:**
- `account` (query, required, string) — Nano account (nano_...) Example: `nano_1nanode8ngaakzbck8smq6ru9bethqwyehomf79sae1k7xd47dkidjqzffeg`
- `count` (query, optional, string) — Number of blocks (1-50) Example: `15`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nano-api/v1/history?account=nano_1nanode8ngaakzbck8smq6ru9bethqwyehomf79sae1k7xd47dkidjqzffeg&count=15"
```

**Response:**
```json
{
    "data": {
        "count": 15,
        "source": "Nano",
        "account": "nano_1nanode8ngaakzbck8smq6ru9bethqwyehomf79sae1k7xd47dkidjqzffeg",
        "history": [
            {
                "hash": "44DF0057D33D38C317A35CF9F034B9189BAE031DE032B385E3F453E5FD5ED279",
                "time": "2021-02-22T22:55:19.000Z",
                "type": "send",
                "height": 52,
                "confirmed": true,
                "amount_nano": 1,
                "counterparty": "nano_3j834c8c83qtejze6wagothgjj7oq9p1dewgbpycy7dcq1ux1tb7qspinyx5"
            },
            {
                "hash": "DBC054BDCAB0C30980A06A5F698AD4F9001607E4480B37880D53E7DDF043D962",
                "time": "2021-02-22T22:55:19.000Z",
                "type": "receive",
                "height": 51,
                "confirmed": true,
                "amount_nano": 1.3886,
                "counterparty": "nano_17oc98sqccfqqfah8jggkziu8i6ar8biq7syxqcd6e1sagje11gts88gfj95"
            },
            {
                "hash": "27358427EE3E8AE5612BA12070CBAA4FD72994ED085DDC0397CE98AFC4FBE161",
                "time": "2019-12-17T20:06:00.000Z",
                "type": "receive",
                "height": 49,
                "confirmed": true,
                "amount_nano": 0,
                "counterparty": "nano_35qbo76yw138whnqmtbascunw3ooqfa1zgofz75cw65ikxa9ibyxoz36bx8t"
            },
            {
                "hash": "A4ADA0C72F40BD51AABCA716EDE673EF70BF1E2853E3F320A1E74A73824996ED",
…(truncated, see openapi.json for full schema)
```

### Block

#### `GET /v1/block` — A single block amount, balance and confirmation

**Parameters:**
- `hash` (query, required, string) — Block hash (64 hex) Example: `44DF0057D33D38C317A35CF9F034B9189BAE031DE032B385E3F453E5FD5ED279`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nano-api/v1/block?hash=44DF0057D33D38C317A35CF9F034B9189BAE031DE032B385E3F453E5FD5ED279"
```

**Response:**
```json
{
    "data": {
        "hash": "44DF0057D33D38C317A35CF9F034B9189BAE031DE032B385E3F453E5FD5ED279",
        "link": "C4C1128CA306FA647EC2710EAE9EE8C4B5B9EC05B38E4DBCAF156AB837D06925",
        "time": "2021-02-22T22:55:19.000Z",
        "type": "state",
        "height": 52,
        "source": "Nano",
        "account": "nano_1nanode8ngaakzbck8smq6ru9bethqwyehomf79sae1k7xd47dkidjqzffeg",
        "subtype": "send",
        "confirmed": true,
        "amount_nano": 1,
        "balance_nano": 0.4370224,
        "representative": "nano_1anrzcuwe64rwxzcco8dkhpyxpi8kd7zsjc1oeimpc3ppca4mrjtwnqposrs"
    },
    "meta": {
        "timestamp": "2026-06-10T13:59:46.294Z",
        "request_id": "084776bd-4618-4e79-97ba-ad595d9adb8e"
    },
    "status": "ok",
    "message": "Block retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata and endpoint catalog

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

**Response:**
```json
{
    "data": {
        "source": "Nano RPC via a public node (rpc.nano.to, live)",
        "service": "nano-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/block": "A single block's amount, balance and confirmation (hash=64 hex).",
            "GET /v1/account": "An account's XNO balance, receivable and representative (account=nano_1nanode8ngaakzbck8smq6ru9bethqwyehomf79sae1k7xd47dkidjqzffeg).",
            "GET /v1/history": "An account's own chain of blocks (account=nano_…, count=15).",
            "GET /v1/network": "Block counts and online ORV voting weight."
        },
        "description": "Live on-chain data from the Nano network (XNO), a feeless, instant cryptocurrency with a block-lattice architecture where every account has its own blockchain and consensus is reached by Open Representative Voting (ORV), via a public Nano RPC node. The account endpoint returns an account's confirmed XNO balance, receivable balance, block count and delegated representative; the history endpoint returns an account's own chain of blocks; the block endpoint returns a single block's amount, balance, height and confirmation; the network endpoint returns the total, cemented and unchecked block counts and the online voting weight securing the network. Live, no key, nothing stored. Distinct from the Bitcoin, Stacks, EOS, Internet Computer and EVM on-chain APIs and from price feeds — this is Nano's own block-lattice account chains and ORV v
…(truncated, see openapi.json for full schema)
```


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