# Algorand (ALGO) On-Chain API
> Live on-chain data from the Algorand blockchain (ALGO), a fast carbon-negative pure-proof-of-stake Layer 1, served straight from the public AlgoNode indexer and algod APIs — no key, nothing cached. The account endpoint returns any address's state: its ALGO balance, participation status (online/offline for staking), pending rewards, the Algorand Standard Assets (ASAs) it holds with their amounts, and how many apps it has created. The asset endpoint returns the on-chain registry entry for any ASA — its name, unit, decimals, total supply, creator and URL, so you can resolve USDC, USDt and thousands of tokens. The transactions endpoint returns the account's most recent transactions with the type, counterparty, amount, fee, round and time. The network endpoint returns the live chain state: the last round, the round time, and the total and online ALGO supply. Everything is read live from AlgoNode, nothing stored. This is the Algorand on-chain layer for any wallet, explorer, payments, DeFi or analytics app. Distinct from the XRP Ledger, Stellar, TRON, Aptos, EVM and Solana on-chain APIs and from price feeds — this is Algorand account state, ASA holdings, asset registry, transactions and ledger health. 4 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/algorand-api/..."
```

## Pricing
- **Free** (Free) — 3,500 calls/Mo, 5 req/s
- **Starter** ($11/Mo) — 90,000 calls/Mo, 12 req/s
- **Pro** ($30/Mo) — 560,000 calls/Mo, 30 req/s
- **Mega** ($73/Mo) — 3,200,000 calls/Mo, 80 req/s

## Endpoints

### Algorand

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

**Parameters:**
- `address` (query, required, string) — Algorand address (58-char) Example: `I3345FUQQ2GRBHFZQPLYQQX5HJMMRZMABCHRLWV6RCJYC6OO4MOLEUBEGU`

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

**Response:**
```json
{
    "data": {
        "round": 61998372,
        "assets": [],
        "source": "Algorand (AlgoNode)",
        "status": "Offline",
        "address": "I3345FUQQ2GRBHFZQPLYQQX5HJMMRZMABCHRLWV6RCJYC6OO4MOLEUBEGU",
        "asset_count": 0,
        "algo_balance": 1.124243,
        "created_apps": 0,
        "created_assets": 0,
        "total_rewards_algo": 9958544.285694,
        "pending_rewards_algo": 0
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:49.784Z",
        "request_id": "00c70c16-75bf-48d7-936c-d5450e10b110"
    },
    "status": "ok",
    "message": "Account retrieved successfully",
    "success": true
}
```

#### `GET /v1/asset` — An ASA registry entry

**Parameters:**
- `id` (query, required, string) — Algorand Standard Asset id Example: `31566704`

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

**Response:**
```json
{
    "data": {
        "url": "https://www.centre.io/usdc",
        "name": "USDC",
        "round": 61998372,
        "total": "18446744073709552000",
        "source": "Algorand (AlgoNode)",
        "creator": "2UEQTE5QDNXPI7M3TU44G6SYKLFWLPQO7EBZM7K7MHMQQMFI4QJPLHQFHM",
        "deleted": false,
        "asset_id": 31566704,
        "decimals": 6,
        "unit_name": "USDC"
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:49.979Z",
        "request_id": "c516c6e9-91d6-4fea-8e85-ee2516d80fe0"
    },
    "status": "ok",
    "message": "Asset retrieved successfully",
    "success": true
}
```

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

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

**Response:**
```json
{
    "data": {
        "source": "Algorand (AlgoNode)",
        "last_round": 61998372,
        "total_algo": 9685339464.889338,
        "online_algo": 2045822890.982087,
        "catchup_time": 0,
        "supply_round": 61998372,
        "time_since_last_round_ns": 1865735767
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:50.188Z",
        "request_id": "d318caac-97c5-4f7c-8498-6093511576f0"
    },
    "status": "ok",
    "message": "Network state retrieved successfully",
    "success": true
}
```

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

**Parameters:**
- `address` (query, required, string) — Algorand address (58-char) Example: `I3345FUQQ2GRBHFZQPLYQQX5HJMMRZMABCHRLWV6RCJYC6OO4MOLEUBEGU`
- `limit` (query, optional, string) — Max transactions (1-100, default 20) Example: `10`

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

**Response:**
```json
{
    "data": {
        "next": "hYj-AAAAAAAAAAAA",
        "count": 10,
        "source": "Algorand (AlgoNode)",
        "address": "I3345FUQQ2GRBHFZQPLYQQX5HJMMRZMABCHRLWV6RCJYC6OO4MOLEUBEGU",
        "transactions": [
            {
                "id": "FO56QOEKZM7LV3PBJ2XBJLBSDLZEVWBGE2I2BGJTY2YE4JUEJCBQ",
                "time": "2024-09-27T00:04:58.000Z",
                "type": "pay",
                "round": 42909356,
                "amount": 1.0e-6,
                "sender": "ALGKES67FIYKFNH5NPIWEO6BCAHHZ4DUSTOZHFERKLXDFR6UTVPMU52C5I",
                "asset_id": null,
                "fee_algo": 0.001,
                "receiver": "I3345FUQQ2GRBHFZQPLYQQX5HJMMRZMABCHRLWV6RCJYC6OO4MOLEUBEGU"
            },
            {
                "id": "HTI73MT2OLS35BO6NE32MBTR2QLS4IRHTCVDZIVQH3PHX3WLQG4Q",
                "time": "2024-09-26T14:00:14.000Z",
                "type": "pay",
                "round": 42896669,
                "amount": 1.0e-6,
                "sender": "M4EPDR7J25WF7IIXOB5OWSUTHPOGCT3526W72X5HR7UW3BVGSURZ2FNJRE",
                "asset_id": null,
                "fee_algo": 0.001,
                "receiver": "I3345FUQQ2GRBHFZQPLYQQX5HJMMRZMABCHRLWV6RCJYC6OO4MOLEUBEGU"
            },
            {
                "id": "K7C6MR4O4QTSTBG3N2EECPPASY34HD23UBO2VNZEMRFG7URPBMBQ",
                "time": "2022-11-08T17:52:55.000Z",
                "type": "pay",
                "round": 24709306,
                "amount": 0.26971,
                "sender"
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "source": "AlgoNode public APIs — indexer + algod (live)",
        "service": "algorand-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/asset": "An ASA's registry entry (id=31566704 for USDC).",
            "GET /v1/account": "An address's state + ASA holdings (address=I3345FUQQ2GRBHFZQPLYQQX5HJMMRZMABCHRLWV6RCJYC6OO4MOLEUBEGU).",
            "GET /v1/network": "Live Algorand chain state: last round, round time, ALGO supply.",
            "GET /v1/transactions": "An address's recent transactions (address=, limit)."
        },
        "last_round": 61998372,
        "description": "Live on-chain data from the Algorand blockchain (ALGO) via the public AlgoNode indexer and algod APIs: any address's state (ALGO balance, online/offline staking status, rewards, the ASAs it holds, app counts); the on-chain registry entry for any Algorand Standard Asset (name, unit, decimals, total supply, creator, URL); the account's recent transactions (type, counterparty, amount, fee, round, time); and the live network state (last round, round time, total and online ALGO supply). Live, no key, nothing stored. Distinct from the XRP Ledger, Stellar, TRON, Aptos, EVM and Solana on-chain APIs and from price feeds — this is Algorand account state, ASA holdings, asset registry, transactions and ledger health.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:50.562Z",
        "request_
…(truncated, see openapi.json for full schema)
```


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