# 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"
```

### 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"
```

### 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"
```

### 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"
```

### 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"
```

### Meta

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

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


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