# Independent Reserve Exchange API
> Live order-book exchange data from Independent Reserve, the regulated Australian / New Zealand crypto venue, over its public API — no key, nothing stored. This is the regional venue view for the AUD, USD, NZD and SGD order books: Australasian and Singapore on-exchange price discovery, distinct from the global-aggregate and the other regional-exchange APIs in the catalogue. The ticker endpoint returns a pair market summary — last traded price, 24h high/low, day volume, the live best bid and offer and the implied spread. The orderbook endpoint returns the live limit-order book — top bids and asks with cumulative depth and the bid/ask spread — so you can read on-venue liquidity. The trades endpoint returns the most recent executed trades. The history endpoint returns the hourly trade-history summary for the last N hours (per-hour open/high/low/close, volume and trade count). The markets endpoint lists every supported coin and the four fiat quote currencies. Forty-one cryptos (BTC, ETH, SOL, XRP and more) quoted against AUD, USD, NZD and SGD, updated live. Currency codes are case-insensitive and BTC is accepted either as btc or its upstream code xbt.

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

## Pricing
- **Free** (Free) — 14,000 calls/Mo, 3 req/s
- **Starter** ($8/Mo) — 210,000 calls/Mo, 10 req/s
- **Pro** ($25/Mo) — 930,000 calls/Mo, 28 req/s
- **Scale** ($58/Mo) — 3,400,000 calls/Mo, 60 req/s

## Endpoints

### Ticker

#### `GET /v1/ticker` — Pair market summary

**Parameters:**
- `coin` (query, required, string) — Coin (btc, eth, sol, xrp…) Example: `btc`
- `fiat` (query, optional, string) — Quote fiat: aud, usd, nzd, sgd (default nzd) Example: `nzd`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/independentreserve-api/v1/ticker?coin=btc&fiat=nzd"
```

**Response:**
```json
{
    "data": {
        "ask": 108462.66,
        "bid": 108278.84,
        "coin": "btc",
        "fiat": "nzd",
        "last": 109218.73,
        "pair": "BTC/NZD",
        "venue": "Independent Reserve",
        "source": "Independent Reserve",
        "spread": 183.82,
        "day_avg": 105600.63,
        "day_low": 100855.74,
        "day_high": 110345.52,
        "spread_pct": 0.1695,
        "created_utc": "2026-06-12T01:42:47.0482368Z",
        "day_volume_coin": 63.66,
        "day_volume_in_secondary": 0.32524252
    },
    "meta": {
        "timestamp": "2026-06-12T01:42:47.199Z",
        "request_id": "ac0d992d-aa95-4213-a341-be224c14c899"
    },
    "status": "ok",
    "message": "Ticker retrieved successfully",
    "success": true
}
```

### Orderbook

#### `GET /v1/orderbook` — Live limit-order book with depth

**Parameters:**
- `coin` (query, required, string) — Coin Example: `btc`
- `fiat` (query, optional, string) — Quote fiat (default nzd) Example: `nzd`
- `limit` (query, optional, string) — Levels per side (default 20, max 100) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/independentreserve-api/v1/orderbook?coin=btc&fiat=nzd&limit=20"
```

**Response:**
```json
{
    "data": {
        "asks": [
            {
                "price": 108462.66,
                "volume": 0.08683244
            },
            {
                "price": 109294.12,
                "volume": 0.138
            },
            {
                "price": 109302.64,
                "volume": 0.0142
            },
            {
                "price": 109305.03,
                "volume": 0.2511
            },
            {
                "price": 109305.05,
                "volume": 0.236
            },
            {
                "price": 109366.69,
                "volume": 0.0488
            },
            {
                "price": 109379.65,
                "volume": 0.02
            },
            {
                "price": 109381.6,
                "volume": 0.0555
            },
            {
                "price": 109388.9,
                "volume": 0.0744
            },
            {
                "price": 109413.94,
                "volume": 0.15624132
            },
            {
                "price": 109417.53,
                "volume": 0.1740311
            },
            {
                "price": 109424.56,
                "volume": 0.64373883
            },
            {
                "price": 109478.53,
                "volume": 0.1410065
            },
            {
                "price": 109498.84,
                "volume": 0.554764
            },
            {
                "price": 109498.85,
                "volume": 0.05
…(truncated, see openapi.json for full schema)
```

### Trades

#### `GET /v1/trades` — Most recent executed trades

