# Mina Protocol On-Chain API
> The Mina Protocol blockchain — the "succinct blockchain" — live from a public Mina GraphQL node, no key, nothing cached. Mina uses recursive zk-SNARKs to keep the entire chain a constant ~22 KB regardless of history, and secures itself with delegated proof-of-stake (Ouroboros Samasika). This is the first Mina reader in the marketplace. Read the live network status — the blockchain length (tip height), sync status, chain id, the current consensus epoch and slot and the total number of accounts. Read the best (tip) block with its state hash, height, epoch, the block producer who created it and the total MINA supply at that block. And look up any account by public key for its MINA balance (total and liquid), its transaction nonce and the staking delegate it has assigned its stake to. The on-chain layer for Mina wallets, explorers, stakers and analytics. Live from api.minascan.io.

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

## Pricing
- **Free** (Free) — 7,650 calls/Mo, 3 req/s
- **Starter** ($10/Mo) — 141,500 calls/Mo, 9 req/s
- **Pro** ($33/Mo) — 808,000 calls/Mo, 22 req/s
- **Business** ($89/Mo) — 5,020,000 calls/Mo, 55 req/s

## Endpoints

### Network

#### `GET /v1/block` — The best (tip) block: state hash, height, producer, total MINA supply

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

**Response:**
```json
{
    "data": {
        "note": "The best (tip) Mina block: its state hash, height, consensus epoch, the block producer who created it and the total MINA supply at this block. Mina keeps the whole chain provable in a constant ~22 KB.",
        "epoch": 49,
        "source": "Mina GraphQL",
        "state_hash": "3NKNa52LsTQiMb7eXPge1moSZQf1wVFcgDnDEC6AVybyrkNZkJBY",
        "block_height": 532834,
        "timestamp_ms": 1781456580000,
        "block_producer": "B62qmM9KDeqvu3TVpQStGJARgg7KppxE8UF3xMdtKV9TDc33kSUGug5",
        "total_supply_mina": 1290124448.8400393,
        "slot_since_genesis": 919541
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:32.100Z",
        "request_id": "8c8d274e-f804-4ca7-b46c-ae7d4bfb8770"
    },
    "status": "ok",
    "message": "Block retrieved successfully",
    "success": true
}
```

#### `GET /v1/status` — Live network status: blockchain length, sync, chain id, epoch/slot, accounts

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

**Response:**
```json
{
    "data": {
        "note": "Live Mina network status from the node daemon: the blockchain length (block height of the tip), sync status, chain id, the current consensus epoch/slot and the total number of accounts on chain.",
        "slot": 5201,
        "epoch": 49,
        "source": "Mina GraphQL",
        "chain_id": "a7351abc7ddf2ea92d1b38cc8e636c271c1dfd2c081c637f62ebc2af34eb7cc1",
        "global_slot": 355061,
        "sync_status": "SYNCED",
        "uptime_secs": 42044,
        "num_accounts": 286673,
        "blockchain_length": 532834
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:32.294Z",
        "request_id": "5ee087cc-a51a-4e5f-be6c-9074b8abb81f"
    },
    "status": "ok",
    "message": "Status retrieved successfully",
    "success": true
}
```

### Accounts

#### `GET /v1/account` — An account by public key: MINA balance, nonce, delegate

**Parameters:**
- `publicKey` (query, optional, string) — Mina public key (omit for the current block producer) Example: `B62qpge4uMq4Vv5Rvc8Gw9qSquUYd6xoW1pz7HQkMSHm6h1o7pvLPAN`

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

**Response:**
```json
{
    "data": {
        "note": "A Mina account by public key: its MINA balance (total and liquid), transaction nonce and the staking delegate it has assigned its stake to. Omit publicKey for the current block producer.",
        "nonce": 21,
        "source": "Mina GraphQL",
        "delegate": "B62qpsyB3gCndt8sNz4GRwusBtg9U72TNiL4mxmcQfWKZ5noa9fFnWr",
        "public_key": "B62qpge4uMq4Vv5Rvc8Gw9qSquUYd6xoW1pz7HQkMSHm6h1o7pvLPAN",
        "voting_for": "2mzWc7ZF8hRKvLyoLpKLZ3TSm8XSjfxZq67dphJpnjhYmU5Vja5Q",
        "liquid_mina": 4.011908569,
        "balance_mina": 4.011908569
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:32.435Z",
        "request_id": "6c258331-ce36-4a64-a7a5-17788121ae31"
    },
    "status": "ok",
    "message": "Account retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata

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

**Response:**
```json
{
    "data": {
        "sample": {
            "accounts": 286673,
            "blockchain_length": 532834
        },
        "source": "public Mina GraphQL node (api.minascan.io), keyless",
        "service": "mina-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/block": "The best (tip) block: state hash, height, producer, total MINA supply.",
            "GET /v1/status": "Live network status: blockchain length, sync, chain id, epoch/slot, accounts.",
            "GET /v1/account": "An account by public key: MINA balance, nonce, delegate (publicKey; omit for the block producer)."
        },
        "description": "Read the Mina Protocol blockchain live from a public Mina GraphQL node: the live network status (blockchain length, sync status, chain id, epoch/slot, account count), the best (tip) block (state hash, height, producer, total MINA supply) and any account by public key (MINA balance, nonce, staking delegate). The on-chain layer for Mina wallets, explorers and stakers. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:32.495Z",
        "request_id": "19c32d78-316a-42e6-80b2-e41ce760edec"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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