# BTCTurk API
> Live spot market data from BTCTurk, Turkey's largest and oldest crypto exchange and one of the highest-volume venues for the Turkish lira — served straight from its public API, no key, nothing cached. Get a pair's last price, best bid/ask, 24h high/low, open, average and 24h change (in Turkish lira, USDT or Bitcoin); rank every pair for a quote currency by 24h volume; and read live market depth with the best bid/ask and spread. A distinct Turkish venue with lira pricing, separate from other exchange feeds. Pairs are NUMERATOR+DENOMINATOR (e.g. BTCTRY).

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

## Pricing
- **Free** (Free) — 3,600 calls/Mo, 2 req/s
- **Starter** ($8/Mo) — 80,500 calls/Mo, 6 req/s
- **Pro** ($23/Mo) — 415,000 calls/Mo, 15 req/s
- **Business** ($54/Mo) — 2,590,000 calls/Mo, 40 req/s

## Endpoints

### BTCTurk

#### `GET /v1/meta` — Service metadata and endpoint list

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

#### `GET /v1/orderbook` — Live market depth — best bid/ask and spread

**Parameters:**
- `pair` (query, required, string) — Pair NUMERATOR+DENOMINATOR Example: `BTCTRY`
- `limit` (query, optional, string) — Levels per side 1-100 (default 20) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/btcturk-api/v1/orderbook?pair=BTCTRY&limit=20"
```

#### `GET /v1/ticker` — Ticker for one pair

**Parameters:**
- `pair` (query, required, string) — Pair NUMERATOR+DENOMINATOR (or use symbol & quote) Example: `BTCTRY`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/btcturk-api/v1/ticker?pair=BTCTRY"
```

#### `GET /v1/tickers` — All pairs for a quote ranked by 24h volume

**Parameters:**
- `quote` (query, optional, string) — Quote currency e.g. TRY, USDT (default TRY) Example: `TRY`
- `limit` (query, optional, string) — Max results 1-300 (default 50) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/btcturk-api/v1/tickers?quote=TRY&limit=50"
```


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