**Parameters:**
- `coin` (query, required, string) — Coin Example: `eth`
- `fiat` (query, optional, string) — Quote fiat (default nzd) Example: `sgd`
- `limit` (query, optional, string) — Trades (default 20, max 50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/independentreserve-api/v1/trades?coin=eth&fiat=sgd&limit=20"
```

**Response:**
```json
{
    "data": {
        "coin": "eth",
        "fiat": "sgd",
        "pair": "ETH/SGD",
        "count": 20,
        "venue": "Independent Reserve",
        "source": "Independent Reserve",
        "trades": [
            {
                "price": 2135.1,
                "amount_coin": 0.01172023,
                "timestamp_utc": "2026-06-12T01:33:01.7945973Z",
                "value_in_fiat": 25.02
            },
            {
                "price": 2138.69,
                "amount_coin": 0.262,
                "timestamp_utc": "2026-06-12T01:21:15.523494Z",
                "value_in_fiat": 560.34
            },
            {
                "price": 2141.55,
                "amount_coin": 0.00464628,
                "timestamp_utc": "2026-06-12T01:13:39.6849781Z",
                "value_in_fiat": 9.95
            },
            {
                "price": 2148.23,
                "amount_coin": 0.00357694,
                "timestamp_utc": "2026-06-12T00:52:19.6430726Z",
                "value_in_fiat": 7.68
            },
            {
                "price": 2146.9,
                "amount_coin": 0.13904115,
                "timestamp_utc": "2026-06-12T00:24:13.0836326Z",
                "value_in_fiat": 298.51
            },
            {
                "price": 2156.69,
                "amount_coin": 0.09227333,
                "timestamp_utc": "2026-06-11T21:26:19.2487686Z",
                "value_in_fiat": 199
            },
            {
                "price": 
…(truncated, see openapi.json for full schema)
```

### History

#### `GET /v1/history` — Hourly trade-history summary / OHLC

**Parameters:**
- `coin` (query, required, string) — Coin Example: `btc`
- `fiat` (query, optional, string) — Quote fiat (default nzd) Example: `nzd`
- `hours` (query, optional, string) — Hours back (default 24, max 240) Example: `24`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/independentreserve-api/v1/history?coin=btc&fiat=nzd&hours=24"
```

**Response:**
```json
{
    "data": {
        "coin": "btc",
        "fiat": "nzd",
        "pair": "BTC/NZD",
        "hours": 24,
        "venue": "Independent Reserve",
        "source": "Independent Reserve",
        "buckets": 25,
        "history": [
            {
                "low": 105726.38,
                "high": 106904.3,
                "open": 105730.07,
                "close": 105726.38,
                "trades": 4,
                "average": 0,
                "end_utc": "2026-06-11T01:00:00Z",
                "start_utc": "2026-06-11T00:00:00Z",
                "volume_coin": 0.0336382
            },
            {
                "low": 105726.38,
                "high": 106675.98,
                "open": 105726.38,
                "close": 106675.98,
                "trades": 2,
                "average": 0,
                "end_utc": "2026-06-11T02:00:00Z",
                "start_utc": "2026-06-11T01:00:00Z",
                "volume_coin": 0.00139912
            },
            {
                "low": 106675.98,
                "high": 106675.98,
                "open": 106675.98,
                "close": 106675.98,
                "trades": 0,
                "average": 0,
                "end_utc": "2026-06-11T03:00:00Z",
                "start_utc": "2026-06-11T02:00:00Z",
                "volume_coin": 0
            },
            {
                "low": 106675.98,
                "high": 106675.98,
                "open": 106675.98,
                "close": 106675.98,

…(truncated, see openapi.json for full schema)
```

### Markets

#### `GET /v1/markets` — Supported coins and fiat quote currencies

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

**Response:**
```json
{
    "data": {
        "coins": [
            "aave",
            "ada",
            "audm",
            "ausd",
            "avax",
            "bat",
            "bch",
            "bonk",
            "btc",
            "comp",
            "dai",
            "doge",
            "dot",
            "etc",
            "eth",
            "grt",
            "hype",
            "link",
            "ltc",
            "mana",
            "matic",
            "mkr",
            "pengu",
            "pepe",
            "render",
            "rlusd",
            "sand",
            "shib",
            "snx",
            "sol",
            "trump",
            "trx",
            "uni",
            "usdc",
            "usdt",
            "wif",
            "xaut",
            "xlm",
            "xrp",
            "yfi",
            "zrx"
        ],
        "fiats": [
            "aud",
            "nzd",
            "sgd",
            "usd"
        ],
        "venue": "Independent Reserve",
        "source": "Independent Reserve",
        "fiat_count": 4,
        "pairs_total": 164,
        "primary_count": 41
    },
    "meta": {
        "timestamp": "2026-06-12T01:42:49.106Z",
        "request_id": "4f62c5ae-9cf0-44d4-a14d-09ef56e4a73f"
    },
    "status": "ok",
    "message": "Markets retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "fiat is one of aud, usd, nzd, sgd; coin is case-insensitive (btc/xbt, eth, sol, xrp, …). BTC is reported as XBT upstream and accepted either way.",
        "source": "Independent Reserve public API (api.independentreserve.com/Public, live)",
        "service": "independentreserve-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/ticker": "Market summary for a pair (coin=btc, fiat=nzd).",
            "GET /v1/trades": "Most recent executed trades (coin=eth, fiat=sgd, limit=20).",
            "GET /v1/history": "Hourly trade-history summary / OHLC (coin=btc, fiat=nzd, hours=24).",
            "GET /v1/markets": "Supported coins and fiat quote currencies.",
            "GET /v1/orderbook": "Live limit-order book with depth and spread (coin=btc, fiat=nzd, limit=20)."
        },
        "description": "Live order-book exchange data from Independent Reserve, the regulated Australian/New Zealand crypto venue, over its public API. The regional venue view for the AUD, USD, NZD and SGD order books — Australasian/Singapore on-exchange price discovery. ticker = a pair's market summary (last, 24h high/low, day volume, live best bid/offer, spread); orderbook = the live limit-order book (top bids/asks, cumulative depth, spread); trades = the most recent executed trades; history = the hourly trade-history summary (per-hour OHLC, volume, trade count) for the last N hours; markets = the supported coins and the f
…(truncated, see openapi.json for full schema)
```


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