Spot Market Data REST API Reference

import { RestClient } from 'bitmart-api';

const client = new RestClient();

const response = await client.getSystemTime();
console.log('Server time (ms):', response.data.server_time);

import { RestClient } from 'bitmart-api';

const client = new RestClient();

const response = await client.getSystemStatus();
for (const svc of response.data.service) {
  const state = svc.status === 0 ? '✅ Normal' : '🔧 Maintenance';
  console.log(`${svc.title}: ${state}`);
}

import { RestClient } from 'bitmart-api';

const client = new RestClient();

const response = await client.getSpotCurrenciesV1();
const active = response.data.currencies.filter(
  (c) => c.deposit_enabled && c.withdraw_enabled,
);
console.log(`Active currencies: ${active.length}`);
console.log(active.slice(0, 3));

import { RestClient } from 'bitmart-api';

const client = new RestClient();

const response = await client.getSpotTradingPairsV1();
console.log('Total pairs:', response.data.symbols.length);
console.log('First 5:', response.data.symbols.slice(0, 5));

import { RestClient } from 'bitmart-api';

const client = new RestClient();

const response = await client.getSpotTradingPairDetailsV1();
const btcUsdt = response.data.symbols.find((s) => s.symbol === 'BTC_USDT');

if (btcUsdt) {
  console.log('BTC_USDT min buy amount:', btcUsdt.min_buy_amount);
  console.log('Price precision:', btcUsdt.price_max_precision);
}

import { RestClient } from 'bitmart-api';

const client = new RestClient();

const response = await client.getSpotTickersV3();
// Destructure the array format
const [symbol, last, v24h, , , high24h, low24h] = response.data[0];
console.log(`${symbol}: last=${last}, high=${high24h}, low=${low24h}`);

import { RestClient } from 'bitmart-api';

const client = new RestClient();

const response = await client.getSpotTickerV3({ symbol: 'BTC_USDT' });
const ticker = response.data;

console.log(`BTC_USDT`);
console.log(`  Last:       ${ticker.last}`);
console.log(`  24h High:   ${ticker.high_24h}`);
console.log(`  24h Low:    ${ticker.low_24h}`);
console.log(`  24h Change: ${ticker.fluctuation}`);
console.log(`  Best Bid:   ${ticker.bid_px} (${ticker.bid_sz})`);
console.log(`  Best Ask:   ${ticker.ask_px} (${ticker.ask_sz})`);

import { RestClient } from 'bitmart-api';

const client = new RestClient();

// Fetch last 50 one-hour candles for BTC_USDT
const response = await client.getSpotLatestKlineV3({
  symbol: 'BTC_USDT',
  step: 60,
  limit: 50,
});

for (const [t, o, h, l, c, v] of response.data) {
  console.log(`Open: ${o}  High: ${h}  Low: ${l}  Close: ${c}  Vol: ${v}`);
}

import { RestClient } from 'bitmart-api';

const client = new RestClient();

const oneDayAgo = Date.now() - 24 * 60 * 60 * 1000;

const response = await client.getSpotHistoryKlineV3({
  symbol: 'ETH_USDT',
  step: 60,       // 1-hour candles
  after: oneDayAgo,
  limit: 24,
});

console.log(`Fetched ${response.data.length} hourly candles`);
const latest = response.data[0];
console.log(`Most recent close: ${latest[4]}`);

import { RestClient } from 'bitmart-api';

const client = new RestClient();

const response = await client.getSpotOrderBookDepthV3({
  symbol: 'BTC_USDT',
  limit: 10,
});

const { bids, asks, ts } = response.data;
console.log(`Order book snapshot at ${ts}`);
console.log('Top bid:', bids[0][0], '×', bids[0][1]);
console.log('Top ask:', asks[0][0], '×', asks[0][1]);
console.log('Spread:', (parseFloat(asks[0][0]) - parseFloat(bids[0][0])).toFixed(2));

import { RestClient } from 'bitmart-api';

const client = new RestClient();

const response = await client.getSpotRecentTrades({
  symbol: 'BTC_USDT',
  limit: 20,
});

for (const [symbol, ts, price, size, side] of response.data) {
  const arrow = side === 'buy' ? '▲' : '▼';
  console.log(`${arrow} ${side.toUpperCase()} ${size} BTC @ ${price} USDT`);
}

import { RestClient } from 'bitmart-api';

const client = new RestClient();

const response = await client.getSpotTickersV2();
const btc = response.data.tickers.find((t) => t.symbol === 'BTC_USDT');
console.log('BTC last price:', btc?.last_price);

import { RestClient } from 'bitmart-api';

const client = new RestClient();

const response = await client.getSpotTickerV1({ symbol: 'BTC_USDT' });
console.log('Last price:', response.data.last_price);
console.log('Best ask:', response.data.best_ask);
console.log('Best bid:', response.data.best_bid);

import { RestClient } from 'bitmart-api';

const client = new RestClient();

const now = Math.floor(Date.now() / 1000);
const oneDayAgo = now - 86400;

const response = await client.getSpotKlinesV1({
  symbol: 'BTC_USDT',
  from: oneDayAgo,
  to: now,
  step: 60, // 1-hour candles
});

for (const kline of response.data.klines) {
  console.log(`${new Date(kline.timestamp * 1000).toISOString()} — close: ${kline.close}`);
}

import { RestClient } from 'bitmart-api';

const client = new RestClient();

const response = await client.getSpotKLineStepsV1();
console.log('Supported kline steps (minutes):', response.data.steps);

import { RestClient } from 'bitmart-api';

const client = new RestClient();

const response = await client.getSpotOrderBookDepthV1({
  symbol: 'BTC_USDT',
  size: 10,
});

const { buys, sells } = response.data;
console.log('Top bid:', buys[0]?.price, '×', buys[0]?.amount);
console.log('Top ask:', sells[0]?.price, '×', sells[0]?.amount);

import { RestClient } from 'bitmart-api';

async function marketSnapshot(symbol: string) {
  const client = new RestClient();

  // Run public requests in parallel
  const [ticker, orderBook, trades, klines] = await Promise.all([
    client.getSpotTickerV3({ symbol }),
    client.getSpotOrderBookDepthV3({ symbol, limit: 5 }),
    client.getSpotRecentTrades({ symbol, limit: 5 }),
    client.getSpotLatestKlineV3({ symbol, step: 60, limit: 5 }),
  ]);

  console.log(`=== ${symbol} Snapshot ===`);
  console.log(`Last price:  ${ticker.data.last}`);
  console.log(`24h change:  ${ticker.data.fluctuation}`);
  console.log(`Top bid:     ${orderBook.data.bids[0][0]}`);
  console.log(`Top ask:     ${orderBook.data.asks[0][0]}`);
  console.log(`Last trade:  ${trades.data[0][2]} (${trades.data[0][4]})`);
  console.log(`Latest 1h candle close: ${klines.data[0][4]}`);
}

await marketSnapshot('BTC_USDT');