# Quidax Exchange API
> Live spot market data from Quidax, a leading Nigerian crypto exchange, served straight from its public ticker feed — no key on the data, nothing cached, nothing stored. Look up any market for its last price, best bid/ask and spread, 24h open/high/low, 24h change and base/quote volume; rank every market for a quote currency (Nigerian naira NGN, USDT or USD) by 24h turnover; or list the tradable pairs with their base and quote. Markets are addressed as BTCNGN or BTC_NGN. This is the Quidax venue specifically — a distinct Nigerian-naira price feed for a high-adoption African market, ideal for NGN price discovery and Africa-market arbitrage, separate from the USD/USDT-quoted exchange APIs in the catalogue. Ticker-only: Quidax exposes no public order book, so the best bid/ask travel inside the ticker.

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

## Pricing
- **Free** (Free) — 18,500 calls/Mo, 3 req/s
- **Starter** ($8/Mo) — 268,000 calls/Mo, 10 req/s
- **Growth** ($23/Mo) — 1,230,000 calls/Mo, 25 req/s
- **Scale** ($54/Mo) — 4,200,000 calls/Mo, 50 req/s

## Endpoints

### Ticker

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

**Parameters:**
- `market` (query, optional, string) — Market as BTC_NGN or BTCNGN Example: `BTC_NGN`
- `base` (query, optional, string) — Base asset (with quote=) Example: `ETH`
- `quote` (query, optional, string) — Quote currency NGN/USDT/USD Example: `NGN`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/quidax-api/v1/ticker?market=BTC_NGN&base=ETH&quote=NGN"
```

**Response:**
```json
{
    "data": {
        "ask": 87105893,
        "bid": 86627766,
        "base": "BTC",
        "last": 86808440,
        "quote": "NGN",
        "market": "btcngn",
        "source": "Quidax",
        "spread": 478127,
        "low_24h": 84204993,
        "high_24h": 87560734,
        "open_24h": 85407358,
        "change_24h": 1401082,
        "change_24h_pct": 1.6405,
        "base_volume_24h": 0.57144386,
        "quote_volume_24h": 49606150.03
    },
    "meta": {
        "timestamp": "2026-06-11T07:45:07.305Z",
        "request_id": "3de5304f-b2af-4c46-b860-04bc4e8728ab"
    },
    "status": "ok",
    "message": "Ticker retrieved successfully",
    "success": true
}
```

### Tickers

#### `GET /v1/tickers` — All markets for a quote ranked by 24h turnover

**Parameters:**
- `quote` (query, optional, string) — Quote currency NGN/USDT/USD Example: `NGN`
- `limit` (query, optional, string) — Max results (1-400) Example: `50`

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

**Response:**
```json
{
    "data": {
        "count": 9,
        "quote": "NGN",
        "source": "Quidax",
        "tickers": [
            {
                "ask": 2296748,
                "bid": 2285280,
                "base": "ETH",
                "last": 2288490,
                "quote": "NGN",
                "market": "ethngn",
                "spread": 11468,
                "low_24h": 2223622,
                "high_24h": 2314872,
                "open_24h": 2273531,
                "change_24h": 14959,
                "change_24h_pct": 0.658,
                "base_volume_24h": 35.49029439,
                "quote_volume_24h": 81219183.8
            },
            {
                "ask": 1391.03,
                "bid": 1387,
                "base": "USDT",
                "last": 1387,
                "quote": "NGN",
                "market": "usdtngn",
                "spread": 4.03,
                "low_24h": 1381.72,
                "high_24h": 1394.83,
                "open_24h": 1388.41,
                "change_24h": -1.41,
                "change_24h_pct": -0.1016,
                "base_volume_24h": 49856.84842465,
                "quote_volume_24h": 69151448.76
            },
            {
                "ask": 87105893,
                "bid": 86627766,
                "base": "BTC",
                "last": 86808440,
                "quote": "NGN",
                "market": "btcngn",
                "spread": 478127,
                "low_24h": 84204993,
                "high_24
…(truncated, see openapi.json for full schema)
```

### Markets

#### `GET /v1/markets` — Tradable pairs with base/quote

**Parameters:**
- `quote` (query, optional, string) — Filter by quote currency Example: `NGN`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/quidax-api/v1/markets?quote=NGN"
```

**Response:**
```json
{
    "data": {
        "count": 9,
        "quote": "NGN",
        "source": "Quidax",
        "markets": [
            {
                "base": "BTC",
                "quote": "NGN",
                "market": "btcngn"
            },
            {
                "base": "CNGN",
                "quote": "NGN",
                "market": "cngnngn"
            },
            {
                "base": "DASH",
                "quote": "NGN",
                "market": "dashngn"
            },
            {
                "base": "ETH",
                "quote": "NGN",
                "market": "ethngn"
            },
            {
                "base": "LTC",
                "quote": "NGN",
                "market": "ltcngn"
            },
            {
                "base": "QDX",
                "quote": "NGN",
                "market": "qdxngn"
            },
            {
                "base": "TRX",
                "quote": "NGN",
                "market": "trxngn"
            },
            {
                "base": "USDT",
                "quote": "NGN",
                "market": "usdtngn"
            },
            {
                "base": "XRP",
                "quote": "NGN",
                "market": "xrpngn"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-11T07:45:08.186Z",
        "request_id": "6fbcb87d-6131-4f28-9587-72522d606a25"
    },
    "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/quidax-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Pass markets as BTC_NGN or BTCNGN (concatenated). base/quote come from /markets. The default quote is the Nigerian naira (NGN). quote_volume_24h is derived as vol × last; the 24h change is from the day's open.",
        "source": "Quidax public API (app.quidax.io/api/v1, live)",
        "service": "quidax-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/ticker": "Ticker for one market (market=BTC_NGN or base=BTC&quote=NGN).",
            "GET /v1/markets": "Tradable pairs with base/quote (quote=NGN optional).",
            "GET /v1/tickers": "All markets for a quote ranked by 24h turnover (quote=NGN, limit=50)."
        },
        "description": "Live spot market data from Quidax, a leading Nigerian crypto exchange. The ticker endpoint returns a market's last price, best bid/ask, 24h open/high/low, 24h change and base/quote volume; the tickers endpoint ranks every market for a quote currency (NGN, USDT or USD) by 24h turnover; the markets endpoint lists tradable pairs with base/quote. Live, no key, nothing stored. A distinct Nigerian-naira venue for NGN price discovery, separate from the USD/USDT-quoted exchange feeds. Ticker-only (Quidax exposes no public order book); best bid/ask are in the ticker.",
        "market_count": 49,
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-11T07:45:08.293Z",
        "request_id": "c35be400-aebc-4a3d-bf0f-d3427ef2d8a3"
    },
…(truncated, see openapi.json for full schema)
```


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