# Binance Futures — Zapi reference > USD-M perpetual futures market data: funding, premium index, open interest, long/short ratios, candles and depth. **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-futures - Endpoint catalog: https://zapi.ink/category/finance - Concise index: https://zapi.ink/llms.txt - Full reference: https://zapi.ink/llms-full.txt --- ## Binance Futures **Category:** finance · **Slug:** `binance-futures` **Detail page:** https://zapi.ink/api/finance/binance-futures USD-M perpetual futures market data: funding, premium index, open interest, long/short ratios, candles and depth. **Tags:** binance, futures, perpetual, funding, open-interest, crypto ### Agg Trades Compressed trades for one contract: fills at the same price, from the same - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/agg-trades` - **Cache TTL:** 5s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925 | | `count` | number | query | no | Rows to return, newest last. Default 500, max 1000 | | `startTime` | string | query | no | Window start, inclusive. Only the last 2 days exist. 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-futures/agg-trades?symbol=BTCUSDT&count=500&startTime=2026-08-20T00%3A00%3A00Z&endTime=2026-08-20T01%3A00%3A00Z&fromId=3413731512" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance-futures/agg-trades?symbol=BTCUSDT&count=500&startTime=2026-08-20T00%3A00%3A00Z&endTime=2026-08-20T01%3A00%3A00Z&fromId=3413731512", { 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-futures/agg-trades?symbol=BTCUSDT&count=500&startTime=2026-08-20T00%3A00%3A00Z&endTime=2026-08-20T01%3A00%3A00Z&fromId=3413731512", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "count": 500, "items": [ { "side": "sell", "time": 1787475008113, "price": 76494, "amount": 0.003, "timeIso": "2026-08-23T08:50:08.113Z", "aggTradeId": 3422194533, "tradeCount": 1, "amountQuote": 229.482, "lastTradeId": 8005543997, "firstTradeId": 8005543997, "isBuyerMaker": true }, { "side": "sell", "time": 1787475008380, "price": 76494, "amount": 0.1, "timeIso": "2026-08-23T08:50:08.380Z", "aggTradeId": 3422194534, "tradeCount": 1, "amountQuote": 7649.4, "lastTradeId": 8005543998, "firstTradeId": 8005543998, "isBuyerMaker": true }, { "side": "buy", "time": 1787475008621, "price": 76494.1, "amount": 0.128, "timeIso": "2026-08-23T08:50:08.621Z", "aggTradeId": 3422194535, "tradeCount": 1, "amountQuote": 9791.2448, "lastTradeId": 8005543999, "firstTradeId": 8005543999, "isBuyerMaker": false }, { "side": "buy", "time": 1787475008783, "price": 76494.1, "amount": 0.001, "timeIso": "2026-08-23T08:50:08.783Z", "aggTradeId": 3422194536, "tradeCount": 1, "amountQuote": 76.4941, "lastTradeId": 8005544000, "firstTradeId": 8005544000, "isBuyerMaker": false }, { "side": "sell", "time": 1787475009208, "price": 76494, "amount": 0.339, "timeIso": "2026-08-23T08:50:09.208Z", "aggTradeId": 3422194537, "tradeCount": 2, "amountQuote": 25931.466, "lastTradeId": 8005544002, "firstTradeId": 8005544001, "isBuyerMaker": true }, { "side": "buy", "time": 1787475009388, "price": 76494.1, "amount": 0.644, "timeIso": "2026-08-23T08:50:09.388Z", "aggTradeId": 3422194538, "tradeCount": 2, "amountQuote": 49262.2004, "lastTradeId": 8005544004, "firstTradeId": 8005544003, "isBuyerMaker": false }, { "side": "sell", "time": 1787475009411, "price": 76494, "amount": 0.001, "timeIso": "2026-08-23T08:50:09.411Z", "aggTradeId": 3422194539, "tradeCount": 1, "amountQuote": 76.494, "lastTradeId": 8005544005, "firstTradeId": 8005544005, "isBuyerMaker": true }, { "side": "sell", "time": 1787475009555, "price": 76494, "amount": 0.001, "timeIso": "2026-08-23T08:50:09.555Z", "aggTradeId": 3422194540, "tradeCount": 1, "amountQuote": 76.494, "lastTradeId": 8005544006, "firstTradeId": 8005544006, "isBuyerMaker": true } ], "symbol": "BTCUSDT", "exchange": "binance" } ``` --- ### Basis The gap between a futures contract and its index — the carry a calendar spread - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/basis` - **Cache TTL:** 60s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `pair` | string | query | yes | Underlying pair, not a contract symbol. Accepts BTCUSDT, BTC/USDT or btc_usdt | | `contractType` | enum(PERPETUAL|CURRENT_QUARTER|NEXT_QUARTER) | query | no | Which contract to measure against the index. Default PERPETUAL | | `period` | enum(5m|15m|30m|1h|2h|4h|6h|12h|1d) | query | no | Bucket size. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d — the upstream refuses 8h. Default 1d | | `count` | number | query | no | Rows to return, oldest first. Default 30, max 1000 | | `startTime` | string | query | no | Window start, inclusive. Only the last 30 days exist. ISO date or epoch milliseconds | | `endTime` | string | query | no | Window end, inclusive. ISO date or epoch milliseconds | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance-futures/basis?pair=BTCUSDT&contractType=PERPETUAL&period=1d&count=30&startTime=2026-08-01&endTime=2026-08-20" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance-futures/basis?pair=BTCUSDT&contractType=PERPETUAL&period=1d&count=30&startTime=2026-08-01&endTime=2026-08-20", { 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-futures/basis?pair=BTCUSDT&contractType=PERPETUAL&period=1d&count=30&startTime=2026-08-01&endTime=2026-08-20", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "pair": "BTCUSDT", "count": 30, "items": [ { "pair": "BTCUSDT", "time": 1784851200000, "basis": -23.30565217, "timeIso": "2026-07-24T00:00:00.000Z", "basisRate": -0.0004, "indexPrice": 65092.90565217, "contractType": "PERPETUAL", "futuresPrice": 65069.6, "basisRatePercent": -0.04, "annualizedBasisRate": null }, { "pair": "BTCUSDT", "time": 1784937600000, "basis": -25.11326087, "timeIso": "2026-07-25T00:00:00.000Z", "basisRate": -0.0004, "indexPrice": 64141.61326087, "contractType": "PERPETUAL", "futuresPrice": 64116.5, "basisRatePercent": -0.04, "annualizedBasisRate": null }, { "pair": "BTCUSDT", "time": 1785024000000, "basis": -32.31065217, "timeIso": "2026-07-26T00:00:00.000Z", "basisRate": -0.0005, "indexPrice": 64370.31065217, "contractType": "PERPETUAL", "futuresPrice": 64338, "basisRatePercent": -0.05, "annualizedBasisRate": null }, { "pair": "BTCUSDT", "time": 1785110400000, "basis": -22.22543478, "timeIso": "2026-07-27T00:00:00.000Z", "basisRate": -0.0003, "indexPrice": 65397.42543478, "contractType": "PERPETUAL", "futuresPrice": 65375.2, "basisRatePercent": -0.03, "annualizedBasisRate": null }, { "pair": "BTCUSDT", "time": 1785196800000, "basis": -38.985, "timeIso": "2026-07-28T00:00:00.000Z", "basisRate": -0.0006, "indexPrice": 63759.685, "contractType": "PERPETUAL", "futuresPrice": 63720.7, "basisRatePercent": -0.06, "annualizedBasisRate": null }, { "pair": "BTCUSDT", "time": 1785283200000, "basis": -19.45391304, "timeIso": "2026-07-29T00:00:00.000Z", "basisRate": -0.0003, "indexPrice": 63923.05391304, "contractType": "PERPETUAL", "futuresPrice": 63903.6, "basisRatePercent": -0.03, "annualizedBasisRate": null }, { "pair": "BTCUSDT", "time": 1785369600000, "basis": -23.42782609, "timeIso": "2026-07-30T00:00:00.000Z", "basisRate": -0.0004, "indexPrice": 63982.32782609, "contractType": "PERPETUAL", "futuresPrice": 63958.9, "basisRatePercent": -0.04, "annualizedBasisRate": null }, { "pair": "BTCUSDT", "time": 1785456000000, "basis": -31.32608696, "timeIso": "2026-07-31T00:00:00.000Z", "basisRate": -0.0005, "indexPrice": 64781.32608696, "contractType": "PERPETUAL", "futuresPrice": 64750, "basisRatePercent": -0.05, "annualizedBasisRate": null } ], "period": "1d", "exchange": "binance", "contractType": "PERPETUAL" } ``` --- ### Book Ticker Best bid and ask on one contract — the top of the book without the depth. - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/book-ticker` - **Cache TTL:** 5s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925 | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance-futures/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-futures/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-futures/book-ticker?symbol=BTCUSDT", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "ask": 76473.8, "bid": 76473.7, "time": 1787475074031, "askQty": 6.642, "bidQty": 4.499, "spread": 0.1, "symbol": "BTCUSDT", "timeIso": "2026-08-23T08:51:14.031Z", "exchange": "binance", "spreadPercent": 0.000131 } ``` --- ### Continuous Klines OHLCV candles for a continuous contract: one unbroken series across successive - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/continuous-klines` - **Cache TTL:** 30s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `pair` | string | query | yes | Underlying pair, not a contract symbol. Accepts BTCUSDT, BTC/USDT or btc_usdt | | `contractType` | enum(PERPETUAL|CURRENT_QUARTER|NEXT_QUARTER|TRADIFI_PERPETUAL) | query | no | Which contract in the series. Default PERPETUAL | | `interval` | enum(1m|3m|5m|15m|30m|1h|2h|4h|6h|8h|12h|1d|3d|1w|1M) | query | no | Candle size. Default 1d. Unlike spot there is no 1s candle | | `count` | number | query | no | Number of candles. Default 500, max 1500 — higher than spot's 1000, and 1501 is refused outright | | `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-futures/continuous-klines?pair=BTCUSDT&contractType=PERPETUAL&interval=1d&count=500&startTime=2026-01-01&endTime=2026-03-01" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance-futures/continuous-klines?pair=BTCUSDT&contractType=PERPETUAL&interval=1d&count=500&startTime=2026-01-01&endTime=2026-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-futures/continuous-klines?pair=BTCUSDT&contractType=PERPETUAL&interval=1d&count=500&startTime=2026-01-01&endTime=2026-03-01", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "pair": "BTCUSDT", "count": 500, "candles": [ { "low": 78935.5, "date": "2025-04-11T00:00:00.000Z", "high": 84300, "open": 79560.3, "close": 83378.3, "openTime": 1744329600000, "closeTime": 1744415999999, "tradeCount": 4822203, "volumeBase": 295777.871, "volumeQuote": 24267636755.0135 }, { "low": 82756, "date": "2025-04-12T00:00:00.000Z", "high": 85884.2, "open": 83378.3, "close": 85237.8, "openTime": 1744416000000, "closeTime": 1744502399999, "tradeCount": 2750499, "volumeBase": 158002.837, "volumeQuote": 13313650656.6862 }, { "low": 82991.5, "date": "2025-04-13T00:00:00.000Z", "high": 86100, "open": 85237.9, "close": 83713.7, "openTime": 1744502400000, "closeTime": 1744588799999, "tradeCount": 3377742, "volumeBase": 207038.38, "volumeQuote": 17457667797.3317 }, { "low": 83630.9, "date": "2025-04-14T00:00:00.000Z", "high": 85755, "open": 83713.8, "close": 84553.9, "openTime": 1744588800000, "closeTime": 1744675199999, "tradeCount": 3632120, "volumeBase": 209349.356, "volumeQuote": 17726843976.2684 }, { "low": 83560, "date": "2025-04-15T00:00:00.000Z", "high": 86443, "open": 84553.9, "close": 83608.7, "openTime": 1744675200000, "closeTime": 1744761599999, "tradeCount": 3121181, "volumeBase": 184522.182, "volumeQuote": 15709860552.1604 }, { "low": 83063.9, "date": "2025-04-16T00:00:00.000Z", "high": 85493.5, "open": 83608.6, "close": 83990, "openTime": 1744761600000, "closeTime": 1744847999999, "tradeCount": 3500261, "volumeBase": 209441.418, "volumeQuote": 17600465000.7882 }, { "low": 83700, "date": "2025-04-17T00:00:00.000Z", "high": 85441.5, "open": 83990.1, "close": 84915, "openTime": 1744848000000, "closeTime": 1744934399999, "tradeCount": 2398235, "volumeBase": 141033.195, "volumeQuote": 11925437240.4436 }, { "low": 84260, "date": "2025-04-18T00:00:00.000Z", "high": 85100, "open": 84914.9, "close": 84421, "openTime": 1744934400000, "closeTime": 1745020799999, "tradeCount": 1026255, "volumeBase": 55218.842, "volumeQuote": 4669701038.4181 } ], "exchange": "binance", "interval": "1d", "contractType": "PERPETUAL" } ``` --- ### Depth Order book for one contract — the resting bids and asks behind the quote. - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/depth` - **Cache TTL:** 10s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925 | | `limit` | number | query | no | Levels per side. Default 50, max 1000 | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance-futures/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-futures/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-futures/depth?symbol=BTCUSDT&limit=50", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "asks": [ { "price": 76473.8, "amount": 6.643 }, { "price": 76473.9, "amount": 0.038 }, { "price": 76474, "amount": 0.293 }, { "price": 76474.1, "amount": 0.682 }, { "price": 76474.2, "amount": 0.002 }, { "price": 76474.3, "amount": 0.002 }, { "price": 76474.5, "amount": 0.001 }, { "price": 76474.6, "amount": 0.031 } ], "bids": [ { "price": 76473.7, "amount": 4.527 }, { "price": 76473.6, "amount": 0.003 }, { "price": 76473.4, "amount": 0.12 }, { "price": 76473.1, "amount": 0.001 }, { "price": 76473, "amount": 0.05 }, { "price": 76472.9, "amount": 0.002 }, { "price": 76472.8, "amount": 0.001 }, { "price": 76472.7, "amount": 0.004 } ], "time": 1787475074835, "spread": 0.1, "symbol": "BTCUSDT", "timeIso": "2026-08-23T08:51:14.835Z", "askCount": 50, "bidCount": 50, "exchange": "binance", "transactionTime": 1787475074816 } ``` --- ### Exchange Info Instrument specifications for USD-M futures: tick size, lot size, minimum - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/exchange-info` - **Cache TTL:** 600s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | no | One contract. Accepts BTCUSDT, BTC/USDT or a dated contract such as BTCUSDT_260925 | | `symbols` | string | query | no | Several contracts, comma separated. Max 100 | | `quote` | enum(all|USDT|USDC|BTC|USD1) | query | no | Restrict to contracts margined in this asset when no symbol is given. Default USDT | | `contractType` | enum(all|PERPETUAL|CURRENT_QUARTER|NEXT_QUARTER|TRADIFI_PERPETUAL) | query | no | Keep only one kind of contract. Default all | | `search` | string | query | no | Filter by base asset | | `status` | enum(all|trading) | query | no | Keep only tradable contracts, or every listed one including SETTLING and PENDING_TRADING. Default trading | | `count` | number | query | no | Rows to return. Default 100, max 500 | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance-futures/exchange-info?symbol=BTCUSDT&symbols=BTCUSDT%2CETHUSDT"e=USDT&contractType=PERPETUAL&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-futures/exchange-info?symbol=BTCUSDT&symbols=BTCUSDT%2CETHUSDT"e=USDT&contractType=PERPETUAL&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-futures/exchange-info?symbol=BTCUSDT&symbols=BTCUSDT%2CETHUSDT"e=USDT&contractType=PERPETUAL&search=btc&status=trading&count=100", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "count": 1, "items": [ { "base": "BTC", "pair": "BTCUSDT", "quote": "USDT", "maxQty": 1000, "minQty": 0.001, "status": "TRADING", "symbol": "BTCUSDT", "filters": { "lotSize": { "maxQty": 1000, "minQty": 0.001, "stepSize": 0.001 }, "minNotional": { "notional": 50 }, "priceFilter": { "maxPrice": 4529764, "minPrice": 556.8, "tickSize": 0.1 }, "maxNumOrders": { "limit": 200 }, "percentPrice": { "multiplierUp": 1.05, "multiplierDown": 0.95, "multiplierDecimal": 4 }, "marketLotSize": { "maxQty": 120, "minQty": 0.001, "stepSize": 0.001 }, "positionRiskControl": { "positionControlSide": "NONE" } }, "maxPrice": 4529764, "minPrice": 556.8, "stepSize": 0.001, "tickSize": 0.1, "orderTypes": [ "LIMIT", "MARKET", "STOP", "STOP_MARKET", "TAKE_PROFIT", "TAKE_PROFIT_MARKET", "TRAILING_STOP_MARKET" ], "marginAsset": "USDT", "minNotional": 50, "onboardDate": 1567965300000, "permissions": [ "GRID", "COPY", "DCA", "PSB" ], "timeInForce": [ "GTC", "IOC", "FOK", "GTX", "GTD" ], "contractType": "PERPETUAL", "deliveryDate": 4133404800000, "marketMaxQty": 120, "marketMinQty": 0.001, "basePrecision": 8, "liquidationFee": 0.0125, "onboardDateIso": "2019-09-08T17:55:00.000Z", "pricePrecision": 2, "quotePrecision": 8, "triggerProtect": 0.05, "underlyingType": "COIN", "deliveryDateIso": "2100-12-25T08:00:00.000Z", "marketTakeBound": 0.05, "maxMoveOrderLimit": 10000, "quantityPrecision": 3, "underlyingSubType": [ "PoW" ], "maintMarginPercent": 2.5, "requiredMarginPercent": 5 } ], "quote": "all", "total": 1, "exchange": "binance", "rateLimits": [ { "type": "REQUEST_WEIGHT", "limit": 2400, "interval": "MINUTE", "intervalNum": 1 }, { "type": "ORDERS", "limit": 1200, "interval": "MINUTE", "intervalNum": 1 }, { "type": "ORDERS", "limit": 300, "interval": "SECOND", "intervalNum": 10 } ], "serverTime": 1787472010896, "contractType": "all", "serverTimeIso": "2026-08-23T08:00:10.896Z" } ``` --- ### Funding Info The funding RULES rather than the settled rates: how often each contract - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/funding-info` - **Cache TTL:** 600s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | no | One contract. Leave empty to list every contract with custom funding rules | | `count` | number | query | no | Rows to return. Default 200, max 1000 | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance-futures/funding-info?symbol=LPTUSDT&count=200" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance-futures/funding-info?symbol=LPTUSDT&count=200", { 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-futures/funding-info?symbol=LPTUSDT&count=200", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "count": 1, "items": [ { "symbol": "LPTUSDT", "disclaimer": false, "updateTime": 1752854309429, "updateTimeIso": "2025-07-18T15:58:29.429Z", "fundingRateCap": 0.02, "fundingRateFloor": -0.02, "fundingIntervalHours": 4 } ], "total": 1, "symbol": "LPTUSDT", "exchange": "binance" } ``` --- ### Funding Rate Settled funding history for one contract — what longs actually paid shorts, or - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/funding-rate` - **Cache TTL:** 60s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925 | | `count` | number | query | no | Settlements to return, oldest first. Default 100, max 1000 — but without startTime the upstream clamps to 500 | | `startTime` | string | query | no | Window start, inclusive. ISO date or epoch milliseconds | | `endTime` | string | query | no | Window end, inclusive. ISO date or epoch milliseconds | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance-futures/funding-rate?symbol=BTCUSDT&count=100&startTime=2026-01-01&endTime=2026-08-01" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance-futures/funding-rate?symbol=BTCUSDT&count=100&startTime=2026-01-01&endTime=2026-08-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-futures/funding-rate?symbol=BTCUSDT&count=100&startTime=2026-01-01&endTime=2026-08-01", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "count": 100, "items": [ { "symbol": "BTCUSDT", "rateType": "Regular", "markPrice": 66168.77917391, "fundingRate": 0.00008926, "fundingTime": 1784620800000, "fundingTimeIso": "2026-07-21T08:00:00.000Z", "fundingRatePercent": 0.008926 }, { "symbol": "BTCUSDT", "rateType": "Regular", "markPrice": 66648.5, "fundingRate": 0.00001894, "fundingTime": 1784649600002, "fundingTimeIso": "2026-07-21T16:00:00.002Z", "fundingRatePercent": 0.001894 }, { "symbol": "BTCUSDT", "rateType": "Regular", "markPrice": 66522.4, "fundingRate": 0.00003928, "fundingTime": 1784678400000, "fundingTimeIso": "2026-07-22T00:00:00.000Z", "fundingRatePercent": 0.003928 }, { "symbol": "BTCUSDT", "rateType": "Regular", "markPrice": 65813.4, "fundingRate": 0.00005448, "fundingTime": 1784707200000, "fundingTimeIso": "2026-07-22T08:00:00.000Z", "fundingRatePercent": 0.005448 }, { "symbol": "BTCUSDT", "rateType": "Regular", "markPrice": 66016.32605797, "fundingRate": 0.00001443, "fundingTime": 1784736000001, "fundingTimeIso": "2026-07-22T16:00:00.001Z", "fundingRatePercent": 0.001443 }, { "symbol": "BTCUSDT", "rateType": "Regular", "markPrice": 66084.47942754, "fundingRate": -0.00000343, "fundingTime": 1784764800000, "fundingTimeIso": "2026-07-23T00:00:00.000Z", "fundingRatePercent": -0.000343 }, { "symbol": "BTCUSDT", "rateType": "Regular", "markPrice": 65405.48600725, "fundingRate": 0.00000271, "fundingTime": 1784793600000, "fundingTimeIso": "2026-07-23T08:00:00.000Z", "fundingRatePercent": 0.000271 }, { "symbol": "BTCUSDT", "rateType": "Regular", "markPrice": 64940.4, "fundingRate": 0.00008458, "fundingTime": 1784822400000, "fundingTimeIso": "2026-07-23T16:00:00.000Z", "fundingRatePercent": 0.008458 } ], "symbol": "BTCUSDT", "exchange": "binance" } ``` --- ### Global Long Short Ratio The share of ALL accounts holding a long against a short on one contract. - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/global-long-short-ratio` - **Cache TTL:** 60s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Futures contract. Accepts BTCUSDT, BTC/USDT or btc_usdt | | `period` | enum(5m|15m|30m|1h|2h|4h|6h|12h|1d) | query | no | Bucket size. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d — the upstream refuses 8h. Default 1d | | `count` | number | query | no | Rows to return, oldest first. Default 30, max 1000 | | `startTime` | string | query | no | Window start, inclusive. Only the last 30 days exist. ISO date or epoch milliseconds | | `endTime` | string | query | no | Window end, inclusive. ISO date or epoch milliseconds | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance-futures/global-long-short-ratio?symbol=BTCUSDT&period=1d&count=30&startTime=2026-08-01&endTime=2026-08-20" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance-futures/global-long-short-ratio?symbol=BTCUSDT&period=1d&count=30&startTime=2026-08-01&endTime=2026-08-20", { 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-futures/global-long-short-ratio?symbol=BTCUSDT&period=1d&count=30&startTime=2026-08-01&endTime=2026-08-20", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "count": 30, "items": [ { "time": 1784937600000, "symbol": "BTCUSDT", "timeIso": "2026-07-25T00:00:00.000Z", "longAccount": 0.6524, "shortAccount": 0.3476, "longShortRatio": 1.8769 }, { "time": 1785024000000, "symbol": "BTCUSDT", "timeIso": "2026-07-26T00:00:00.000Z", "longAccount": 0.6433, "shortAccount": 0.3567, "longShortRatio": 1.8035 }, { "time": 1785110400000, "symbol": "BTCUSDT", "timeIso": "2026-07-27T00:00:00.000Z", "longAccount": 0.6096, "shortAccount": 0.3904, "longShortRatio": 1.5615 }, { "time": 1785196800000, "symbol": "BTCUSDT", "timeIso": "2026-07-28T00:00:00.000Z", "longAccount": 0.6277, "shortAccount": 0.3723, "longShortRatio": 1.686 }, { "time": 1785283200000, "symbol": "BTCUSDT", "timeIso": "2026-07-29T00:00:00.000Z", "longAccount": 0.6341, "shortAccount": 0.3659, "longShortRatio": 1.733 }, { "time": 1785369600000, "symbol": "BTCUSDT", "timeIso": "2026-07-30T00:00:00.000Z", "longAccount": 0.6093, "shortAccount": 0.3907, "longShortRatio": 1.5595 }, { "time": 1785456000000, "symbol": "BTCUSDT", "timeIso": "2026-07-31T00:00:00.000Z", "longAccount": 0.5563, "shortAccount": 0.4437, "longShortRatio": 1.2538 }, { "time": 1785542400000, "symbol": "BTCUSDT", "timeIso": "2026-08-01T00:00:00.000Z", "longAccount": 0.6882, "shortAccount": 0.3118, "longShortRatio": 2.2072 } ], "period": "1d", "symbol": "BTCUSDT", "exchange": "binance" } ``` --- ### Index Price Klines Candles of the INDEX price for a pair — the spot composite the venue computes - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/index-price-klines` - **Cache TTL:** 30s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `pair` | string | query | yes | Underlying pair, not a contract symbol. 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. Unlike spot there is no 1s candle | | `count` | number | query | no | Number of candles. Default 500, max 1500 — higher than spot's 1000, and 1501 is refused outright | | `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-futures/index-price-klines?pair=BTCUSDT&interval=1d&count=500&startTime=2026-01-01&endTime=2026-03-01" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance-futures/index-price-klines?pair=BTCUSDT&interval=1d&count=500&startTime=2026-01-01&endTime=2026-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-futures/index-price-klines?pair=BTCUSDT&interval=1d&count=500&startTime=2026-01-01&endTime=2026-03-01", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "pair": "BTCUSDT", "count": 500, "candles": [ { "low": 78974.09688889, "date": "2025-04-11T00:00:00.000Z", "high": 84278.24577778, "open": 79615.004, "close": 83422.79911111, "openTime": 1744329600000, "closeTime": 1744415999999 }, { "low": 82804.54022222, "date": "2025-04-12T00:00:00.000Z", "high": 85902.92977778, "open": 83422.39977778, "close": 85277.55311111, "openTime": 1744416000000, "closeTime": 1744502399999 }, { "low": 83045.48222222, "date": "2025-04-13T00:00:00.000Z", "high": 86089.66711111, "open": 85277.55222222, "close": 83759.04977778, "openTime": 1744502400000, "closeTime": 1744588799999 }, { "low": 83694.11333333, "date": "2025-04-14T00:00:00.000Z", "high": 85793.74733333, "open": 83759.04977778, "close": 84585.22222222, "openTime": 1744588800000, "closeTime": 1744675199999 }, { "low": 83604.72333333, "date": "2025-04-15T00:00:00.000Z", "high": 86460.21022222, "open": 84585.34155556, "close": 83646.54222222, "openTime": 1744675200000, "closeTime": 1744761599999 }, { "low": 83114.18422222, "date": "2025-04-16T00:00:00.000Z", "high": 85466.54311111, "open": 83647.18288889, "close": 84032.31444444, "openTime": 1744761600000, "closeTime": 1744847999999 }, { "low": 83749.20355556, "date": "2025-04-17T00:00:00.000Z", "high": 85468.69111111, "open": 84032.30777778, "close": 84948.70444444, "openTime": 1744848000000, "closeTime": 1744934399999 }, { "low": 84312.39155556, "date": "2025-04-18T00:00:00.000Z", "high": 85127.78377778, "open": 84949.12444444, "close": 84472.03422222, "openTime": 1744934400000, "closeTime": 1745020799999 } ], "exchange": "binance", "interval": "1d" } ``` --- ### Klines OHLCV candles for one USD-M futures contract — perpetual or dated delivery. - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/klines` - **Cache TTL:** 30s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925 | | `interval` | enum(1m|3m|5m|15m|30m|1h|2h|4h|6h|8h|12h|1d|3d|1w|1M) | query | no | Candle size. Default 1d. Unlike spot there is no 1s candle | | `count` | number | query | no | Number of candles. Default 500, max 1500 — higher than spot's 1000, and 1501 is refused outright | | `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-futures/klines?symbol=BTCUSDT&interval=1d&count=500&startTime=2026-01-01&endTime=2026-03-01" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance-futures/klines?symbol=BTCUSDT&interval=1d&count=500&startTime=2026-01-01&endTime=2026-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-futures/klines?symbol=BTCUSDT&interval=1d&count=500&startTime=2026-01-01&endTime=2026-03-01", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "count": 500, "symbol": "BTCUSDT", "candles": [ { "low": 78935.5, "date": "2025-04-11T00:00:00.000Z", "high": 84300, "open": 79560.3, "close": 83378.3, "openTime": 1744329600000, "closeTime": 1744415999999, "tradeCount": 4822203, "volumeBase": 295777.871, "volumeQuote": 24267636755.0135 }, { "low": 82756, "date": "2025-04-12T00:00:00.000Z", "high": 85884.2, "open": 83378.3, "close": 85237.8, "openTime": 1744416000000, "closeTime": 1744502399999, "tradeCount": 2750499, "volumeBase": 158002.837, "volumeQuote": 13313650656.6862 }, { "low": 82991.5, "date": "2025-04-13T00:00:00.000Z", "high": 86100, "open": 85237.9, "close": 83713.7, "openTime": 1744502400000, "closeTime": 1744588799999, "tradeCount": 3377742, "volumeBase": 207038.38, "volumeQuote": 17457667797.3317 }, { "low": 83630.9, "date": "2025-04-14T00:00:00.000Z", "high": 85755, "open": 83713.8, "close": 84553.9, "openTime": 1744588800000, "closeTime": 1744675199999, "tradeCount": 3632120, "volumeBase": 209349.356, "volumeQuote": 17726843976.2684 }, { "low": 83560, "date": "2025-04-15T00:00:00.000Z", "high": 86443, "open": 84553.9, "close": 83608.7, "openTime": 1744675200000, "closeTime": 1744761599999, "tradeCount": 3121181, "volumeBase": 184522.182, "volumeQuote": 15709860552.1604 }, { "low": 83063.9, "date": "2025-04-16T00:00:00.000Z", "high": 85493.5, "open": 83608.6, "close": 83990, "openTime": 1744761600000, "closeTime": 1744847999999, "tradeCount": 3500261, "volumeBase": 209441.418, "volumeQuote": 17600465000.7882 }, { "low": 83700, "date": "2025-04-17T00:00:00.000Z", "high": 85441.5, "open": 83990.1, "close": 84915, "openTime": 1744848000000, "closeTime": 1744934399999, "tradeCount": 2398235, "volumeBase": 141033.195, "volumeQuote": 11925437240.4436 }, { "low": 84260, "date": "2025-04-18T00:00:00.000Z", "high": 85100, "open": 84914.9, "close": 84421, "openTime": 1744934400000, "closeTime": 1745020799999, "tradeCount": 1026255, "volumeBase": 55218.842, "volumeQuote": 4669701038.4181 } ], "exchange": "binance", "interval": "1d" } ``` --- ### Mark Price Klines Candles of the MARK price for one contract — the price liquidations and - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/mark-price-klines` - **Cache TTL:** 30s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925 | | `interval` | enum(1m|3m|5m|15m|30m|1h|2h|4h|6h|8h|12h|1d|3d|1w|1M) | query | no | Candle size. Default 1d. Unlike spot there is no 1s candle | | `count` | number | query | no | Number of candles. Default 500, max 1500 — higher than spot's 1000, and 1501 is refused outright | | `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-futures/mark-price-klines?symbol=BTCUSDT&interval=1d&count=500&startTime=2026-01-01&endTime=2026-03-01" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance-futures/mark-price-klines?symbol=BTCUSDT&interval=1d&count=500&startTime=2026-01-01&endTime=2026-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-futures/mark-price-klines?symbol=BTCUSDT&interval=1d&count=500&startTime=2026-01-01&endTime=2026-03-01", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "count": 500, "symbol": "BTCUSDT", "candles": [ { "low": 78938.95561481, "date": "2025-04-11T00:00:00.000Z", "high": 84261.8, "open": 79576.11047407, "close": 83385.7, "openTime": 1744329600000, "closeTime": 1744415999999 }, { "low": 82768.03745926, "date": "2025-04-12T00:00:00.000Z", "high": 85878.1, "open": 83385.7, "close": 85240.01637778, "openTime": 1744416000000, "closeTime": 1744502399999 }, { "low": 83001.65998519, "date": "2025-04-13T00:00:00.000Z", "high": 86081.03407568, "open": 85240.01548889, "close": 83714.76418519, "openTime": 1744502400000, "closeTime": 1744588799999 }, { "low": 83661.0582963, "date": "2025-04-14T00:00:00.000Z", "high": 85766.06068148, "open": 83715.61378519, "close": 84553.8, "openTime": 1744588800000, "closeTime": 1744675199999 }, { "low": 83565.2, "date": "2025-04-15T00:00:00.000Z", "high": 86443, "open": 84553.9, "close": 83608.6, "openTime": 1744675200000, "closeTime": 1744761599999 }, { "low": 83070.324, "date": "2025-04-16T00:00:00.000Z", "high": 85442.5, "open": 83608.7, "close": 83994.1836, "openTime": 1744761600000, "closeTime": 1744847999999 }, { "low": 83711.59946667, "date": "2025-04-17T00:00:00.000Z", "high": 85441.5, "open": 83994.1836, "close": 84916.10982222, "openTime": 1744848000000, "closeTime": 1744934399999 }, { "low": 84277.4, "date": "2025-04-18T00:00:00.000Z", "high": 85099.9, "open": 84916.10982222, "close": 84429.71837548, "openTime": 1744934400000, "closeTime": 1745020799999 } ], "exchange": "binance", "interval": "1d" } ``` --- ### Open Interest Hist Open interest sampled on a fixed bucket — the size of the outstanding position - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/open-interest-hist` - **Cache TTL:** 60s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Futures contract. Accepts BTCUSDT, BTC/USDT or btc_usdt | | `period` | enum(5m|15m|30m|1h|2h|4h|6h|12h|1d) | query | no | Bucket size. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d — the upstream refuses 8h. Default 1d | | `count` | number | query | no | Rows to return, oldest first. Default 30, max 1000 | | `startTime` | string | query | no | Window start, inclusive. Only the last 30 days exist. ISO date or epoch milliseconds | | `endTime` | string | query | no | Window end, inclusive. ISO date or epoch milliseconds | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance-futures/open-interest-hist?symbol=BTCUSDT&period=1d&count=30&startTime=2026-08-01&endTime=2026-08-20" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance-futures/open-interest-hist?symbol=BTCUSDT&period=1d&count=30&startTime=2026-08-01&endTime=2026-08-20", { 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-futures/open-interest-hist?symbol=BTCUSDT&period=1d&count=30&startTime=2026-08-01&endTime=2026-08-20", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "count": 30, "items": [ { "time": 1784937600000, "symbol": "BTCUSDT", "timeIso": "2026-07-25T00:00:00.000Z", "openInterest": 106114.818, "circulatingSupply": 20060368, "openInterestValue": 6803700116.8152 }, { "time": 1785024000000, "symbol": "BTCUSDT", "timeIso": "2026-07-26T00:00:00.000Z", "openInterest": 107509, "circulatingSupply": 20060868, "openInterestValue": 6917476416.904509 }, { "time": 1785110400000, "symbol": "BTCUSDT", "timeIso": "2026-07-27T00:00:00.000Z", "openInterest": 104354.198, "circulatingSupply": 20061281, "openInterestValue": 6821873937.9154 }, { "time": 1785196800000, "symbol": "BTCUSDT", "timeIso": "2026-07-28T00:00:00.000Z", "openInterest": 105602.91, "circulatingSupply": 20061743, "openInterestValue": 6729450397.131 }, { "time": 1785283200000, "symbol": "BTCUSDT", "timeIso": "2026-07-29T00:00:00.000Z", "openInterest": 103253.297, "circulatingSupply": 20062184, "openInterestValue": 6598257390.1692 }, { "time": 1785369600000, "symbol": "BTCUSDT", "timeIso": "2026-07-30T00:00:00.000Z", "openInterest": 104348.71, "circulatingSupply": 20062581, "openInterestValue": 6674049577.761 }, { "time": 1785456000000, "symbol": "BTCUSDT", "timeIso": "2026-07-31T00:00:00.000Z", "openInterest": 106595.936, "circulatingSupply": 20063006, "openInterestValue": 6902141264.728566 }, { "time": 1785542400000, "symbol": "BTCUSDT", "timeIso": "2026-08-01T00:00:00.000Z", "openInterest": 109523.589, "circulatingSupply": 20063506, "openInterestValue": 6884630899.8222 } ], "period": "1d", "symbol": "BTCUSDT", "exchange": "binance" } ``` --- ### Open Interest Open interest on one contract right now: how many contracts are outstanding, - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/open-interest` - **Cache TTL:** 5s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925 | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance-futures/open-interest?symbol=BTCUSDT" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance-futures/open-interest?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-futures/open-interest?symbol=BTCUSDT", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "time": 1787475070104, "symbol": "BTCUSDT", "timeIso": "2026-08-23T08:51:10.104Z", "exchange": "binance", "openInterest": 107311.42 } ``` --- ### Premium Index Mark price and index price for one contract, with the funding rate the next - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/premium-index` - **Cache TTL:** 5s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925 | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance-futures/premium-index?symbol=BTCUSDT" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance-futures/premium-index?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-futures/premium-index?symbol=BTCUSDT", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "time": 1787475072000, "symbol": "BTCUSDT", "timeIso": "2026-08-23T08:51:12.000Z", "exchange": "binance", "markPrice": 76475.84468116, "indexPrice": 76472.33521739, "interestRate": 0.0001, "lastFundingRate": 0.0001, "nextFundingTime": 1787500800000, "nextFundingTimeIso": "2026-08-23T16:00:00.000Z", "estimatedSettlePrice": 76370.0751465, "lastFundingRatePercent": 0.01 } ``` --- ### Taker Long Short Ratio Taker flow on one contract: how much volume crossed the spread to buy against - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/taker-long-short-ratio` - **Cache TTL:** 60s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Futures contract. Accepts BTCUSDT, BTC/USDT or btc_usdt | | `period` | enum(5m|15m|30m|1h|2h|4h|6h|12h|1d) | query | no | Bucket size. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d — the upstream refuses 8h. Default 1d | | `count` | number | query | no | Rows to return, oldest first. Default 30, max 1000 | | `startTime` | string | query | no | Window start, inclusive. Only the last 30 days exist. ISO date or epoch milliseconds | | `endTime` | string | query | no | Window end, inclusive. ISO date or epoch milliseconds | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance-futures/taker-long-short-ratio?symbol=BTCUSDT&period=1d&count=30&startTime=2026-08-01&endTime=2026-08-20" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance-futures/taker-long-short-ratio?symbol=BTCUSDT&period=1d&count=30&startTime=2026-08-01&endTime=2026-08-20", { 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-futures/taker-long-short-ratio?symbol=BTCUSDT&period=1d&count=30&startTime=2026-08-01&endTime=2026-08-20", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "count": 30, "items": [ { "time": 1784851200000, "timeIso": "2026-07-24T00:00:00.000Z", "buyVolume": 72365.786, "sellVolume": 75171.688, "buySellRatio": 0.9627 }, { "time": 1784937600000, "timeIso": "2026-07-25T00:00:00.000Z", "buyVolume": 21283.36, "sellVolume": 24964.274, "buySellRatio": 0.8526 }, { "time": 1785024000000, "timeIso": "2026-07-26T00:00:00.000Z", "buyVolume": 34020.143, "sellVolume": 31743.025, "buySellRatio": 1.0717 }, { "time": 1785110400000, "timeIso": "2026-07-27T00:00:00.000Z", "buyVolume": 70010.867, "sellVolume": 77820.866, "buySellRatio": 0.8996 }, { "time": 1785196800000, "timeIso": "2026-07-28T00:00:00.000Z", "buyVolume": 72733.525, "sellVolume": 71540.337, "buySellRatio": 1.0167 }, { "time": 1785283200000, "timeIso": "2026-07-29T00:00:00.000Z", "buyVolume": 90771.593, "sellVolume": 89204.709, "buySellRatio": 1.0176 }, { "time": 1785369600000, "timeIso": "2026-07-30T00:00:00.000Z", "buyVolume": 58513.207, "sellVolume": 54342.525, "buySellRatio": 1.0767 }, { "time": 1785456000000, "timeIso": "2026-07-31T00:00:00.000Z", "buyVolume": 87864.89, "sellVolume": 87100.045, "buySellRatio": 1.0088 } ], "period": "1d", "symbol": "BTCUSDT", "exchange": "binance" } ``` --- ### Ticker 24hr Rolling 24-hour statistics for one contract. - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/ticker-24hr` - **Cache TTL:** 15s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925 | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance-futures/ticker-24hr?symbol=BTCUSDT" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance-futures/ticker-24hr?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-futures/ticker-24hr?symbol=BTCUSDT", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "low": 75588, "high": 77590.6, "last": 76479.1, "open": 77189, "change": -709.9, "symbol": "BTCUSDT", "lastQty": 0.011, "exchange": "binance", "openTime": 1787388600000, "closeTime": 1787475059597, "tradeCount": 2933634, "volumeBase": 113396.455, "lastTradeId": 8005545136, "volumeQuote": 8701896003.51, "firstTradeId": 8002597949, "changePercent": -0.92, "weightedAvgPrice": 76738.7 } ``` --- ### Top Long Short Account Ratio The same headcount as the global series, restricted to the largest accounts - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/top-long-short-account-ratio` - **Cache TTL:** 60s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Futures contract. Accepts BTCUSDT, BTC/USDT or btc_usdt | | `period` | enum(5m|15m|30m|1h|2h|4h|6h|12h|1d) | query | no | Bucket size. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d — the upstream refuses 8h. Default 1d | | `count` | number | query | no | Rows to return, oldest first. Default 30, max 1000 | | `startTime` | string | query | no | Window start, inclusive. Only the last 30 days exist. ISO date or epoch milliseconds | | `endTime` | string | query | no | Window end, inclusive. ISO date or epoch milliseconds | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance-futures/top-long-short-account-ratio?symbol=BTCUSDT&period=1d&count=30&startTime=2026-08-01&endTime=2026-08-20" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance-futures/top-long-short-account-ratio?symbol=BTCUSDT&period=1d&count=30&startTime=2026-08-01&endTime=2026-08-20", { 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-futures/top-long-short-account-ratio?symbol=BTCUSDT&period=1d&count=30&startTime=2026-08-01&endTime=2026-08-20", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "count": 30, "items": [ { "time": 1784937600000, "symbol": "BTCUSDT", "timeIso": "2026-07-25T00:00:00.000Z", "longAccount": 0.6695, "shortAccount": 0.3305, "longShortRatio": 2.0257 }, { "time": 1785024000000, "symbol": "BTCUSDT", "timeIso": "2026-07-26T00:00:00.000Z", "longAccount": 0.6538, "shortAccount": 0.3462, "longShortRatio": 1.8885 }, { "time": 1785110400000, "symbol": "BTCUSDT", "timeIso": "2026-07-27T00:00:00.000Z", "longAccount": 0.6207, "shortAccount": 0.3793, "longShortRatio": 1.6364 }, { "time": 1785196800000, "symbol": "BTCUSDT", "timeIso": "2026-07-28T00:00:00.000Z", "longAccount": 0.6516, "shortAccount": 0.3484, "longShortRatio": 1.8703 }, { "time": 1785283200000, "symbol": "BTCUSDT", "timeIso": "2026-07-29T00:00:00.000Z", "longAccount": 0.646, "shortAccount": 0.354, "longShortRatio": 1.8249 }, { "time": 1785369600000, "symbol": "BTCUSDT", "timeIso": "2026-07-30T00:00:00.000Z", "longAccount": 0.6266, "shortAccount": 0.3734, "longShortRatio": 1.6781 }, { "time": 1785456000000, "symbol": "BTCUSDT", "timeIso": "2026-07-31T00:00:00.000Z", "longAccount": 0.5734, "shortAccount": 0.4266, "longShortRatio": 1.3441 }, { "time": 1785542400000, "symbol": "BTCUSDT", "timeIso": "2026-08-01T00:00:00.000Z", "longAccount": 0.7031, "shortAccount": 0.2969, "longShortRatio": 2.3681 } ], "period": "1d", "symbol": "BTCUSDT", "exchange": "binance" } ``` --- ### Top Long Short Position Ratio The largest accounts' positioning weighted by POSITION rather than by head: - **Method:** `GET` - **Endpoint:** `https://api.zapi.ink/v1/finance:binance-futures/top-long-short-position-ratio` - **Cache TTL:** 60s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `symbol` | string | query | yes | Futures contract. Accepts BTCUSDT, BTC/USDT or btc_usdt | | `period` | enum(5m|15m|30m|1h|2h|4h|6h|12h|1d) | query | no | Bucket size. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d — the upstream refuses 8h. Default 1d | | `count` | number | query | no | Rows to return, oldest first. Default 30, max 1000 | | `startTime` | string | query | no | Window start, inclusive. Only the last 30 days exist. ISO date or epoch milliseconds | | `endTime` | string | query | no | Window end, inclusive. ISO date or epoch milliseconds | **cURL:** ```bash curl "https://api.zapi.ink/v1/finance:binance-futures/top-long-short-position-ratio?symbol=BTCUSDT&period=1d&count=30&startTime=2026-08-01&endTime=2026-08-20" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zapi.ink/v1/finance:binance-futures/top-long-short-position-ratio?symbol=BTCUSDT&period=1d&count=30&startTime=2026-08-01&endTime=2026-08-20", { 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-futures/top-long-short-position-ratio?symbol=BTCUSDT&period=1d&count=30&startTime=2026-08-01&endTime=2026-08-20", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "count": 30, "items": [ { "time": 1784937600000, "symbol": "BTCUSDT", "timeIso": "2026-07-25T00:00:00.000Z", "longAccount": 0.624, "shortAccount": 0.376, "longShortRatio": 1.6599 }, { "time": 1785024000000, "symbol": "BTCUSDT", "timeIso": "2026-07-26T00:00:00.000Z", "longAccount": 0.6181, "shortAccount": 0.3819, "longShortRatio": 1.6188 }, { "time": 1785110400000, "symbol": "BTCUSDT", "timeIso": "2026-07-27T00:00:00.000Z", "longAccount": 0.6189, "shortAccount": 0.3811, "longShortRatio": 1.6242 }, { "time": 1785196800000, "symbol": "BTCUSDT", "timeIso": "2026-07-28T00:00:00.000Z", "longAccount": 0.6114, "shortAccount": 0.3886, "longShortRatio": 1.5734 }, { "time": 1785283200000, "symbol": "BTCUSDT", "timeIso": "2026-07-29T00:00:00.000Z", "longAccount": 0.6205, "shortAccount": 0.3795, "longShortRatio": 1.635 }, { "time": 1785369600000, "symbol": "BTCUSDT", "timeIso": "2026-07-30T00:00:00.000Z", "longAccount": 0.613, "shortAccount": 0.387, "longShortRatio": 1.5839 }, { "time": 1785456000000, "symbol": "BTCUSDT", "timeIso": "2026-07-31T00:00:00.000Z", "longAccount": 0.5994, "shortAccount": 0.4006, "longShortRatio": 1.496 }, { "time": 1785542400000, "symbol": "BTCUSDT", "timeIso": "2026-08-01T00:00:00.000Z", "longAccount": 0.6165, "shortAccount": 0.3835, "longShortRatio": 1.6072 } ], "period": "1d", "symbol": "BTCUSDT", "exchange": "binance" } ``` --- _Generated: 2026-09-25T14:33:25.847Z_