# BTSE Exchange API > Live spot market data from BTSE, a global crypto exchange, served straight from its public order books — no key on the data, nothing cached, nothing stored. Look up any market for its last price, best bid/ask and spread, 24h high/low, 24h change and base/quote volume; rank every market for a quote currency by 24h turnover; list the tradable pairs with their base and quote; or pull live order-book depth with the running spread. Markets are addressed BASE-QUOTE (BTC-USD). This is the BTSE venue specifically — a distinct multi-fiat price feed that quotes against the US, Hong Kong, Canadian, New Zealand and Australian dollars plus the pound, euro, Swiss franc, yen and rupee as well as USDT/USDC, ideal for HKD/CAD/CHF/GBP/NZD price discovery and cross-venue arbitrage, separate from the USD/USDT-only exchange APIs in the catalogue. ## 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/btse-api/..." ``` ## Pricing - **Free** (Free) — 21,800 calls/Mo, 3 req/s - **Starter** ($9/Mo) — 292,000 calls/Mo, 10 req/s - **Growth** ($27/Mo) — 1,315,000 calls/Mo, 25 req/s - **Scale** ($62/Mo) — 4,550,000 calls/Mo, 50 req/s ## Endpoints ### Ticker #### `GET /v1/ticker` — Ticker for one market **Parameters:** - `market` (query, optional, string) — Market as BTC-USD Example: `BTC-USD` - `base` (query, optional, string) — Base asset (with quote=) Example: `ETH` - `quote` (query, optional, string) — Quote currency (USD/HKD/CAD/GBP/CHF/NZD…) Example: `USD` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/btse-api/v1/ticker?market=BTC-USD&base=ETH"e=USD" ``` **Response:** ```json { "data": { "ask": 62588.9, "bid": 62588.7, "base": "BTC", "last": 62589.1, "quote": "USD", "active": true, "market": "BTC-USD", "source": "BTSE", "spread": 0.2, "low_24h": 61069.8, "high_24h": 63233, "change_24h_pct": 0.62701871, "base_volume_24h": 2323.19236999, "quote_volume_24h": 144843981.35 }, "meta": { "timestamp": "2026-06-11T16:47:33.896Z", "request_id": "92b25b9c-cedc-420c-94de-c2efa4b2352c" }, "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 Example: `USD` - `limit` (query, optional, string) — Max results (1-400) Example: `50` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/btse-api/v1/tickers?quote=USD&limit=50" ``` **Response:** ```json { "data": { "count": 50, "quote": "USD", "source": "BTSE", "tickers": [ { "ask": 62588.9, "bid": 62588.7, "base": "BTC", "last": 62589.1, "quote": "USD", "active": true, "market": "BTC-USD", "spread": 0.2, "low_24h": 61069.8, "high_24h": 63233, "change_24h_pct": 0.62701871, "base_volume_24h": 2323.19236999, "quote_volume_24h": 144843981.35 }, { "ask": 1.1077, "bid": 1.1073, "base": "XRP", "last": 1.1076, "quote": "USD", "active": true, "market": "XRP-USD", "spread": 0.0004, "low_24h": 1.0889, "high_24h": 1.1291, "change_24h_pct": -0.52092689, "base_volume_24h": 31888764.68, "quote_volume_24h": 35384883.33 }, { "ask": 1640.13, "bid": 1639.73, "base": "ETH", "last": 1639.74, "quote": "USD", "active": true, "market": "ETH-USD", "spread": 0.4, "low_24h": 1603.74, "high_24h": 1672.31, "change_24h_pct": -0. …(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: `USD` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/btse-api/v1/markets?quote=USD" ``` **Response:** ```json { "data": { "count": 290, "quote": "USD", "source": "BTSE", "markets": [ { "base": "1CAT", "quote": "USD", "active": true, "market": "1CAT-USD" }, { "base": "1INCH", "quote": "USD", "active": true, "market": "1INCH-USD" }, { "base": "AAVE", "quote": "USD", "active": true, "market": "AAVE-USD" }, { "base": "AB", "quote": "USD", "active": true, "market": "AB-USD" }, { "base": "ACH", "quote": "USD", "active": true, "market": "ACH-USD" }, { "base": "ACT", "quote": "USD", "active": true, "market": "ACT-USD" }, { "base": "ADA", "quote": "USD", "active": true, "market": "ADA-USD" }, { "base": "AEVO", "quote": "USD", "active": true, "market": "AEVO-USD" }, { "base": "AGLD", "quote": "USD", "active": …(truncated, see openapi.json for full schema) ``` ### Book #### `GET /v1/book` — Live order-book depth with running spread **Parameters:** - `market` (query, optional, string) — Market as BTC-USD Example: `BTC-USD` - `limit` (query, optional, string) — Depth per side (1-100) Example: `20` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/btse-api/v1/book?market=BTC-USD&limit=20" ``` **Response:** ```json { "data": { "asks": [ { "price": 62588.9, "amount": 0.004 }, { "price": 62589, "amount": 0.017 }, { "price": 62589.1, "amount": 0.0955 }, { "price": 62589.2, "amount": 0.059 }, { "price": 62589.3, "amount": 0.2015 }, { "price": 62589.4, "amount": 0.1025 }, { "price": 62589.5, "amount": 0.074 }, { "price": 62589.6, "amount": 0.0609 }, { "price": 62589.7, "amount": 0.183 }, { "price": 62589.8, "amount": 0.169 }, { "price": 62589.9, "amount": 0.1242 }, { "price": 62590, "amount": 0.0435 }, { "price": 62590.1, "amount": 0.097 }, { "price": 62590.2, "amount": 0.0445 }, { "price": 62590.5, "amount": 0.0895 }, { "price" …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/btse-api/v1/meta" ``` **Response:** ```json { "data": { "note": "Markets are BASE-QUOTE (BTC-USD). The default quote is USD; HKD, CAD, CHF, GBP, NZD, AUD, EUR, JPY, INR, USDT and USDC are also available. quote_volume_24h is BTSE's volume (quote turnover); base_volume_24h is its size; change_24h_pct is the 24h percentage move.", "source": "BTSE public API (api.btse.com/spot/api/v3.2, live)", "service": "btse-api", "endpoints": { "GET /v1/book": "Live order-book depth — best bid/ask and spread (market=BTC-USD, limit=20).", "GET /v1/meta": "This document.", "GET /v1/ticker": "Ticker for one market (market=BTC-USD or base=BTC"e=USD).", "GET /v1/markets": "Tradable pairs with base/quote (quote=USD optional).", "GET /v1/tickers": "All markets for a quote ranked by 24h turnover (quote=USD, limit=50)." }, "description": "Live spot market data from BTSE, a global crypto exchange. The ticker endpoint returns a market's last price, best bid/ask, 24h high/low, 24h change and base/quote volume; the tickers endpoint ranks every market for a quote currency by 24h turnover; the markets endpoint lists tradable pairs with base/quote; the book endpoint returns live order-book depth. Live, no key, nothing stored. A distinct multi-fiat venue quoting against USD, HKD, CAD, CHF, GBP, NZD, AUD, EUR, JPY and INR as well as USDT/USDC — useful for Hong-Kong-dollar, Canadian-dollar, Swiss-franc, pound and New-Zealand-dollar pric …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/btse-api OpenAPI spec: https://www.oanor.com/api/btse-api/openapi.json