# BitMart Exchange API > Live spot market data from BitMart, a global crypto exchange, served straight from its public API with no key and nothing cached. The ticker endpoint returns a market's last price, open, 24-hour high and low, 24-hour change, best bid and ask, the spread and base and quote volume. The tickers endpoint returns every spot market for a quote currency ranked by 24-hour quote volume, so one call surfaces the most-traded pairs on the venue. The markets endpoint lists the tradable pairs with their price precision and minimum order size. The book endpoint returns live order-book depth — every bid and ask level with price and amount, plus the best bid/ask and spread. Everything is read live from BitMart on each request, nothing stored. A distinct global venue, separate from the other exchange feeds on the marketplace. Ideal for trading bots, price tickers, arbitrage scanners, portfolio trackers and market dashboards. Live, no key. 4 spot endpoints. For candles or perpetuals use an OHLC or derivatives API. ## 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/bitmart-api/..." ``` ## Pricing - **Free** (Free) — 5,250 calls/Mo, 2 req/s - **Starter** ($9/Mo) — 95,500 calls/Mo, 6 req/s - **Pro** ($24/Mo) — 500,000 calls/Mo, 18 req/s - **Business** ($58/Mo) — 3,020,000 calls/Mo, 45 req/s ## Endpoints ### Market #### `GET /v1/book` — Live order-book depth **Parameters:** - `market` (query, required, string) — Market BASE_QUOTE Example: `BTC_USDT` - `limit` (query, optional, string) — Levels per side (default 20) Example: `20` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/bitmart-api/v1/book?market=BTC_USDT&limit=20" ``` **Response:** ```json { "data": { "asks": [ { "price": 62714.02, "amount": 1.98739 }, { "price": 62714.03, "amount": 0.21351 }, { "price": 62714.04, "amount": 0.18414 }, { "price": 62714.05, "amount": 0.3429 }, { "price": 62714.06, "amount": 0.09848 }, { "price": 62714.07, "amount": 0.30344 }, { "price": 62714.08, "amount": 0.21161 }, { "price": 62719.16, "amount": 0.25518 }, { "price": 62727.5, "amount": 2.7094 }, { "price": 62733.45, "amount": 2.5399 }, { "price": 62733.84, "amount": 0.2191 }, { "price": 62741.36, "amount": 2.36812 }, { "price": 62748.74, "amount": 0.23084 }, { "price": 62753.48, "amount": 2.62017 }, { "price": 62756.9, "amount": 0.00319 }, …(truncated, see openapi.json for full schema) ``` #### `GET /v1/markets` — Tradable pairs with precision and limits **Parameters:** - `quote` (query, optional, string) — Filter by quote currency Example: `USDT` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/bitmart-api/v1/markets?quote=USDT" ``` **Response:** ```json { "data": { "count": 1353, "quote": "USDT", "source": "BitMart", "markets": [ { "base": "HOODON", "quote": "USDT", "market": "HOODON_USDT", "base_min_size": 0.01, "min_buy_amount": 5, "min_sell_amount": 5, "quote_increment": 0.01, "price_max_precision": 2 }, { "base": "$NUT", "quote": "USDT", "market": "$NUT_USDT", "base_min_size": 1, "min_buy_amount": 5, "min_sell_amount": 5, "quote_increment": 1, "price_max_precision": 6 }, { "base": "WCT", "quote": "USDT", "market": "WCT_USDT", "base_min_size": 0.1, "min_buy_amount": 5, "min_sell_amount": 5, "quote_increment": 0.1, "price_max_precision": 5 }, { "base": "OGN", "quote": "USDT", "market": "OGN_USDT", "base_min_size": 0.1, "min_buy_amount": 5, "min_sell_amount": 5, "quote_increment": 0.1, "price_max_precision": 4 }, { "base": "FF", "quote": "USDT", …(truncated, see openapi.json for full schema) ``` #### `GET /v1/ticker` — Ticker for one market **Parameters:** - `market` (query, required, string) — Market BASE_QUOTE Example: `BTC_USDT` - `symbol` (query, optional, string) — Base coin (alternative to market) Example: `BTC` - `quote` (query, optional, string) — Quote currency for symbol Example: `USDT` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/bitmart-api/v1/ticker?market=BTC_USDT&symbol=BTC"e=USDT" ``` **Response:** ```json { "data": { "ask": 62727.26, "bid": 62727.23, "base": "BTC", "last": 62714.01, "quote": "USDT", "market": "BTC_USDT", "source": "BitMart", "spread": 0.03, "low_24h": 60780.41, "high_24h": 62996, "open_24h": 61708.42, "timestamp": 1781164154077, "change_24h_pct": 1.63, "base_volume_24h": 4320.88848, "quote_volume_24h": 267486320.3 }, "meta": { "timestamp": "2026-06-11T07:49:14.276Z", "request_id": "718d8737-8d0f-4836-812b-a7e1b2f18292" }, "status": "ok", "message": "Ticker retrieved successfully", "success": true } ``` #### `GET /v1/tickers` — All spot markets for a quote by volume **Parameters:** - `quote` (query, optional, string) — Quote currency (default USDT) Example: `USDT` - `limit` (query, optional, string) — Max markets (default 50) Example: `50` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/bitmart-api/v1/tickers?quote=USDT&limit=50" ``` **Response:** ```json { "data": { "count": 50, "quote": "USDT", "source": "BitMart", "tickers": [ { "ask": 62727.26, "bid": 62727.23, "base": "BTC", "last": 62714.01, "quote": "USDT", "market": "BTC_USDT", "spread": 0.03, "low_24h": 60780.41, "high_24h": 62996, "open_24h": 61708.42, "timestamp": 1781164154077, "change_24h_pct": 1.63, "base_volume_24h": 4320.88848, "quote_volume_24h": 267486320.3 }, { "ask": 1654.22, "bid": 1654.2, "base": "ETH", "last": 1653.92, "quote": "USDT", "market": "ETH_USDT", "spread": 0.02, "low_24h": 1604.37, "high_24h": 1667.59, "open_24h": 1639.32, "timestamp": 1781164154044, "change_24h_pct": 0.891, "base_volume_24h": 49654.71922, "quote_volume_24h": 81168698.32 }, { "ask": 64.988, "bid": 64.9849, "base": "SOL", "last": 64.986, "quote": "USDT", "market": "SOL_USDT", "spread": 0.0031, "low_24h": 62.3497, …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Spec **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/bitmart-api/v1/meta" ``` **Response:** ```json { "data": { "note": "Markets are BASE_QUOTE (e.g. BTC_USDT). change_24h_pct is the 24h change; quote_volume_24h is in the quote currency.", "source": "BitMart API (api-cloud.bitmart.com, live)", "service": "bitmart-api", "endpoints": { "GET /v1/book": "Live order-book depth — best bid/ask and spread (market=BTC_USDT, limit=20).", "GET /v1/meta": "This document.", "GET /v1/ticker": "Ticker for one market (market=BTC_USDT or symbol=BTC"e=USDT).", "GET /v1/markets": "Tradable pairs with precision and minimum order size (quote=USDT optional).", "GET /v1/tickers": "All spot markets for a quote ranked by 24h quote volume (quote=USDT, limit=50)." }, "description": "Live spot market data from BitMart, a global crypto exchange. The ticker endpoint returns a market's last price, open, 24h high/low, 24h change, best bid/ask and base/quote volume; the tickers endpoint ranks every spot market for a quote currency by 24h quote volume; the markets endpoint lists tradable pairs with precision and minimum order size; the book endpoint returns live order-book depth. Live, no key, nothing stored. A distinct global venue, separate from other exchange feeds.", "market_count": 1102, "upstream_status": "ok" }, "meta": { "timestamp": "2026-06-11T07:49:15.078Z", "request_id": "65c36637-4756-4e4d-8684-fd20cf3ea633" }, "status": "ok", …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/bitmart-api OpenAPI spec: https://www.oanor.com/api/bitmart-api/openapi.json