# Hedera API
> Live on-chain data from the Hedera network (HBAR), the enterprise public ledger built on hashgraph consensus, via the public Hedera Mirror Node. Hedera identifies every account, token and contract by a shard.realm.num id like 0.0.2 — not a hash address — and this API speaks that native form. Resolve an account's whole state: HBAR balance, the node or account it stakes to, whether it declines rewards and its pending reward, its auto-renew and token-association settings, memo and EVM nonce. Get the HTS tokens an account holds, each decimal-adjusted with token id and freeze/KYC status. Read any HTS token's details — name, symbol, decimals, total and max supply, treasury account and whether it's a fungible token or an NFT collection. Get the live HBAR supply, released and total. Live, no key, nothing stored. Distinct from the XRP Ledger, Stellar, TRON, Aptos, Algorand, Tezos, Cardano, Solana and EVM on-chain APIs and from price feeds — this is Hedera account state, staking, HTS-token holdings, token details and HBAR supply. Perfect for wallets, explorers, treasury, HTS-token and analytics apps.

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

## Pricing
- **Free** (Free) — 6,000 calls/Mo, 2 req/s
- **Starter** ($13/Mo) — 130,000 calls/Mo, 5 req/s
- **Pro** ($39/Mo) — 820,000 calls/Mo, 15 req/s
- **Business** ($86/Mo) — 4,500,000 calls/Mo, 40 req/s

## Endpoints

### Account

#### `GET /v1/account` — Account state + staking

**Parameters:**
- `id` (query, required, string) — Hedera account id (shard.realm.num) Example: `0.0.2`

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

**Response:**
```json
{
    "data": {
        "memo": null,
        "source": "Hedera (Mirror Node)",
        "account": "0.0.2",
        "deleted": false,
        "token_count": 0,
        "hbar_balance": 16630126.37744658,
        "ethereum_nonce": 0,
        "staked_node_id": null,
        "declines_reward": false,
        "auto_renew_period": 7000000,
        "created_timestamp": "1605733260.898372007",
        "staked_account_id": null,
        "pending_reward_hbar": 0,
        "max_auto_token_associations": 0
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:30.498Z",
        "request_id": "f7ce0b98-a611-48ec-b935-44c170196080"
    },
    "status": "ok",
    "message": "Account retrieved successfully",
    "success": true
}
```

#### `GET /v1/tokens` — HTS tokens an account holds

**Parameters:**
- `id` (query, required, string) — Hedera account id Example: `0.0.439909`
- `limit` (query, optional, string) — Max 1-100 Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hedera-api/v1/tokens?id=0.0.439909&limit=25"
```

**Response:**
```json
{
    "data": {
        "source": "Hedera (Mirror Node)",
        "tokens": [
            {
                "balance": 137.128112,
                "decimals": 6,
                "token_id": "0.0.456858",
                "kyc_status": "NOT_APPLICABLE",
                "raw_balance": 137128112,
                "freeze_status": "UNFROZEN",
                "auto_associated": false
            }
        ],
        "account": "0.0.439909",
        "token_count": 1
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:30.648Z",
        "request_id": "986dc12f-8338-4dbd-bd80-615cb44edc4e"
    },
    "status": "ok",
    "message": "Tokens retrieved successfully",
    "success": true
}
```

### Token

#### `GET /v1/token` — HTS token details

**Parameters:**
- `id` (query, required, string) — Hedera token id Example: `0.0.456858`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hedera-api/v1/token?id=0.0.456858"
```

**Response:**
```json
{
    "data": {
        "name": "USD Coin",
        "type": "FUNGIBLE_COMMON",
        "paused": false,
        "source": "Hedera (Mirror Node)",
        "symbol": "USDC",
        "decimals": 6,
        "token_id": "0.0.456858",
        "max_supply": null,
        "total_supply": 450010110,
        "created_timestamp": "1632175205.445296000",
        "treasury_account_id": "0.0.439909"
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:30.783Z",
        "request_id": "35fef966-19d1-429b-83d2-7acdbb9b9c60"
    },
    "status": "ok",
    "message": "Token retrieved successfully",
    "success": true
}
```

### Network

#### `GET /v1/network` — Live HBAR supply

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

**Response:**
```json
{
    "data": {
        "source": "Hedera (Mirror Node)",
        "timestamp": "1781035276.242519677",
        "total_supply_hbar": 50000000000,
        "released_supply_hbar": 43373517400.492935
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:30.903Z",
        "request_id": "0818569a-7320-44a1-a7ae-b302da499967"
    },
    "status": "ok",
    "message": "Network state retrieved successfully",
    "success": true
}
```


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