# Binance — Zapi reference > Global crypto spot market data — 24h statistics, candles and order book depth from the largest venue. **Base URL:** `https://api.zapi.ink` **Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zapi.ink/dashboard/keys. **Response envelope:** `{ content, message, errors }` **Rate limit:** 60 req/min on free tier. **Related:** - Detail page: https://zapi.ink/api/finance/binance - Endpoint catalog: https://zapi.ink/category/finance - Concise index: https://zapi.ink/llms.txt - Full reference: https://zapi.ink/llms-full.txt --- ## Binance **Category:** finance · **Slug:** `binance` **Detail page:** https://zapi.ink/api/finance/binance Global crypto spot market data — 24h statistics, candles and order book depth from the largest venue. **Tags:** crypto, exchange, orderbook, klines, usdt ### Ticker 24-hour statistics for one spot pair. - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance/ticker` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance/ticker?symbol=BTCUSDT" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance/ticker?symbol=BTCUSDT", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zapi.ink/v1/finance:binance/ticker?symbol=BTCUSDT", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "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 } ``` --- ### Tickers Every spot pair at once, filterable by quote asset. - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance/tickers` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `quote` | enum(all|USDT|USDC|BTC|ETH|BNB|FDUSD|TRY|EUR) | query | no | Restrict to pairs quoted in this asset. Default USDT | | `search` | string | query | no | Filter by base asset | | `sort` | enum(volume|change|symbol) | query | no | Sort key, descending for volume and change. Default volume | | `count` | number | query | no | Rows to return. Default 100, max 500 | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance/tickers?quote=USDT&search=btc&sort=volume&count=100" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance/tickers?quote=USDT&search=btc&sort=volume&count=100", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zapi.ink/v1/finance:binance/tickers?quote=USDT&search=btc&sort=volume&count=100", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "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" } ``` --- ### Klines OHLCV candles from one minute to one month. - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance/klines` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt | | `interval` | enum(1m|3m|5m|15m|30m|1h|2h|4h|6h|8h|12h|1d|3d|1w|1M) | query | no | Candle size. Default 1d | | `count` | number | query | no | Number of candles. Default 200, max 1000 | | `limit` | number | query | no | Alias for count, and wins when both are sent. Max 1000 | | `startTime` | string | query | no | Oldest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds | | `endTime` | string | query | no | Newest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance/klines?symbol=BTCUSDT&interval=1d&count=200&limit=1000&startTime=2024-01-01&endTime=2024-03-01" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance/klines?symbol=BTCUSDT&interval=1d&count=200&limit=1000&startTime=2024-01-01&endTime=2024-03-01", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zapi.ink/v1/finance:binance/klines?symbol=BTCUSDT&interval=1d&count=200&limit=1000&startTime=2024-01-01&endTime=2024-03-01", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "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 }, { "low": 42613.77, "date": "2024-01-04T00:00:00.000Z", "high": 44729.58, "open": 42845.23, "close": 44151.1, "openTime": 1704326400000, "closeTime": 1704412799999, "tradeCount": 1819944, "volumeBase": 48038.06334, "volumeQuote": 2095095359.4936347 }, { "low": 42450, "date": "2024-01-05T00:00:00.000Z", "high": 44357.46, "open": 44151.1, "close": 44145.11, "openTime": 1704412800000, "closeTime": 1704499199999, "tradeCount": 2064845, "volumeBase": 48075.25327, "volumeQuote": 2100953924.3687155 }, { "low": 43397.05, "date": "2024-01-06T00:00:00.000Z", "high": 44214.42, "open": 44145.12, "close": 43968.32, "openTime": 1704499200000, "closeTime": 1704585599999, "tradeCount": 956642, "volumeBase": 17835.06144, "volumeQuote": 781212883.4916061 } ], "exchange": "binance", "interval": "1d" } ``` --- ### Order book Resting bids and asks for one spot pair. - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance/depth` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt | | `limit` | number | query | no | Levels per side. Default 50, max 500 | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance/depth?symbol=BTCUSDT&limit=50" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance/depth?symbol=BTCUSDT&limit=50", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zapi.ink/v1/finance:binance/depth?symbol=BTCUSDT&limit=50", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "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" } ``` --- ### Agg Trades Compressed trades for one spot pair: fills at the same price, from the same - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance/agg-trades` - **Cache TTL:** 5s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt | | `count` | number | query | no | Rows to return, newest last. Default 500, max 1000 | | `startTime` | string | query | no | Window start, inclusive. ISO timestamp or epoch milliseconds | | `endTime` | string | query | no | Window end, inclusive. ISO timestamp or epoch milliseconds | | `fromId` | string | query | no | Resume from this aggregate trade id instead of a time window | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance/agg-trades?symbol=BTCUSDT&count=500&startTime=2024-01-01T00%3A00%3A00Z&endTime=2024-01-01T01%3A00%3A00Z&fromId=4036984393" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance/agg-trades?symbol=BTCUSDT&count=500&startTime=2024-01-01T00%3A00%3A00Z&endTime=2024-01-01T01%3A00%3A00Z&fromId=4036984393", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zapi.ink/v1/finance:binance/agg-trades?symbol=BTCUSDT&count=500&startTime=2024-01-01T00%3A00%3A00Z&endTime=2024-01-01T01%3A00%3A00Z&fromId=4036984393", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "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 }, { "side": "buy", "time": 1787184000416, "price": 69334.79, "amount": 1, "timeIso": "2026-08-20T00:00:00.416Z", "aggTradeId": 4036091188, "tradeCount": 2, "amountQuote": 69334.79, "lastTradeId": 6584309791, "firstTradeId": 6584309790, "isBuyerMaker": false }, { "side": "sell", "time": 1787184000440, "price": 69334.78, "amount": 0.00144, "timeIso": "2026-08-20T00:00:00.440Z", "aggTradeId": 4036091189, "tradeCount": 1, "amountQuote": 99.8420832, "lastTradeId": 6584309792, "firstTradeId": 6584309792, "isBuyerMaker": true }, { "side": "buy", "time": 1787184000589, "price": 69334.79, "amount": 0.006, "timeIso": "2026-08-20T00:00:00.589Z", "aggTradeId": 4036091190, "tradeCount": 2, "amountQuote": 416.00874, "lastTradeId": 6584309794, "firstTradeId": 6584309793, "isBuyerMaker": false } ], "symbol": "BTCUSDT", "exchange": "binance" } ``` --- ### Avg Price The venue's own rolling average price for one spot pair — the reference the - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance/avg-price` - **Cache TTL:** 10s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance/avg-price?symbol=BTCUSDT" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance/avg-price?symbol=BTCUSDT", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zapi.ink/v1/finance:binance/avg-price?symbol=BTCUSDT", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "price": 72259.18437849, "symbol": "BTCUSDT", "exchange": "binance", "closeTime": 1787239013380, "closeTimeIso": "2026-08-20T15:16:53.380Z", "windowMinutes": 5 } ``` --- ### Book Ticker Best bid and ask for one spot pair — the top of the book without the depth. - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance/book-ticker` - **Cache TTL:** 5s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance/book-ticker?symbol=BTCUSDT" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance/book-ticker?symbol=BTCUSDT", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zapi.ink/v1/finance:binance/book-ticker?symbol=BTCUSDT", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "ask": 72205.99, "bid": 72205.98, "askQty": 0.00021, "bidQty": 0.43904, "spread": 0.01, "symbol": "BTCUSDT", "exchange": "binance", "spreadPercent": 0.000014 } ``` --- ### Exchange Info Instrument specifications for spot pairs: tick size, lot size, minimum - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance/exchange-info` - **Cache TTL:** 600s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | no | One pair. Accepts BTCUSDT, BTC/USDT or btc_usdt | | `symbols` | string | query | no | Several pairs, comma separated. Max 100 | | `quote` | enum(all|USDT|USDC|BTC|ETH|BNB|FDUSD|TRY|EUR) | query | no | Restrict to pairs quoted in this asset when no symbol is given. Default USDT | | `search` | string | query | no | Filter by base asset | | `status` | enum(all|trading) | query | no | Keep only tradable pairs, or all listed ones. Default trading | | `count` | number | query | no | Rows to return. Default 100, max 500 | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance/exchange-info?symbol=BTCUSDT&symbols=BTCUSDT%2CETHUSDT"e=USDT&search=btc&status=trading&count=100" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance/exchange-info?symbol=BTCUSDT&symbols=BTCUSDT%2CETHUSDT"e=USDT&search=btc&status=trading&count=100", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zapi.ink/v1/finance:binance/exchange-info?symbol=BTCUSDT&symbols=BTCUSDT%2CETHUSDT"e=USDT&search=btc&status=trading&count=100", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "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", "LIMIT_MAKER", "MARKET", "STOP_LOSS", "STOP_LOSS_LIMIT", "TAKE_PROFIT" ], "otoAllowed": true, "maxNotional": 9000000, "minNotional": 5, "permissions": [ "SPOT", "MARGIN" ], "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", "EXPIRE_MAKER", "EXPIRE_BOTH", "DECREMENT", "TRANSFER" ], "quoteOrderQtyMarketAllowed": true, "defaultSelfTradePreventionMode": "EXPIRE_MAKER" }, { "base": "1000CAT", "quote": "USDT", "maxQty": 92141578, "minQty": 0.1, "status": "TRADING", "symbol": "1000CATUSDT", "filters": { "lotSize": { "maxQty": 92141578, "minQty": 0.1, "stepSize": 0.1 }, "notional": { "maxNotional": 9000000, "minNotional": 1, "avgPriceMins": 5, "applyMaxToMarket": false, "applyMinToMarket": true }, "priceFilter": { "maxPrice": 1000, "minPrice": 0.000001, "tickSize": 0.000001 }, "icebergParts": { "limit": 100 }, "maxNumOrders": { "maxNumOrders": 200 }, "marketLotSize": { "maxQty": 2165383.17, "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.000001, "stepSize": 0.1, "tickSize": 0.000001, "ocoAllowed": true, "opoAllowed": true, "orderTypes": [ "LIMIT", "LIMIT_MAKER", "MARKET", "STOP_LOSS", "STOP_LOSS_LIMIT", "TAKE_PROFIT" ], "otoAllowed": true, "maxNotional": 9000000, "minNotional": 1, "permissions": [ "SPOT", "MARGIN" ], "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", "EXPIRE_MAKER", "EXPIRE_BOTH", "DECREMENT", "TRANSFER" ], "quoteOrderQtyMarketAllowed": true, "defaultSelfTradePreventionMode": "EXPIRE_MAKER" }, { "base": "1000CHEEMS", "quote": "USDT", "maxQty": 36348600000, "minQty": 1, "status": "TRADING", "symbol": "1000CHEEMSUSDT", "filters": { "lotSize": { "maxQty": 36348600000, "minQty": 1, "stepSize": 1 }, "notional": { "maxNotional": 9000000, "minNotional": 1, "avgPriceMins": 5, "applyMaxToMarket": false, "applyMinToMarket": true }, "priceFilter": { "maxPrice": 1, "minPrice": 0.000001, "tickSize": 0.000001 }, "icebergParts": { "limit": 100 }, "maxNumOrders": { "maxNumOrders": 200 }, "marketLotSize": { "maxQty": 66530920.85, "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": 1, "minPrice": 0.000001, "stepSize": 1, "tickSize": 0.000001, "ocoAllowed": true, "opoAllowed": true, "orderTypes": [ "LIMIT", "LIMIT_MAKER", "MARKET", "STOP_LOSS", "STOP_LOSS_LIMIT", "TAKE_PROFIT" ], "otoAllowed": true, "maxNotional": 9000000, "minNotional": 1, "permissions": [ "SPOT", "MARGIN" ], "amendAllowed": true, "basePrecision": 2, "icebergAllowed": true, "quotePrecision": 8, "allowTrailingStop": true, "cancelReplaceAllowed": true, "isSpotTradingAllowed": true, "quoteAmountPrecision": 8, "isMarginTradingAllowed": true, "pegInstructionsAllowed": true, "baseCommissionPrecision": 2, "quoteCommissionPrecision": 8, "selfTradePreventionModes": [ "EXPIRE_TAKER", "EXPIRE_MAKER", "EXPIRE_BOTH", "DECREMENT", "TRANSFER" ], "quoteOrderQtyMarketAllowed": true, "defaultSelfTradePreventionMode": "EXPIRE_MAKER" }, { "base": "1000SATS", "quote": "USDT", "maxQty": 36348600000, "minQty": 1, "status": "TRADING", "symbol": "1000SATSUSDT", "filters": { "lotSize": { "maxQty": 36348600000, "minQty": 1, "stepSize": 1 }, "notional": { "maxNotional": 9000000, "minNotional": 1, "avgPriceMins": 5, "applyMaxToMarket": false, "applyMinToMarket": true }, "priceFilter": { "maxPrice": 1, "minPrice": 1e-8, "tickSize": 1e-8 }, "icebergParts": { "limit": 100 }, "maxNumOrders": { "maxNumOrders": 200 }, "marketLotSize": { "maxQty": 1247040905.75, "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": 1, "minPrice": 1e-8, "stepSize": 1, "tickSize": 1e-8, "ocoAllowed": true, "opoAllowed": true, "orderTypes": [ "LIMIT", "LIMIT_MAKER", "MARKET", "STOP_LOSS", "STOP_LOSS_LIMIT", "TAKE_PROFIT" ], "otoAllowed": true, "maxNotional": 9000000, "minNotional": 1, "permissions": [ "SPOT", "MARGIN" ], "amendAllowed": true, "basePrecision": 2, "icebergAllowed": true, "quotePrecision": 8, "allowTrailingStop": true, "cancelReplaceAllowed": true, "isSpotTradingAllowed": true, "quoteAmountPrecision": 8, "isMarginTradingAllowed": true, "pegInstructionsAllowed": true, "baseCommissionPrecision": 2, "quoteCommissionPrecision": 8, "selfTradePreventionModes": [ "EXPIRE_TAKER", "EXPIRE_MAKER", "EXPIRE_BOTH", "DECREMENT", "TRANSFER" ], "quoteOrderQtyMarketAllowed": true, "defaultSelfTradePreventionMode": "EXPIRE_MAKER" }, { "base": "1INCH", "quote": "USDT", "maxQty": 900000, "minQty": 0.1, "status": "TRADING", "symbol": "1INCHUSDT", "filters": { "lotSize": { "maxQty": 900000, "minQty": 0.1, "stepSize": 0.1 }, "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": 345881.80373443, "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.1, "tickSize": 0.0001, "ocoAllowed": true, "opoAllowed": true, "orderTypes": [ "LIMIT", "LIMIT_MAKER", "MARKET", "STOP_LOSS", "STOP_LOSS_LIMIT", "TAKE_PROFIT" ], "otoAllowed": true, "maxNotional": 9000000, "minNotional": 5, "permissions": [ "SPOT", "MARGIN" ], "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", "EXPIRE_MAKER", "EXPIRE_BOTH", "DECREMENT", "TRANSFER" ], "quoteOrderQtyMarketAllowed": true, "defaultSelfTradePreventionMode": "EXPIRE_MAKER" }, { "base": "1MBABYDOGE", "quote": "USDT", "maxQty": 36348600000, "minQty": 1, "status": "TRADING", "symbol": "1MBABYDOGEUSDT", "filters": { "lotSize": { "maxQty": 36348600000, "minQty": 1, "stepSize": 1 }, "notional": { "maxNotional": 9000000, "minNotional": 1, "avgPriceMins": 5, "applyMaxToMarket": false, "applyMinToMarket": true }, "priceFilter": { "maxPrice": 1, "minPrice": 1e-7, "tickSize": 1e-7 }, "icebergParts": { "limit": 100 }, "maxNumOrders": { "maxNumOrders": 200 }, "marketLotSize": { "maxQty": 28592177.15, "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": 1, "minPrice": 1e-7, "stepSize": 1, "tickSize": 1e-7, "ocoAllowed": true, "opoAllowed": true, "orderTypes": [ "LIMIT", "LIMIT_MAKER", "MARKET", "STOP_LOSS", "STOP_LOSS_LIMIT", "TAKE_PROFIT" ], "otoAllowed": true, "maxNotional": 9000000, "minNotional": 1, "permissions": [ "SPOT", "MARGIN" ], "amendAllowed": true, "basePrecision": 2, "icebergAllowed": true, "quotePrecision": 8, "allowTrailingStop": true, "cancelReplaceAllowed": true, "isSpotTradingAllowed": true, "quoteAmountPrecision": 8, "isMarginTradingAllowed": true, "pegInstructionsAllowed": true, "baseCommissionPrecision": 2, "quoteCommissionPrecision": 8, "selfTradePreventionModes": [ "EXPIRE_TAKER", "EXPIRE_MAKER", "EXPIRE_BOTH", "DECREMENT", "TRANSFER" ], "quoteOrderQtyMarketAllowed": true, "defaultSelfTradePreventionMode": "EXPIRE_MAKER" } ], "quote": "USDT", "total": 484, "exchange": "binance", "rateLimits": [ { "type": "REQUEST_WEIGHT", "limit": 6000, "interval": "MINUTE", "intervalNum": 1 }, { "type": "ORDERS", "limit": 100, "interval": "SECOND", "intervalNum": 10 }, { "type": "ORDERS", "limit": 200000, "interval": "DAY", "intervalNum": 1 }, { "type": "RAW_REQUESTS", "limit": 300000, "interval": "MINUTE", "intervalNum": 5 } ], "serverTime": 1787238332343, "serverTimeIso": "2026-08-20T15:05:32.343Z" } ``` --- ### Ticker Windowed Rolling-window statistics for one spot pair — the same shape as the 24-hour - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance/ticker-windowed` - **Cache TTL:** 15s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt | | `windowSize` | string | query | no | Window length: 1m-59m, 1h-23h or 1d-7d. Default 1d | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance/ticker-windowed?symbol=BTCUSDT&windowSize=4h" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance/ticker-windowed?symbol=BTCUSDT&windowSize=4h", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zapi.ink/v1/finance:binance/ticker-windowed?symbol=BTCUSDT&windowSize=4h", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "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 } ``` --- ### Time The venue's own clock, and how far ours has drifted from it. - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance/time` **Parameters:** _No parameters._ **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance/time" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance/time", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zapi.ink/v1/finance:binance/time", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "driftMs": 0, "exchange": "binance", "serverTime": 1787238365364, "roundTripMs": 84, "serverTimeIso": "2026-08-20T15:06:05.364Z" } ``` --- ### Trades The most recent prints on one spot pair — the raw tape, one row per fill. - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance/trades` - **Cache TTL:** 5s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt | | `count` | number | query | no | Trades to return, newest last. Default 100, max 1000 | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance/trades?symbol=BTCUSDT&count=100" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance/trades?symbol=BTCUSDT&count=100", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zapi.ink/v1/finance:binance/trades?symbol=BTCUSDT&count=100", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "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" } ``` --- ### UI Klines Display-optimised candles for one spot pair. Same positional row shape as - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance/ui-klines` - **Cache TTL:** 30s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt | | `interval` | enum(1m|3m|5m|15m|30m|1h|2h|4h|6h|8h|12h|1d|3d|1w|1M) | query | no | Candle size. Default 1d | | `count` | number | query | no | Number of candles. Default 200, max 1000 | | `startTime` | string | query | no | Oldest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds | | `endTime` | string | query | no | Newest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance/ui-klines?symbol=BTCUSDT&interval=1d&count=200&startTime=2024-01-01&endTime=2024-03-01" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance/ui-klines?symbol=BTCUSDT&interval=1d&count=200&startTime=2024-01-01&endTime=2024-03-01", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zapi.ink/v1/finance:binance/ui-klines?symbol=BTCUSDT&interval=1d&count=200&startTime=2024-01-01&endTime=2024-03-01", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "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 }, { "low": 42613.77, "date": "2024-01-04T00:00:00.000Z", "high": 44729.58, "open": 42845.23, "close": 44151.1, "openTime": 1704326400000, "closeTime": 1704412799999, "tradeCount": 1819944, "volumeBase": 48038.06334, "volumeQuote": 2095095359.4936347 }, { "low": 42450, "date": "2024-01-05T00:00:00.000Z", "high": 44357.46, "open": 44151.1, "close": 44145.11, "openTime": 1704412800000, "closeTime": 1704499199999, "tradeCount": 2064845, "volumeBase": 48075.25327, "volumeQuote": 2100953924.3687155 }, { "low": 43397.05, "date": "2024-01-06T00:00:00.000Z", "high": 44214.42, "open": 44145.12, "close": 43968.32, "openTime": 1704499200000, "closeTime": 1704585599999, "tradeCount": 956642, "volumeBase": 17835.06144, "volumeQuote": 781212883.4916061 } ], "exchange": "binance", "interval": "1d" } ``` --- _Generated: 2026-09-25T14:29:23.226Z_