# Firi Nordic Exchange API
> Live order-book exchange data from Firi, the regulated Norwegian crypto venue and the largest in the Nordics, over its public API — no key, nothing stored. This is the regional venue view for the Norwegian krone (NOK) and Danish krone (DKK) order books: Nordic on-exchange price discovery, distinct from the global-aggregate and the other regional-exchange APIs in the catalogue. The ticker endpoint returns a pair full market summary — last traded price, 24h high/low, the 24h change percent, day volume and the live best bid, best ask and 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 with price, amount, side and time. The markets endpoint lists every NOK and DKK pair the venue trades with its last price and day volume. Coins traded include BTC, ETH, XRP, SOL, ADA, LTC, BNB, DOT and USDC, quoted in NOK and DKK, updated live. Build a pair from coin plus fiat (coin=btc, fiat=nok) or pass it directly (pair=ETHDKK).

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

## Pricing
- **Free** (Free) — 15,000 calls/Mo, 3 req/s
- **Starter** ($8/Mo) — 225,000 calls/Mo, 10 req/s
- **Pro** ($24/Mo) — 910,000 calls/Mo, 28 req/s
- **Scale** ($53/Mo) — 3,300,000 calls/Mo, 60 req/s

## Endpoints

### Ticker

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

**Parameters:**
- `coin` (query, required, string) — Coin (btc, eth, xrp, sol…) Example: `btc`
- `fiat` (query, optional, string) — Quote fiat: nok or dkk (default nok) Example: `nok`

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

### 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 nok) Example: `nok`
- `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/firi-api/v1/orderbook?coin=btc&fiat=nok&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 nok) Example: `nok`
- `limit` (query, optional, string) — Trades (default 20, max 50) Example: `20`

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

### Markets

#### `GET /v1/markets` — Every NOK and DKK pair with last price and volume

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

### Meta

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

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


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