# Cardano API
> Live on-chain data from the Cardano blockchain (ADA) via the public Koios indexer. Resolve a stake account's whole state — total ADA controlled, UTxO balance, the stake pool it delegates to, its DRep governance vote, lifetime and withdrawable staking rewards, and registration status. Fetch the native tokens and NFTs a stake account holds, with policy id, decoded asset name, fingerprint and decimal-adjusted quantity. Read a stake pool's live economics — ticker, active and live stake, live saturation, margin, fixed cost, pledge, blocks minted and delegator count. Get the live chain tip and current-epoch active stake, transaction count and fees. Live, no key, nothing stored. Distinct from the XRP Ledger, Stellar, TRON, Aptos, Algorand, Tezos, EVM and Solana on-chain APIs and from price feeds — this is Cardano stake-account state, delegation, native-asset holdings, stake-pool economics and epoch health. Perfect for wallets, explorers, staking dashboards, delegation tools, NFT 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/cardano-api/..."
```

## Pricing
- **Free** (Free) — 6,000 calls/Mo, 2 req/s
- **Starter** ($12/Mo) — 140,000 calls/Mo, 5 req/s
- **Pro** ($36/Mo) — 880,000 calls/Mo, 15 req/s
- **Business** ($84/Mo) — 4,700,000 calls/Mo, 40 req/s

## Endpoints

### Account

#### `GET /v1/account` — Stake account state + delegation

**Parameters:**
- `address` (query, required, string) — Cardano stake address (stake1…) Example: `stake1uyx0ut5wc5nmu0tacjc9pyyahdyq5ujghwljkdxrpfw5vecnyn4gg`

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

**Response:**
```json
{
    "data": {
        "source": "Cardano (Koios)",
        "status": "registered",
        "deposit_ada": 2,
        "stake_address": "stake1uyx0ut5wc5nmu0tacjc9pyyahdyq5ujghwljkdxrpfw5vecnyn4gg",
        "delegated_drep": "drep_always_abstain",
        "delegated_pool": "pool1fl20ddkpvnstlx63fal6e3ku46r76nk2s4mqtk5jnyxn2vt7hg6",
        "withdrawals_ada": 68992.703144,
        "utxo_balance_ada": 451044.763493,
        "total_balance_ada": 459732.355168,
        "rewards_lifetime_ada": 77616.319214,
        "rewards_available_ada": 8687.591675
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:36.041Z",
        "request_id": "fbc7381e-da62-4545-b4c4-ab400051a9e8"
    },
    "status": "ok",
    "message": "Account retrieved successfully",
    "success": true
}
```

#### `GET /v1/assets` — Native tokens and NFTs held

**Parameters:**
- `address` (query, required, string) — Cardano stake address (stake1…) Example: `stake1uyx0ut5wc5nmu0tacjc9pyyahdyq5ujghwljkdxrpfw5vecnyn4gg`
- `limit` (query, optional, string) — Max 1-200 Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cardano-api/v1/assets?address=stake1uyx0ut5wc5nmu0tacjc9pyyahdyq5ujghwljkdxrpfw5vecnyn4gg&limit=20"
```

**Response:**
```json
{
    "data": {
        "assets": [
            {
                "decimals": 0,
                "quantity": 1,
                "policy_id": "1f0da9edafc57ae7a44c8864f217475e102fc8af68eb3a93eeee059b",
                "asset_name": "HOSKYMINTKEY",
                "fingerprint": "asset1twflravh4y3fksuuexg36yl0mzyd79emlmxq34",
                "asset_name_hex": "484f534b594d494e544b4559"
            },
            {
                "decimals": 0,
                "quantity": 1,
                "policy_id": "41142faeb5e3c644625966715c0a844bb4d6aeef2bcdbf535b14e5a5",
                "asset_name": "tHANDLE",
                "fingerprint": "asset1fuwwjcwk008vpcp8ecjw7akxn4lx09sg6lstlx",
                "asset_name_hex": "7448414e444c45"
            },
            {
                "decimals": 6,
                "quantity": 6618.80938,
                "policy_id": "869fc72c11977e4be3e8e1cc63cca008a925886332795c9601f965ca",
                "asset_name": "USDC",
                "fingerprint": "asset18f7zn35vthuh24ed4y6ucvmheur2wggcdfwj29",
                "asset_name_hex": "55534443"
            },
            {
                "decimals": 0,
                "quantity": 1,
                "policy_id": "937884dda04d3dd3616fa447c7fb396e5943d19000ccf4f142320203",
                "asset_name": "ShenRewardTicket2401",
                "fingerprint": "asset1u3p0k7p4hfd5m8l8xyye6rvl8m88vked2sjwzt",
                "asset_name_hex": "5368656e5265776172645469636b657432343031"
            },
      
…(truncated, see openapi.json for full schema)
```

### Pool

#### `GET /v1/pool` — Stake pool live economics

**Parameters:**
- `pool` (query, required, string) — Stake pool id (pool1…) Example: `pool1fl20ddkpvnstlx63fal6e3ku46r76nk2s4mqtk5jnyxn2vt7hg6`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cardano-api/v1/pool?pool=pool1fl20ddkpvnstlx63fal6e3ku46r76nk2s4mqtk5jnyxn2vt7hg6"
```

**Response:**
```json
{
    "data": {
        "name": "Kind Orange Heisenberg",
        "source": "Cardano (Koios)",
        "status": "registered",
        "ticker": "KOH",
        "pool_id": "pool1fl20ddkpvnstlx63fal6e3ku46r76nk2s4mqtk5jnyxn2vt7hg6",
        "homepage": null,
        "margin_pct": 5,
        "pledge_ada": 0,
        "blocks_minted": 19196,
        "fixed_cost_ada": 340,
        "live_stake_ada": 70517481.757637,
        "reward_address": "stake1uxyv6prv3gcvpw73udgdwuqqnh7gn6y7dfw3q9n0gjl82rq9n5mf4",
        "live_delegators": 10,
        "live_pledge_ada": 0,
        "active_stake_ada": 70536005.404329,
        "live_saturation_pct": 91.15
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:37.767Z",
        "request_id": "55a23fb3-18df-4bbc-b594-f4bb92bddc16"
    },
    "status": "ok",
    "message": "Pool retrieved successfully",
    "success": true
}
```

### Network

#### `GET /v1/network` — Live chain state + epoch

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

**Response:**
```json
{
    "data": {
        "era": "Conway",
        "epoch": 636,
        "source": "Cardano (Koios)",
        "abs_slot": 189470360,
        "block_hash": "68b957cb76fe8738bd072daafa9f3c060642f08b0e16d7e93c098e036b3d7cd6",
        "block_time": "2026-06-09T20:24:11.000Z",
        "block_height": 13528981,
        "epoch_fees_ada": 125707.584202,
        "epoch_tx_count": 25503,
        "epoch_block_count": 3929,
        "epoch_active_stake_ada": 21726240807.056576
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:38.296Z",
        "request_id": "4bf7d25e-7e07-425d-8741-1fe15a6ac6cf"
    },
    "status": "ok",
    "message": "Network state retrieved successfully",
    "success": true
}
```


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