# EOS API
> Live on-chain data from the EOS network (EOS), a delegated-proof-of-stake blockchain with a distinctive resource model where accounts stake EOS for CPU and network bandwidth and buy RAM for state: an account's liquid EOS balance, EOS staked for CPU and network, RAM quota and usage and live resource limits; the block producers ranked by DPoS vote weight; the live chain head, last irreversible block and current producer; and any account's balance of any EOS token.

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

## Pricing
- **Free** (Free) — 9,000 calls/Mo, 3 req/s
- **Basic** ($8/Mo) — 138,000 calls/Mo, 8 req/s
- **Pro** ($22/Mo) — 888,000 calls/Mo, 15 req/s
- **Scale** ($56/Mo) — 4,640,000 calls/Mo, 30 req/s

## Endpoints

### Network

#### `GET /v1/info` — Live EOS chain head, irreversible block and producer

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

**Response:**
```json
{
    "data": {
        "chain": "eos",
        "source": "EOS",
        "chain_id": "aca376f206b8fc25a6ed44dbdc66547c36c6c33e3a119ffbeaef943642f0e906",
        "consensus": "DPoS",
        "native_token": "EOS",
        "head_block_num": 503585207,
        "server_version": "v1.0.5",
        "head_block_time": "2026-06-10T14:00:01.000",
        "head_block_producer": "newdex.bp",
        "last_irreversible_block_num": 503585205
    },
    "meta": {
        "timestamp": "2026-06-10T14:00:01.324Z",
        "request_id": "f0630261-633b-4b7d-bce7-65264d021685"
    },
    "status": "ok",
    "message": "Info retrieved successfully",
    "success": true
}
```

### Account

#### `GET /v1/account` — An account balance, staked CPU/NET, RAM and resource limits

**Parameters:**
- `name` (query, required, string) — EOS account name Example: `binancecleos`

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

**Response:**
```json
{
    "data": {
        "voter": {
            "proxy": null,
            "is_proxy": false,
            "staked_eos": 0.8,
            "producers_voted": 0
        },
        "source": "EOS",
        "account": "binancecleos",
        "created": "2018-06-29T08:01:48.000",
        "permissions": [
            "active",
            "owner"
        ],
        "cpu_limit_us": {
            "max": 36176,
            "unit": "microseconds",
            "used": 147,
            "available": 36029
        },
        "ram_used_pct": 33.32,
        "cpu_staked_eos": 40058.1,
        "net_staked_eos": 4010.6,
        "net_limit_bytes": {
            "max": 75970154,
            "unit": "bytes",
            "used": 129,
            "available": 75970025
        },
        "ram_quota_bytes": 182938,
        "ram_usage_bytes": 60955,
        "liquid_balance_eos": 0.2628
    },
    "meta": {
        "timestamp": "2026-06-10T14:00:01.656Z",
        "request_id": "b3d4ff78-317e-4dfb-84b2-9a5ec9a62417"
    },
    "status": "ok",
    "message": "Account retrieved successfully",
    "success": true
}
```

### Producers

#### `GET /v1/producers` — Block producers ranked by DPoS vote weight

**Parameters:**
- `limit` (query, optional, string) — Number of producers (1-100) Example: `21`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/eos-api/v1/producers?limit=21"
```

**Response:**
```json
{
    "data": {
        "count": 21,
        "source": "EOS",
        "producers": [
            {
                "url": "https://eosusa.io/bp/eos/",
                "name": "ivote4eosusa",
                "rank": 1,
                "location": 840,
                "vote_pct": 4.1754,
                "is_active": true,
                "total_votes": 3.626668481694804e+20,
                "unpaid_blocks": 1752
            },
            {
                "url": "https://www.eosphere.io",
                "name": "eosphereiobp",
                "rank": 2,
                "location": 36,
                "vote_pct": 4.1533,
                "is_active": true,
                "total_votes": 3.6074867295984733e+20,
                "unpaid_blocks": 4932
            },
            {
                "url": "https://eossupport.io",
                "name": "eossupportbp",
                "rank": 3,
                "location": 840,
                "vote_pct": 4.0932,
                "is_active": true,
                "total_votes": 3.5553495559334114e+20,
                "unpaid_blocks": 4152
            },
            {
                "url": "https://eostitan.com",
                "name": "eostitanprod",
                "rank": 4,
                "location": 0,
                "vote_pct": 4.074,
                "is_active": true,
                "total_votes": 3.538668935977051e+20,
                "unpaid_blocks": 2098
            },
            {
                "url": "https://eos.bi
…(truncated, see openapi.json for full schema)
```

### Token

#### `GET /v1/token` — An account balance of any EOS token

**Parameters:**
- `name` (query, required, string) — EOS account name Example: `binancecleos`
- `symbol` (query, optional, string) — Token symbol Example: `EOS`
- `contract` (query, optional, string) — Token contract account Example: `eosio.token`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/eos-api/v1/token?name=binancecleos&symbol=EOS&contract=eosio.token"
```

**Response:**
```json
{
    "data": {
        "source": "EOS",
        "symbol": "EOS",
        "account": "binancecleos",
        "balance": 0.2628,
        "contract": "eosio.token",
        "holds_token": true
    },
    "meta": {
        "timestamp": "2026-06-10T14:00:03.212Z",
        "request_id": "0341c72c-9893-40cc-b788-d9dbaf97035f"
    },
    "status": "ok",
    "message": "Token balance 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/eos-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "EOS chain API via a public node (eos.greymass.com, live)",
        "service": "eos-api",
        "endpoints": {
            "GET /v1/info": "Live chain head, irreversible block and current producer.",
            "GET /v1/meta": "This document.",
            "GET /v1/token": "An account's balance of any EOS token (name=binancecleos, symbol=EOS, contract=eosio.token).",
            "GET /v1/account": "An account's balance, staked CPU/NET, RAM and resource limits (name=binancecleos).",
            "GET /v1/producers": "Block producers ranked by DPoS vote weight (limit=21)."
        },
        "description": "Live on-chain data from the EOS network (EOS), a delegated-proof-of-stake blockchain with a resource model where accounts stake EOS for CPU and network bandwidth and buy RAM for state, via a public EOS node. The account endpoint returns an account's liquid EOS balance, EOS staked for CPU and network, RAM quota and usage and live resource limits; the producers endpoint returns the block producers ranked by DPoS vote weight; the info endpoint returns the head and last irreversible block and current producer; the token endpoint returns an account's balance of any EOS token. Live, no key, nothing stored. Distinct from the Bitcoin, Stacks, Celestia, Filecoin and EVM on-chain APIs and from price feeds — this is EOS's own account state, CPU/NET/RAM resource model and DPoS block-producer set.",
        "head_block_num": 503585211,
        "upstr
…(truncated, see openapi.json for full schema)
```


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