# Zilliqa API
> Live on-chain data from the Zilliqa network (ZIL), one of the first sharded public blockchains with a dual-block architecture (transaction blocks carry transfers, directory-service blocks coordinate the shards): the live chain state (number of TX and DS blocks, current TX and DS epochs, block rates, number of shards, minimum gas price), an address's ZIL balance and nonce, a transaction block's number, time, transaction count, gas and DS block, and a transaction's amount, gas, sender, recipient and receipt.

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

## Pricing
- **Free** (Free) — 9,000 calls/Mo, 3 req/s
- **Basic** ($8/Mo) — 136,000 calls/Mo, 8 req/s
- **Pro** ($23/Mo) — 884,000 calls/Mo, 15 req/s
- **Scale** ($54/Mo) — 4,620,000 calls/Mo, 30 req/s

## Endpoints

### Network

#### `GET /v1/network` — Live sharded chain state: TX/DS blocks, epochs, shards, gas

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

**Response:**
```json
{
    "data": {
        "chain": "zilliqa",
        "source": "Zilliqa",
        "num_peers": 87,
        "num_shards": 1,
        "native_token": "ZIL",
        "ds_block_rate": 0.0058,
        "num_ds_blocks": 286505,
        "num_tx_blocks": 28650494,
        "tx_block_rate": 0.58,
        "current_ds_epoch": 286505,
        "current_tx_epoch": 28650494,
        "num_transactions": 0,
        "transaction_rate": 0,
        "min_gas_price_zil": 0.002
    },
    "meta": {
        "timestamp": "2026-06-10T13:59:57.352Z",
        "request_id": "caf5e336-514a-47b8-8fcf-0c967afd1111"
    },
    "status": "ok",
    "message": "Network state retrieved successfully",
    "success": true
}
```

### Account

#### `GET /v1/account` — An address ZIL balance and nonce

**Parameters:**
- `address` (query, required, string) — Zilliqa base16 address (40 hex) Example: `43e6a5c00e25d7e37530db5005086e72fd398a9d`

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

**Response:**
```json
{
    "data": {
        "nonce": 201318,
        "exists": true,
        "source": "Zilliqa",
        "address": "43e6a5c00e25d7e37530db5005086e72fd398a9d",
        "balance_zil": 82533750.83995956
    },
    "meta": {
        "timestamp": "2026-06-10T13:59:57.792Z",
        "request_id": "f1aa8723-a631-4a1d-a1f2-0a26034132ab"
    },
    "status": "ok",
    "message": "Account retrieved successfully",
    "success": true
}
```

### Block

#### `GET /v1/txblock` — A transaction block number, time, txns, gas and DS block

**Parameters:**
- `number` (query, optional, string) — TX block number or latest Example: `latest`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/zilliqa-api/v1/txblock?number=latest"
```

**Response:**
```json
{
    "data": {
        "source": "Zilliqa",
        "gas_used": 0,
        "block_num": 28650496,
        "gas_limit": 200000,
        "timestamp": "2026-06-10T13:59:53.872Z",
        "block_hash": "2f5e77392b57fa1c2b58403f6363080d701721b784876c6f6f882f9e73df52a3",
        "rewards_zil": 0,
        "tx_fees_zil": 0,
        "ds_block_num": 286505,
        "prev_block_hash": "b0b2f9fd5a10a42a24f7e33f34b6b96309d7b7fbe823968be6f84a4a2083728f",
        "num_micro_blocks": 0,
        "num_transactions": 0
    },
    "meta": {
        "timestamp": "2026-06-10T13:59:58.223Z",
        "request_id": "77b32fc8-00b6-45a4-825a-ae8c98ac3b51"
    },
    "status": "ok",
    "message": "Transaction block retrieved successfully",
    "success": true
}
```

### Transaction

#### `GET /v1/transaction` — A transaction amount, gas, sender, recipient and receipt

**Parameters:**
- `hash` (query, required, string) — Transaction hash (64 hex) Example: `814a408c40e0694cf32d55caa7fa978555ef91f03b65c4e60c6a2ab51459a672`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/zilliqa-api/v1/transaction?hash=814a408c40e0694cf32d55caa7fa978555ef91f03b65c4e60c6a2ab51459a672"
```

**Response:**
```json
{
    "data": {
        "hash": "814a408c40e0694cf32d55caa7fa978555ef91f03b65c4e60c6a2ab51459a672",
        "nonce": 173462,
        "source": "Zilliqa",
        "success": true,
        "epoch_num": 8000000,
        "gas_limit": 50,
        "amount_zil": 16743.8,
        "to_address": "8ec8e69ddfee14b0695301069e1a3c77afee98ee",
        "gas_price_zil": 0.003,
        "cumulative_gas": 50,
        "sender_pub_key": "0x03418612da4ea914d985a234285ac3b2bee7f0986ef1440895d330f1b1beab813e"
    },
    "meta": {
        "timestamp": "2026-06-10T13:59:58.657Z",
        "request_id": "92f907e6-0df3-4442-bfec-eb0b19bebd04"
    },
    "status": "ok",
    "message": "Transaction 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/zilliqa-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Zilliqa JSON-RPC API via a public node (api.zilliqa.com, live)",
        "service": "zilliqa-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/account": "An address's ZIL balance and nonce (address=43e6a5c00e25d7e37530db5005086e72fd398a9d).",
            "GET /v1/network": "Live sharded chain state: TX/DS blocks, epochs, shards, gas price.",
            "GET /v1/txblock": "A transaction block's number, time, txns, gas and DS block (number=latest|N).",
            "GET /v1/transaction": "A transaction's amount, gas, sender, recipient and receipt (hash=64 hex)."
        },
        "description": "Live on-chain data from the Zilliqa network (ZIL), one of the first sharded public blockchains with a dual-block architecture (transaction blocks carry transfers, directory-service blocks coordinate the shards), via a public Zilliqa node. The network endpoint returns the number of TX and DS blocks, current TX and DS epochs, block rates, number of shards and minimum gas price; the account endpoint returns an address's ZIL balance and nonce; the txblock endpoint returns a transaction block's number, time, transaction count, gas and DS block; the transaction endpoint returns a transaction's amount, gas, sender, recipient and receipt. Live, no key, nothing stored. Distinct from the Bitcoin, Stacks, Celestia, EOS, Filecoin and EVM on-chain APIs and from price feeds — this is Zilliqa's own ZIL account state, d
…(truncated, see openapi.json for full schema)
```


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