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

**Response:**
```json
{
    "data": {
        "note": "Pairs are NUMERATOR+DENOMINATOR (e.g. BTCTRY). volume is in base units; change_24h_pct is the daily move.",
        "source": "BTCTurk API (api.btcturk.com/api/v2, live)",
        "service": "btcturk-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/ticker": "Ticker for one pair (pair=BTCTRY or symbol=BTC&quote=TRY).",
            "GET /v1/tickers": "All pairs for a quote ranked by 24h volume (quote=TRY, limit=50).",
            "GET /v1/orderbook": "Live market depth — best bid/ask and spread (pair=BTCTRY, limit=20)."
        },
        "pair_count": 365,
        "description": "Live spot market data from BTCTurk, Turkey's largest and oldest crypto exchange and one of the highest-volume venues for the Turkish lira. The ticker endpoint returns a pair's last price, best bid/ask, 24h high/low, open, average and 24h change (in Turkish lira, USDT or Bitcoin); the tickers endpoint ranks every pair for a quote currency by 24h volume; the orderbook endpoint returns live market depth. Live, no key, nothing stored. A distinct Turkish venue with lira pricing, separate from other exchange feeds.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-11T07:49:30.738Z",
        "request_id": "02643b93-2439-4f7e-b360-3bd432c668eb"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```

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

**Response:**
```json
{
    "data": {
        "asks": [
            {
                "price": 2893585,
                "amount": 0.00566
            },
            {
                "price": 2893586,
                "amount": 0.0069127
            },
            {
                "price": 2894069,
                "amount": 0.02592211
            },
            {
                "price": 2894246,
                "amount": 0.0478052
            },
            {
                "price": 2894247,
                "amount": 0.02932958
            },
            {
                "price": 2894370,
                "amount": 0.0241842
            },
            {
                "price": 2895019,
                "amount": 0.00345421
            },
            {
                "price": 2895100,
                "amount": 0.10880453
            },
            {
                "price": 2895220,
                "amount": 0.01208889
            },
            {
                "price": 2895266,
                "amount": 0.1530285
            },
            {
                "price": 2895268,
                "amount": 0.00887278
            },
            {
                "price": 2896066,
                "amount": 0.00486984
            },
            {
                "price": 2896999,
                "amount": 0.12945413
            },
            {
                "price": 2897000,
                "amount": 0.05631584
            },
            {
                "price": 2897219,
                "amount":
…(truncated, see openapi.json for full schema)
```

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

**Response:**
```json
{
    "data": {
        "ask": 2893570,
        "bid": 2892125,
        "base": "BTC",
        "last": 2893672,
        "pair": "BTCTRY",
        "quote": "TRY",
        "source": "BTCTurk",
        "spread": 1445,
        "average": 2853692,
        "low_24h": 2804002,
        "high_24h": 2906042,
        "open_24h": 2844804,
        "timestamp": 1781164170335,
        "change_24h": 48766,
        "volume_24h": 27.29187436,
        "change_24h_pct": 1.72
    },
    "meta": {
        "timestamp": "2026-06-11T07:49:31.071Z",
        "request_id": "631d63c0-4fbc-45e9-b630-31667450ad6e"
    },
    "status": "ok",
    "message": "Ticker retrieved successfully",
    "success": true
}
```

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

**Response:**
```json
{
    "data": {
        "count": 50,
        "quote": "TRY",
        "source": "BTCTurk",
        "tickers": [
            {
                "ask": 46.127,
                "bid": 46.12,
                "base": "USDT",
                "last": 46.12,
                "pair": "USDTTRY",
                "quote": "TRY",
                "spread": 0.007,
                "average": 46.123,
                "low_24h": 46.084,
                "high_24h": 46.143,
                "open_24h": 46.11,
                "timestamp": 1781164170331,
                "change_24h": 0.017,
                "volume_24h": 4400367.98,
                "change_24h_pct": 0.02,
                "quote_volume_24h_approx": 202944971.24
            },
            {
                "ask": 8.469,
                "bid": 8.4503,
                "base": "H",
                "last": 8.469,
                "pair": "HTRY",
                "quote": "TRY",
                "spread": 0.0187,
                "average": 8.7162,
                "low_24h": 7.8,
                "high_24h": 9.6199,
                "open_24h": 8.965,
                "timestamp": 1781164170503,
                "change_24h": -0.496,
                "volume_24h": 22178592.6,
                "change_24h_pct": -5.53,
                "quote_volume_24h_approx": 187830500.73
            },
            {
                "ask": 0.7381,
                "bid": 0.7364,
                "base": "SAHARA",
                "last": 0.7376,
                "pair": "SA
…(truncated, see openapi.json for full schema)
```


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