Binance
Global crypto spot market data — 24h statistics, candles and order book depth from the largest venue.
Ticker
24-hour statistics for one spot pair.
/v1/finance:binance/tickerParameters
| Name | Type | In | Description |
|---|---|---|---|
| symbol | string | query | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt. Required. |
Example response
{"project":"finance:binance", "data": {"ask":72149.62,"bid":72149.61,"low":66592.3,"high":72564.01,"last":72149.61,"open":66676.28,"askQty":1.80702,"bidQty":0.32444,"change":5473.33,"symbol":"BTCUSDT","exchange":"binance","openTime":1787152673012,"closeTime":1787239073012,"tradeCount":7028422,"volumeBase":45179.29453,"volumeQuote":3162142746.4771805,"changePercent":8.209,"previousClose":66676.28,"weightedAvgPrice":69990.97217814 },"timestamp":"2026-08-02T04:20:59Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Tickers
Every spot pair at once, filterable by quote asset.
/v1/finance:binance/tickersParameters
| Name | Type | In | Description |
|---|---|---|---|
| quote | enum | query | Restrict to pairs quoted in this asset. Default USDT. One of all, USDT, USDC, BTC, ETH, BNB, FDUSD, TRY, EUR. |
| search | string | query | Filter by base asset. |
| sort | enum | query | Sort key, descending for volume and change. Default volume. One of volume, change, symbol. |
| count | number | query | Rows to return. Default 100, max 500. |
Example response
{"project":"finance:binance", "data": {"sort":"volume","count":100, "items": [ {"low":66346.01,"base":"BTC","high":72564.01,"last":72163.68,"quote":"USDT","change":5774.27,"symbol":"BTCUSDT","tradeCount":7037978,"volumeBase":45643.70388,"volumeQuote":3189585955.6830025,"changePercent":8.698 }, {"low":1.00011,"base":"USDC","high":1.00094,"last":1.00066,"quote":"USDT","change":0.00002,"symbol":"USDCUSDT","tradeCount":960377,"volumeBase":2696971601,"volumeQuote":2698458404.2704,"changePercent":0.002 }, {"low":1996.8,"base":"ETH","high":2333.65,"last":2294.16,"quote":"USDT","change":293.48,"symbol":"ETHUSDT","tradeCount":7788157,"volumeBase":1015554.6422,"volumeQuote":2237368991.893833,"changePercent":14.669 }, {"low":0.99937,"base":"USD1","high":1.0003,"last":1,"quote":"USDT","change":0.00018,"symbol":"USD1USDT","tradeCount":702263,"volumeBase":715503389,"volumeQuote":715273999.02337,"changePercent":0.018 }, {"low":80.86,"base":"SOL","high":88.1,"last":86.99,"quote":"USDT","change":5.58,"symbol":"SOLUSDT","tradeCount":1555604,"volumeBase":5004994.67,"volumeQuote":425318791.27361,"changePercent":6.854 }, {"low":1.0382,"base":"XRP","high":1.2521,"last":1.2494,"quote":"USDT","change":0.2109,"symbol":"XRPUSDT","tradeCount":1877984,"volumeBase":311095671.5,"volumeQuote":352737150.28509,"changePercent":20.308 } ],"quote":"USDT","total":734,"exchange":"binance" },"timestamp":"2026-08-02T04:20:59Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Klines
OHLCV candles from one minute to one month.
/v1/finance:binance/klinesParameters
| Name | Type | In | Description |
|---|---|---|---|
| symbol | string | query | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt. Required. |
| interval | enum | query | Candle size. Default 1d. One of 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M. |
| count | number | query | Number of candles. Default 200, max 1000. |
| limit | number | query | Alias for count, and wins when both are sent. Max 1000. |
| startTime | string | query | Oldest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds. |
| endTime | string | query | Newest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds. |
Example response
{"project":"finance:binance", "data": {"count":61,"symbol":"BTCUSDT", "candles": [ {"low":42180.77,"date":"2024-01-01T00:00:00.000Z","high":44184.1,"open":42283.58,"close":44179.55,"openTime":1704067200000,"closeTime":1704153599999,"tradeCount":1114623,"volumeBase":27174.29903,"volumeQuote":1169995682.0280013 }, {"low":44148.34,"date":"2024-01-02T00:00:00.000Z","high":45879.63,"open":44179.55,"close":44946.91,"openTime":1704153600000,"closeTime":1704239999999,"tradeCount":2247532,"volumeBase":65146.40661,"volumeQuote":2944331821.8230762 }, {"low":40750,"date":"2024-01-03T00:00:00.000Z","high":45500,"open":44946.91,"close":42845.23,"openTime":1704240000000,"closeTime":1704326399999,"tradeCount":2658041,"volumeBase":81194.55173,"volumeQuote":3507104563.744232 } ],"exchange":"binance","interval":"1d" },"timestamp":"2026-08-02T04:20:59Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Order book
Resting bids and asks for one spot pair.
/v1/finance:binance/depthParameters
| Name | Type | In | Description |
|---|---|---|---|
| symbol | string | query | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt. Required. |
| limit | number | query | Levels per side. Default 50, max 500. |
Example response
{"project":"finance:binance", "data": { "asks": [ {"price":72114.93,"amount":0.37809 }, {"price":72114.94,"amount":0.00016 }, {"price":72116.04,"amount":0.00008 }, {"price":72116.21,"amount":0.00007 }, {"price":72117.29,"amount":0.00016 }, {"price":72117.3,"amount":0.05873 } ], "bids": [ {"price":72114.92,"amount":5.53524 }, {"price":72114.91,"amount":0.0003 }, {"price":72114.9,"amount":0.00014 }, {"price":72114.28,"amount":0.00016 }, {"price":72114.27,"amount":0.01874 }, {"price":72112.98,"amount":0.00023 } ],"spread":0.01,"symbol":"BTCUSDT","askCount":50,"bidCount":50,"exchange":"binance" },"timestamp":"2026-08-02T04:20:59Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Agg Trades
Compressed trades for one spot pair: fills at the same price, from the same
/v1/finance:binance/agg-tradesParameters
| Name | Type | In | Description |
|---|---|---|---|
| symbol | string | query | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt. Required. |
| count | number | query | Rows to return, newest last. Default 500, max 1000. |
| startTime | string | query | Window start, inclusive. ISO timestamp or epoch milliseconds. |
| endTime | string | query | Window end, inclusive. ISO timestamp or epoch milliseconds. |
| fromId | string | query | Resume from this aggregate trade id instead of a time window. |
Example response
{"project":"finance:binance", "data": {"count":200, "items": [ {"side":"sell","time":1787184000161,"price":69334.78,"amount":0.00021,"timeIso":"2026-08-20T00:00:00.161Z","aggTradeId":4036091185,"tradeCount":1,"amountQuote":14.5603038,"lastTradeId":6584309787,"firstTradeId":6584309787,"isBuyerMaker":true }, {"side":"buy","time":1787184000295,"price":69334.79,"amount":0.00007,"timeIso":"2026-08-20T00:00:00.295Z","aggTradeId":4036091186,"tradeCount":1,"amountQuote":4.8534353,"lastTradeId":6584309788,"firstTradeId":6584309788,"isBuyerMaker":false }, {"side":"buy","time":1787184000346,"price":69334.79,"amount":0.0004,"timeIso":"2026-08-20T00:00:00.346Z","aggTradeId":4036091187,"tradeCount":1,"amountQuote":27.733916,"lastTradeId":6584309789,"firstTradeId":6584309789,"isBuyerMaker":false } ],"symbol":"BTCUSDT","exchange":"binance" },"timestamp":"2026-08-02T04:20:59Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Avg Price
The venue's own rolling average price for one spot pair — the reference the
/v1/finance:binance/avg-priceParameters
| Name | Type | In | Description |
|---|---|---|---|
| symbol | string | query | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt. Required. |
Example response
{"project":"finance:binance", "data": {"price":72259.18437849,"symbol":"BTCUSDT","exchange":"binance","closeTime":1787239013380,"closeTimeIso":"2026-08-20T15:16:53.380Z","windowMinutes":5 },"timestamp":"2026-08-02T04:20:59Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Book Ticker
Best bid and ask for one spot pair — the top of the book without the depth.
/v1/finance:binance/book-tickerParameters
| Name | Type | In | Description |
|---|---|---|---|
| symbol | string | query | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt. Required. |
Example response
{"project":"finance:binance", "data": {"ask":72205.99,"bid":72205.98,"askQty":0.00021,"bidQty":0.43904,"spread":0.01,"symbol":"BTCUSDT","exchange":"binance","spreadPercent":0.000014 },"timestamp":"2026-08-02T04:20:59Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Exchange Info
Instrument specifications for spot pairs: tick size, lot size, minimum
/v1/finance:binance/exchange-infoParameters
| Name | Type | In | Description |
|---|---|---|---|
| symbol | string | query | One pair. Accepts BTCUSDT, BTC/USDT or btc_usdt. |
| symbols | string | query | Several pairs, comma separated. Max 100. |
| quote | enum | query | Restrict to pairs quoted in this asset when no symbol is given. Default USDT. One of all, USDT, USDC, BTC, ETH, BNB, FDUSD, TRY, EUR. |
| search | string | query | Filter by base asset. |
| status | enum | query | Keep only tradable pairs, or all listed ones. Default trading. One of all, trading. |
| count | number | query | Rows to return. Default 100, max 500. |
Example response
{"project":"finance:binance", "data": {"count":100, "items": [ {"base":"0G","quote":"USDT","maxQty":92141578,"minQty":0.01,"status":"TRADING","symbol":"0GUSDT", "filters": { "lotSize": {"maxQty":92141578,"minQty":0.01,"stepSize":0.01 }, "notional": {"maxNotional":9000000,"minNotional":5,"avgPriceMins":5,"applyMaxToMarket":false,"applyMinToMarket":true }, "priceFilter": {"maxPrice":1000,"minPrice":0.0001,"tickSize":0.0001 }, "icebergParts": {"limit":100 }, "maxNumOrders": {"maxNumOrders":200 }, "marketLotSize": {"maxQty":216165.06770833,"minQty":0,"stepSize":0 }, "trailingDelta": {"maxTrailingAboveDelta":2000,"maxTrailingBelowDelta":2000,"minTrailingAboveDelta":10,"minTrailingBelowDelta":10 }, "maxNumAlgoOrders": {"maxNumAlgoOrders":5 }, "maxNumOrderLists": {"maxNumOrderLists":20 }, "maxNumOrderAmends": {"maxNumOrderAmends":10 }, "percentPriceBySide": {"avgPriceMins":5,"askMultiplierUp":2,"bidMultiplierUp":1.1,"askMultiplierDown":0.9,"bidMultiplierDown":0.5 } },"maxPrice":1000,"minPrice":0.0001,"stepSize":0.01,"tickSize":0.0001,"ocoAllowed":true,"opoAllowed":true, "orderTypes": [ "LIMIT" ],"otoAllowed":true,"maxNotional":9000000,"minNotional":5, "permissions": [ "SPOT" ],"amendAllowed":true,"basePrecision":8,"icebergAllowed":true,"quotePrecision":8,"allowTrailingStop":true,"cancelReplaceAllowed":true,"isSpotTradingAllowed":true,"quoteAmountPrecision":8,"isMarginTradingAllowed":true,"pegInstructionsAllowed":true,"baseCommissionPrecision":8,"quoteCommissionPrecision":8, "selfTradePreventionModes": [ "EXPIRE_TAKER" ],"quoteOrderQtyMarketAllowed":true,"defaultSelfTradePreventionMode":"EXPIRE_MAKER" } ],"quote":"USDT","total":484,"exchange":"binance", "rateLimits": [ {"type":"REQUEST_WEIGHT","limit":6000,"interval":"MINUTE","intervalNum":1 } ],"serverTime":1787238332343,"serverTimeIso":"2026-08-20T15:05:32.343Z" },"timestamp":"2026-08-02T04:20:59Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Ticker Windowed
Rolling-window statistics for one spot pair — the same shape as the 24-hour
/v1/finance:binance/ticker-windowedParameters
| Name | Type | In | Description |
|---|---|---|---|
| symbol | string | query | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt. Required. |
| windowSize | string | query | Window length: 1m-59m, 1h-23h or 1d-7d. Default 1d. |
Example response
{"project":"finance:binance", "data": {"low":71132,"high":72564.01,"last":72117.99,"open":71968.47,"change":149.52,"symbol":"BTCUSDT","exchange":"binance","openTime":1787224620000,"closeTime":1787239061402,"tradeCount":1543516,"volumeBase":7298.47648,"windowSize":"4h","openTimeIso":"2026-08-20T11:17:00.000Z","volumeQuote":524344946.5365594,"closeTimeIso":"2026-08-20T15:17:41.402Z","changePercent":0.208,"weightedAvgPrice":71843.06861486 },"timestamp":"2026-08-02T04:20:59Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Time
The venue's own clock, and how far ours has drifted from it.
/v1/finance:binance/timeParameters
No parameters. Call it as is.
Example response
{"project":"finance:binance", "data": {"driftMs":0,"exchange":"binance","serverTime":1787238365364,"roundTripMs":84,"serverTimeIso":"2026-08-20T15:06:05.364Z" },"timestamp":"2026-08-02T04:20:59Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Trades
The most recent prints on one spot pair — the raw tape, one row per fill.
/v1/finance:binance/tradesParameters
| Name | Type | In | Description |
|---|---|---|---|
| symbol | string | query | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt. Required. |
| count | number | query | Trades to return, newest last. Default 100, max 1000. |
Example response
{"project":"finance:binance", "data": {"count":100, "items": [ {"side":"sell","time":1787239085331,"price":72116.14,"amount":0.00383,"timeIso":"2026-08-20T15:18:05.331Z","tradeId":6588632930,"amountQuote":276.2048162,"isBuyerMaker":true }, {"side":"sell","time":1787239085331,"price":72116.04,"amount":0.00008,"timeIso":"2026-08-20T15:18:05.331Z","tradeId":6588632931,"amountQuote":5.7692832,"isBuyerMaker":true }, {"side":"sell","time":1787239085331,"price":72116.01,"amount":0.00008,"timeIso":"2026-08-20T15:18:05.331Z","tradeId":6588632932,"amountQuote":5.7692808,"isBuyerMaker":true }, {"side":"sell","time":1787239085331,"price":72116.01,"amount":0.00008,"timeIso":"2026-08-20T15:18:05.331Z","tradeId":6588632933,"amountQuote":5.7692808,"isBuyerMaker":true }, {"side":"sell","time":1787239085331,"price":72116.01,"amount":0.00008,"timeIso":"2026-08-20T15:18:05.331Z","tradeId":6588632934,"amountQuote":5.7692808,"isBuyerMaker":true }, {"side":"sell","time":1787239085331,"price":72116,"amount":0.00448,"timeIso":"2026-08-20T15:18:05.331Z","tradeId":6588632935,"amountQuote":323.07968,"isBuyerMaker":true } ],"symbol":"BTCUSDT","exchange":"binance" },"timestamp":"2026-08-02T04:20:59Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
UI Klines
Display-optimised candles for one spot pair. Same positional row shape as
/v1/finance:binance/ui-klinesParameters
| Name | Type | In | Description |
|---|---|---|---|
| symbol | string | query | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt. Required. |
| interval | enum | query | Candle size. Default 1d. One of 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M. |
| count | number | query | Number of candles. Default 200, max 1000. |
| startTime | string | query | Oldest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds. |
| endTime | string | query | Newest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds. |
Example response
{"project":"finance:binance", "data": {"count":61,"symbol":"BTCUSDT", "candles": [ {"low":42180.77,"date":"2024-01-01T00:00:00.000Z","high":44184.1,"open":42283.58,"close":44179.55,"openTime":1704067200000,"closeTime":1704153599999,"tradeCount":1114623,"volumeBase":27174.29903,"volumeQuote":1169995682.0280013 }, {"low":44148.34,"date":"2024-01-02T00:00:00.000Z","high":45879.63,"open":44179.55,"close":44946.91,"openTime":1704153600000,"closeTime":1704239999999,"tradeCount":2247532,"volumeBase":65146.40661,"volumeQuote":2944331821.8230762 }, {"low":40750,"date":"2024-01-03T00:00:00.000Z","high":45500,"open":44946.91,"close":42845.23,"openTime":1704240000000,"closeTime":1704326399999,"tradeCount":2658041,"volumeBase":81194.55173,"volumeQuote":3507104563.744232 } ],"exchange":"binance","interval":"1d" },"timestamp":"2026-08-02T04:20:59Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
const data = await client.run( "finance:binance", "ticker", { symbol: "BTCUSDT" });
Binance
Global crypto spot market data — 24h statistics, candles and order book depth from the largest venue.
24-hour statistics for one spot pair.
/v1/…binance/tickerTry it
Parameters
symbol
string · query · required
Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt.
Example response
{"project":"finance:binance", "data": {"ask":72149.62,"bid":72149.61,"low":66592.3,"high":72564.01,"last":72149.61,"open":66676.28,"askQty":1.80702,"bidQty":0.32444,"change":5473.33,"symbol":"BTCUSDT","exchange":"binance","openTime":1787152673012,"closeTime":1787239073012,"tradeCount":7028422,"volumeBase":45179.29453,"volumeQuote":3162142746.4771805,"changePercent":8.209,"previousClose":66676.28,"weightedAvgPrice":69990.97217814 },"timestamp":"2026-08-02T04:20:59Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Code
const data = await client.run( "finance:binance", "ticker", { symbol: "BTCUSDT" });