# Liquid Network On-Chain API
> The Liquid Network — Bitcoin's confidential sidechain — live from the public Blockstream esplora API, no key, nothing cached. Liquid is a federated Bitcoin sidechain with one-minute blocks, confidential transactions and issued assets (Tether's USDt and many others live here as Liquid assets), with L-BTC pegged one-to-one to Bitcoin. This is the first Liquid reader in the marketplace. Read the live network status — the chain tip block height and the current mempool, with the count of unconfirmed transactions, their total virtual size and total fees. Read any block by height, or the current tip, with its hash, previous block, timestamp, transaction count, size and weight. And read the live fee estimates in sat/vB keyed by the number of blocks you are willing to wait. The on-chain layer for Liquid wallets, asset issuers, explorers and analytics. Live from blockstream.info.

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

## Pricing
- **Free** (Free) — 7,050 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 137,500 calls/Mo, 9 req/s
- **Pro** ($35/Mo) — 793,000 calls/Mo, 22 req/s
- **Business** ($93/Mo) — 5,080,000 calls/Mo, 55 req/s

## Endpoints

### Network

#### `GET /v1/block` — A block by height: hash, timestamp, tx count, size, weight

**Parameters:**
- `height` (query, optional, string) — Block height (omit for the current tip) Example: `3000000`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/liquid-api/v1/block?height=3000000"
```

**Response:**
```json
{
    "data": {
        "id": "75abdf85fa4e465cb9d9dabed728583f291a8123f50c6d99f71894f22da7e648",
        "note": "A Liquid block by height: its hash, previous block, timestamp, transaction count, size and weight. Omit height for the current tip block.",
        "size": 1776,
        "height": 3000000,
        "source": "Blockstream esplora (Liquid)",
        "weight": 6975,
        "tx_count": 1,
        "timestamp": 1724373428,
        "median_time": 1724373127,
        "previous_block": "14e50221a4a7b796f0d29a8219549d9d6687d51bd2aa9b7abeb8b42443bb6dd1"
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:30.004Z",
        "request_id": "3e3900f0-9294-4991-bc4a-a415ae8dda28"
    },
    "status": "ok",
    "message": "Block retrieved successfully",
    "success": true
}
```

#### `GET /v1/info` — Live network status: tip height and the current mempool

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

**Response:**
```json
{
    "data": {
        "note": "Live Liquid Network status: the chain tip block height and the current mempool — the number of unconfirmed transactions, their total virtual size and total fees. Liquid produces a block roughly every minute.",
        "source": "Blockstream esplora (Liquid)",
        "tip_height": 3929588,
        "mempool_vsize": 18062,
        "mempool_tx_count": 1,
        "mempool_total_fee": 119
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:30.611Z",
        "request_id": "3d023196-7464-43a1-9e66-c8832f37f4d5"
    },
    "status": "ok",
    "message": "Info retrieved successfully",
    "success": true
}
```

### Fees

#### `GET /v1/fees` — Live fee estimates in sat/vB by confirmation target

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

**Response:**
```json
{
    "data": {
        "note": "Live Liquid fee estimates in sat/vB, keyed by the number of blocks you are willing to wait. fastest_1_block confirms in the next block (~1 minute on Liquid).",
        "unit": "sat/vB",
        "source": "Blockstream esplora (Liquid)",
        "estimates": {
            "target_1_blocks": 0.1,
            "target_2_blocks": 0.1,
            "target_3_blocks": 0.1,
            "target_6_blocks": 0.1,
            "target_10_blocks": 0.1,
            "target_25_blocks": 0.1,
            "target_144_blocks": 0.1,
            "target_504_blocks": 0.1,
            "target_1008_blocks": 0.1
        },
        "hour_6_blocks": 0.1,
        "fastest_1_block": 0.1,
        "half_hour_3_blocks": 0.1
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:30.955Z",
        "request_id": "92362cf7-fe54-4616-bad9-0e800b407c1b"
    },
    "status": "ok",
    "message": "Fees retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "sample": {
            "mempool_tx": 1,
            "tip_height": 3929588
        },
        "source": "public Blockstream esplora API (blockstream.info/liquid/api), keyless",
        "service": "liquid-api",
        "endpoints": {
            "GET /v1/fees": "Live fee estimates in sat/vB by confirmation target.",
            "GET /v1/info": "Live network status: tip height and the current mempool (count, vsize, fees).",
            "GET /v1/meta": "This document.",
            "GET /v1/block": "A block by height: hash, timestamp, tx count, size, weight (height; omit for tip)."
        },
        "description": "Read the Liquid Network (Bitcoin's confidential sidechain) live from the public Blockstream esplora API: the live network status (tip height, mempool count/vsize/fees), any block by height (or the tip) with its hash, timestamp, transaction count, size and weight, and the live fee estimates by confirmation target. The on-chain layer for Liquid wallets, asset issuers and explorers. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:31.041Z",
        "request_id": "9e31624f-3473-407c-b6d1-106745401068"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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