# KuCoin API > Live spot-market data from KuCoin, one of the largest crypto exchanges and the best-known venue for altcoins, via its public API. KuCoin lists over a thousand trading pairs, so its signature is breadth. Get a pair's full 24-hour snapshot: last price, best bid and ask, high, low, the 24-hour change in price and percent, the base and quote volume, the 24-hour average price and the taker and maker fee. Pull the entire board — every KuCoin pair in one call with its last price and 24-hour change. Get the top of the order book with the spread. Read OHLCV candles at any interval. Live, no key, nothing stored. Distinct from Coinbase, Bitstamp, OKX, Gate.io, Bitfinex, Gemini, Kraken and Bybit venue APIs and from aggregated feeds — this is KuCoin's own ticker, full pair board, order book and candles. Perfect for trading, charting and market-data apps. ## 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/kucoin-api/..." ``` ## Pricing - **Free** (Free) — 7,000 calls/Mo, 3 req/s - **Starter** ($11/Mo) — 146,000 calls/Mo, 8 req/s - **Pro** ($35/Mo) — 865,000 calls/Mo, 20 req/s - **Business** ($80/Mo) — 4,750,000 calls/Mo, 45 req/s ## Endpoints ### Market #### `GET /v1/klines` — OHLCV candles **Parameters:** - `symbol` (query, required, string) — KuCoin symbol Example: `BTC-USDT` - `type` (query, optional, string) — 1min..1week Example: `1day` - `limit` (query, optional, string) — Max 1-1500 Example: `100` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/kucoin-api/v1/klines?symbol=BTC-USDT&type=1day&limit=100" ``` **Response:** ```json { "data": { "type": "1day", "count": 100, "source": "KuCoin", "symbol": "BTC-USDT", "candles": [ { "low": 60727.3, "high": 62445, "open": 61727.2, "time": "2026-06-10T00:00:00.000Z", "close": 62042, "volume": 982.9547284091886, "turnover": 60461987.07124869 }, { "low": 60775.1, "high": 63525.7, "open": 63087.2, "time": "2026-06-09T00:00:00.000Z", "close": 61727.2, "volume": 1701.530300717231, "turnover": 105719849.83357094 }, { "low": 62414, "high": 64207.8, "open": 63335.8, "time": "2026-06-08T00:00:00.000Z", "close": 63080.4, "volume": 1520.41318507, "turnover": 96410322.71453233 }, { "low": 60750, "high": 64271.9, "open": 60884.1, "time": "2026-06-07T00:00:00.000Z", "close": 63329.8, "volume": 1639.6286610299042, "turnover": 101958354.51606365 }, { "low": 59499.7, "high": 61525.8, "open": 61067, "time": "2026-06-06T00:00: …(truncated, see openapi.json for full schema) ``` #### `GET /v1/orderbook` — Top of the order book with spread **Parameters:** - `symbol` (query, required, string) — KuCoin symbol Example: `BTC-USDT` - `depth` (query, optional, string) — 20 or 100 Example: `20` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/kucoin-api/v1/orderbook?symbol=BTC-USDT&depth=20" ``` **Response:** ```json { "data": { "asks": [ { "size": 0.26524845, "price": 62042 }, { "size": 0.21301322, "price": 62042.1 }, { "size": 0.64405342, "price": 62042.2 }, { "size": 0.06, "price": 62044.8 }, { "size": 0.0015, "price": 62045.1 }, { "size": 0.36674239, "price": 62047.3 }, { "size": 0.05313811, "price": 62047.4 }, { "size": 1.16784106, "price": 62047.9 }, { "size": 0.14255936, "price": 62048.1 }, { "size": 0.03110423, "price": 62048.4 }, { "size": 0.05845857, "price": 62048.6 }, { "size": 0.02528025, "price": 62049.6 }, { "size": 0.02386466, "price": 62050.1 }, { "size": 0.29918323, "price": 62050.8 }, { "size": 0.00805789, "price": 62051 }, …(truncated, see openapi.json for full schema) ``` #### `GET /v1/prices` — Every KuCoin pair in one call **Parameters:** - `sort` (query, optional, string) — symbol, change or volume Example: `volume` - `limit` (query, optional, string) — Max 1-2000 Example: `500` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/kucoin-api/v1/prices?sort=volume&limit=500" ``` **Response:** ```json { "data": { "sort": "volume", "count": 1063, "prices": [ { "last": 62042, "symbol": "BTC-USDT", "quote_volume_24h": 229315910.89662957, "change_rate_24h_pct": -0.54 }, { "last": 1649.46, "symbol": "ETH-USDT", "quote_volume_24h": 159639625.25046256, "change_rate_24h_pct": -1.25 }, { "last": 325.11, "symbol": "XMR-USDT", "quote_volume_24h": 51281410.10108, "change_rate_24h_pct": 0.79 }, { "last": 439.76, "symbol": "ZEC-USDT", "quote_volume_24h": 50394135.47209833, "change_rate_24h_pct": -6.5 }, { "last": 1.12719, "symbol": "XRP-USDT", "quote_volume_24h": 36184320.31058997, "change_rate_24h_pct": -2.74 }, { "last": 2.1294, "symbol": "NEAR-USDT", "quote_volume_24h": 34172578.1531358, "change_rate_24h_pct": -2.06 }, { "last": 62003.5, "symbol": "BTC-USDC", "quote_volume_24h": 32540279.65295694, "change_rate_24h_pct": -0.54 }, { …(truncated, see openapi.json for full schema) ``` #### `GET /v1/ticker` — Pair 24h stats incl. fees **Parameters:** - `symbol` (query, required, string) — KuCoin symbol Example: `BTC-USDT` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/kucoin-api/v1/ticker?symbol=BTC-USDT" ``` **Response:** ```json { "data": { "ask": 62039.6, "bid": 62039.5, "last": 62036.2, "time": "2026-06-10T14:02:22.784Z", "source": "KuCoin", "symbol": "BTC-USDT", "low_24h": 60727.3, "high_24h": 62445, "maker_fee": 0.001, "taker_fee": 0.001, "volume_24h": 3728.012653258377, "average_price": 62735.50948483, "change_price_24h": -342.9, "quote_volume_24h": 229315910.89662957, "change_rate_24h_pct": -0.54 }, "meta": { "timestamp": "2026-06-10T14:02:23.166Z", "request_id": "8e03eae1-e647-455c-b9b9-fcf641a91289" }, "status": "ok", "message": "Ticker retrieved successfully", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/kucoin-api OpenAPI spec: https://www.oanor.com/api/kucoin-api/openapi.json