zapi.
APIsPricingDocsMCP
APIsPricingDocsMCPSign in
zapi.
APIsPricingDocsMCP
APIsPricingDocsMCPSign in
On this page
  • Playground
  • Code examples
  • Full reference
  • Related APIs
Finance/Binance Futures
Logo Binance Futures

Binance Futures

USD-M perpetual futures market data: funding, premium index, open interest, long/short ratios, candles and depth.

Endpoints
19
Requests
498
Updated
5 hours ago
For LLMs
llms.txt
Endpoint health3 hours ago
  • agg-tradesfailed the last check
  • basispassing, 0.3s
  • book-tickerpassing, 0.1s
  • continuous-klinespassing, 0.1s
  • depthpassing, 0.1s
+ 14 more endpointsShow less
  • exchange-infopassing, 0.1s
  • funding-infopassing, 0.2s
  • funding-ratepassing, 0.4s
  • global-long-short-ratiopassing, 0.1s
  • index-price-klinespassing, 0.1s
  • klinespassing, 0.1s
  • mark-price-klinespassing, 0.1s
  • open-interest-histpassing, 0.1s
  • open-interestpassing, 0.1s
  • premium-indexpassing, 0.1s
  • taker-long-short-ratiopassing, 1.2s
  • ticker-24hrpassing, 0.1s
  • top-long-short-account-ratiopassing, 0.1s
  • top-long-short-position-ratiopassing, 0.1s
18/19 passingdaily 01:00 WIB

Playground

19 endpoints
GET/v1/finance:binance-futures/agg-trades5s cache5 paramschecking key…
Parameters
symbolstringrequired

Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925

countnumber

Rows to return, newest last. Default 500, max 1000

startTimestring

Window start, inclusive. Only the last 2 days exist. ISO timestamp or epoch milliseconds

endTimestring

Window end, inclusive. ISO timestamp or epoch milliseconds

fromIdstring

Resume from this aggregate trade id instead of a time window

·
Response
EXAMPLE
{
  "count": 200,
  "items": [
    {
      "side": "buy",
      "time": 1787184000002,
      "price": 69310.1,
      "amount": 0.03,
      "timeIso": "2026-08-20T00:00:00.002Z",
      "aggTradeId": 3412496636,
      "tradeCount": 2,
      "amountQuote": 2079.303,
      "lastTradeId": 7983197863,
      "firstTradeId": 7983197862,
      "isBuyerMaker": false
    },
    {
      "side": "sell",
      "time": 1787184000061,
      "price": 69310,
      "amount": 0.004,
      "timeIso": "2026-08-20T00:00:00.061Z",
      "aggTradeId": 3412496637,
      "tradeCount": 1,
      "amountQuote": 277.24,
      "lastTradeId": 7983197864,
      "firstTradeId": 7983197864,
      "isBuyerMaker": true
    },
    {
      "side": "buy",
      "time": 1787184000085,
      "price": 69310.1,
      "amount": 0.293,
      "timeIso": "2026-08-20T00:00:00.085Z",
      "aggTradeId": 3412496638,
      "tradeCount": 5,
      "amountQuote": 20307.8593,
      "lastTradeId": 7983197869,
      "firstTradeId": 7983197865,
      "isBuyerMaker": false
    }
  ],
  "symbol": "BTCUSDT",
  "exchange": "binance"
}

Code examples

Agg Trades
zpi-sdkrecommended
// npm i zpi-sdk
import { ZpiClient } from "zpi-sdk";

const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" });

const data = await client.run("finance:binance-futures", "agg-trades", {
  "symbol": "BTCUSDT",
  "count": 500,
  "startTime": "2026-08-20T00:00:00Z",
  "endTime": "2026-08-20T01:00:00Z",
  "fromId": "3413731512"
});
console.log(data);
Full SDK reference →
request.sh
curl -X GET "https://api.zpi.web.id/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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Full reference

19 endpoints · plain text
GETAgg Trades/v1/finance:binance-futures/agg-tradesCompressed trades for one contract: fills at the same price, from the same

Parameters

symbolstringrequired
Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925
countnumberoptional
Rows to return, newest last. Default 500, max 1000
startTimestringoptional
Window start, inclusive. Only the last 2 days exist. ISO timestamp or epoch milliseconds
endTimestringoptional
Window end, inclusive. ISO timestamp or epoch milliseconds
fromIdstringoptional
Resume from this aggregate trade id instead of a time window

Request

curl -X GET "https://api.zpi.web.id/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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 200,
  "items": [
    {
      "side": "buy",
      "time": 1787184000002,
      "price": 69310.1,
      "amount": 0.03,
      "timeIso": "2026-08-20T00:00:00.002Z",
      "aggTradeId": 3412496636,
      "tradeCount": 2,
      "amountQuote": 2079.303,
      "lastTradeId": 7983197863,
      "firstTradeId": 7983197862,
      "isBuyerMaker": false
    },
    {
      "side": "sell",
      "time": 1787184000061,
      "price": 69310,
      "amount": 0.004,
      "timeIso": "2026-08-20T00:00:00.061Z",
      "aggTradeId": 3412496637,
      "tradeCount": 1,
      "amountQuote": 277.24,
      "lastTradeId": 7983197864,
      "firstTradeId": 7983197864,
      "isBuyerMaker": true
    },
    {
      "side": "buy",
      "time": 1787184000085,
      "price": 69310.1,
      "amount": 0.293,
      "timeIso": "2026-08-20T00:00:00.085Z",
      "aggTradeId": 3412496638,
      "tradeCount": 5,
      "amountQuote": 20307.8593,
      "lastTradeId": 7983197869,
      "firstTradeId": 7983197865,
      "isBuyerMaker": false
    }
  ],
  "symbol": "BTCUSDT",
  "exchange": "binance"
}
GETBasis/v1/finance:binance-futures/basisThe gap between a futures contract and its index — the carry a calendar spread

Parameters

pairstringrequired
Underlying pair, not a contract symbol. Accepts BTCUSDT, BTC/USDT or btc_usdt
contractTypeenumoptional
Which contract to measure against the index. Default PERPETUAL Values: PERPETUAL, CURRENT_QUARTER, NEXT_QUARTER.
periodenumoptional
Bucket size. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d — the upstream refuses 8h. Default 1d Values: 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d.
countnumberoptional
Rows to return, oldest first. Default 30, max 1000
startTimestringoptional
Window start, inclusive. Only the last 30 days exist. ISO date or epoch milliseconds
endTimestringoptional
Window end, inclusive. ISO date or epoch milliseconds

Request

curl -X GET "https://api.zpi.web.id/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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "pair": "BTCUSDT",
  "count": 20,
  "items": [
    {
      "pair": "BTCUSDT",
      "time": 1785542400000,
      "basis": -27.08956522,
      "timeIso": "2026-08-01T00:00:00.000Z",
      "basisRate": -0.0004,
      "indexPrice": 62886.98956522,
      "contractType": "PERPETUAL",
      "futuresPrice": 62859.9,
      "basisRatePercent": -0.04,
      "annualizedBasisRate": null
    },
    {
      "pair": "BTCUSDT",
      "time": 1785628800000,
      "basis": -29.0676087,
      "timeIso": "2026-08-02T00:00:00.000Z",
      "basisRate": -0.0005,
      "indexPrice": 62821.3676087,
      "contractType": "PERPETUAL",
      "futuresPrice": 62792.3,
      "basisRatePercent": -0.05,
      "annualizedBasisRate": null
    },
    {
      "pair": "BTCUSDT",
      "time": 1785715200000,
      "basis": -19.14152174,
      "timeIso": "2026-08-03T00:00:00.000Z",
      "basisRate": -0.0003,
      "indexPrice": 63569.14152174,
      "contractType": "PERPETUAL",
      "futuresPrice": 63550,
      "basisRatePercent": -0.03,
      "annualizedBasisRate": null
    }
  ],
  "period": "1d",
  "exchange": "binance",
  "contractType": "PERPETUAL"
}
GETBook Ticker/v1/finance:binance-futures/book-tickerBest bid and ask on one contract — the top of the book without the depth.

Parameters

symbolstringrequired
Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-futures/book-ticker?symbol=BTCUSDT" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "ask": 72189.3,
  "bid": 72189.2,
  "time": 1787238708313,
  "askQty": 0.021,
  "bidQty": 5.871,
  "spread": 0.1,
  "symbol": "BTCUSDT",
  "timeIso": "2026-08-20T15:11:48.313Z",
  "exchange": "binance",
  "spreadPercent": 0.000139
}
GETContinuous Klines/v1/finance:binance-futures/continuous-klinesOHLCV candles for a continuous contract: one unbroken series across successive

Parameters

pairstringrequired
Underlying pair, not a contract symbol. Accepts BTCUSDT, BTC/USDT or btc_usdt
contractTypeenumoptional
Which contract in the series. Default PERPETUAL Values: PERPETUAL, CURRENT_QUARTER, NEXT_QUARTER, TRADIFI_PERPETUAL.
intervalenumoptional
Candle size. Default 1d. Unlike spot there is no 1s candle Values: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M.
countnumberoptional
Number of candles. Default 500, max 1500 — higher than spot's 1000, and 1501 is refused outright
startTimestringoptional
Oldest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds
endTimestringoptional
Newest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds

Request

curl -X GET "https://api.zpi.web.id/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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "pair": "BTCUSDT",
  "count": 60,
  "candles": [
    {
      "low": 87508.4,
      "date": "2026-01-01T00:00:00.000Z",
      "high": 88881.4,
      "open": 87608.3,
      "close": 88800,
      "openTime": 1767225600000,
      "closeTime": 1767311999999,
      "tradeCount": 1056983,
      "volumeBase": 47941.303,
      "volumeQuote": 4221684071.5216
    },
    {
      "low": 88324.4,
      "date": "2026-01-02T00:00:00.000Z",
      "high": 90945.1,
      "open": 88800,
      "close": 89951.4,
      "openTime": 1767312000000,
      "closeTime": 1767398399999,
      "tradeCount": 3761821,
      "volumeBase": 176662.448,
      "volumeQuote": 15818436364.5132
    },
    {
      "low": 89261.2,
      "date": "2026-01-03T00:00:00.000Z",
      "high": 90716.9,
      "open": 89951.5,
      "close": 90595.8,
      "openTime": 1767398400000,
      "closeTime": 1767484799999,
      "tradeCount": 1281323,
      "volumeBase": 56891.269,
      "volumeQuote": 5120704164.6601
    }
  ],
  "exchange": "binance",
  "interval": "1d",
  "contractType": "PERPETUAL"
}
GETDepth/v1/finance:binance-futures/depthOrder book for one contract — the resting bids and asks behind the quote.

Parameters

symbolstringrequired
Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925
limitnumberoptional
Levels per side. Default 50, max 1000

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-futures/depth?symbol=BTCUSDT&limit=50" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "asks": [
    {
      "price": 72233.8,
      "amount": 0.113
    },
    {
      "price": 72234.4,
      "amount": 0.001
    },
    {
      "price": 72234.5,
      "amount": 0.001
    },
    {
      "price": 72234.7,
      "amount": 0.002
    },
    {
      "price": 72234.8,
      "amount": 0.001
    },
    {
      "price": 72234.9,
      "amount": 0.003
    }
  ],
  "bids": [
    {
      "price": 72233.7,
      "amount": 1.202
    },
    {
      "price": 72233.6,
      "amount": 1.718
    },
    {
      "price": 72233.5,
      "amount": 0.001
    },
    {
      "price": 72233.2,
      "amount": 0.002
    },
    {
      "price": 72233.1,
      "amount": 0.002
    },
    {
      "price": 72232.1,
      "amount": 0.001
    }
  ],
  "time": 1787238731361,
  "spread": 0.1,
  "symbol": "BTCUSDT",
  "timeIso": "2026-08-20T15:12:11.361Z",
  "askCount": 50,
  "bidCount": 50,
  "exchange": "binance",
  "transactionTime": 1787238731355
}
GETExchange Info/v1/finance:binance-futures/exchange-infoInstrument specifications for USD-M futures: tick size, lot size, minimum

Parameters

symbolstringoptional
One contract. Accepts BTCUSDT, BTC/USDT or a dated contract such as BTCUSDT_260925
symbolsstringoptional
Several contracts, comma separated. Max 100
quoteenumoptional
Restrict to contracts margined in this asset when no symbol is given. Default USDT Values: all, USDT, USDC, BTC, USD1.
contractTypeenumoptional
Keep only one kind of contract. Default all Values: all, PERPETUAL, CURRENT_QUARTER, NEXT_QUARTER, TRADIFI_PERPETUAL.
searchstringoptional
Filter by base asset
statusenumoptional
Keep only tradable contracts, or every listed one including SETTLING and PENDING_TRADING. Default trading Values: all, trading.
countnumberoptional
Rows to return. Default 100, max 500

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-futures/exchange-info?symbol=BTCUSDT&symbols=BTCUSDT%2CETHUSDT&quote=USDT&contractType=PERPETUAL&search=btc&status=trading&count=100" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 100,
  "items": [
    {
      "base": "0G",
      "pair": "0GUSDT",
      "quote": "USDT",
      "maxQty": 4000000,
      "minQty": 1,
      "status": "TRADING",
      "symbol": "0GUSDT",
      "filters": {
        "lotSize": {
          "maxQty": 4000000,
          "minQty": 1,
          "stepSize": 1
        },
        "minNotional": {
          "notional": 5
        },
        "priceFilter": {
          "maxPrice": 200,
          "minPrice": 0.0001,
          "tickSize": 0.0001
        },
        "maxNumOrders": {
          "limit": 200
        },
        "percentPrice": {
          "multiplierUp": 1.15,
          "multiplierDown": 0.85,
          "multiplierDecimal": 4
        },
        "marketLotSize": {
          "maxQty": 400000,
          "minQty": 1,
          "stepSize": 1
        },
        "positionRiskControl": {
          "positionControlSide": "NONE"
        }
      },
      "maxPrice": 200,
      "minPrice": 0.0001,
      "stepSize": 1,
      "tickSize": 0.0001,
      "orderTypes": [
        "LIMIT"
      ],
      "marginAsset": "USDT",
      "minNotional": 5,
      "onboardDate": 1758123900000,
      "permissions": [
        "GRID"
      ],
      "timeInForce": [
        "GTC"
      ],
      "contractType": "PERPETUAL",
      "deliveryDate": 4133404800000,
      "marketMaxQty": 400000,
      "marketMinQty": 1,
      "basePrecision": 8,
      "liquidationFee": 0.02,
      "onboardDateIso": "2025-09-17T15:45:00.000Z",
      "pricePrecision": 7,
      "quotePrecision": 8,
      "triggerProtect": 0.15,
      "underlyingType": "COIN",
      "deliveryDateIso": "2100-12-25T08:00:00.000Z",
      "marketTakeBound": 0.15,
      "maxMoveOrderLimit": 10000,
      "quantityPrecision": 0,
      "underlyingSubType": [
        "Layer-1"
      ],
      "maintMarginPercent": 2.5,
      "requiredMarginPercent": 5
    }
  ],
  "quote": "USDT",
  "total": 700,
  "exchange": "binance",
  "rateLimits": [
    {
      "type": "REQUEST_WEIGHT",
      "limit": 2400,
      "interval": "MINUTE",
      "intervalNum": 1
    }
  ],
  "serverTime": 1787234410884,
  "contractType": "all",
  "serverTimeIso": "2026-08-20T14:00:10.884Z"
}
GETFunding Info/v1/finance:binance-futures/funding-infoThe funding RULES rather than the settled rates: how often each contract

Parameters

symbolstringoptional
One contract. Leave empty to list every contract with custom funding rules
countnumberoptional
Rows to return. Default 200, max 1000

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-futures/funding-info?symbol=LPTUSDT&count=200" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 200,
  "items": [
    {
      "symbol": "0GUSDT",
      "disclaimer": false,
      "updateTime": 1771120860088,
      "updateTimeIso": "2026-02-15T02:01:00.088Z",
      "fundingRateCap": 0.02,
      "fundingRateFloor": -0.02,
      "fundingIntervalHours": 4
    },
    {
      "symbol": "1000000BOBUSDT",
      "disclaimer": false,
      "updateTime": 1749112296983,
      "updateTimeIso": "2025-06-05T08:31:36.983Z",
      "fundingRateCap": 0.02,
      "fundingRateFloor": -0.02,
      "fundingIntervalHours": 4
    },
    {
      "symbol": "1000000MOGUSDT",
      "disclaimer": false,
      "updateTime": 1730982779981,
      "updateTimeIso": "2024-11-07T12:32:59.981Z",
      "fundingRateCap": 0.02,
      "fundingRateFloor": -0.02,
      "fundingIntervalHours": 4
    }
  ],
  "total": 760,
  "symbol": null,
  "exchange": "binance"
}
GETFunding Rate/v1/finance:binance-futures/funding-rateSettled funding history for one contract — what longs actually paid shorts, or

Parameters

symbolstringrequired
Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925
countnumberoptional
Settlements to return, oldest first. Default 100, max 1000 — but without startTime the upstream clamps to 500
startTimestringoptional
Window start, inclusive. ISO date or epoch milliseconds
endTimestringoptional
Window end, inclusive. ISO date or epoch milliseconds

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-futures/funding-rate?symbol=BTCUSDT&count=100&startTime=2026-01-01&endTime=2026-08-01" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 100,
  "items": [
    {
      "symbol": "BTCUSDT",
      "rateType": "Regular",
      "markPrice": 87608.3,
      "fundingRate": 0.0001,
      "fundingTime": 1767225600008,
      "fundingTimeIso": "2026-01-01T00:00:00.008Z",
      "fundingRatePercent": 0.01
    },
    {
      "symbol": "BTCUSDT",
      "rateType": "Regular",
      "markPrice": 87603.80894203,
      "fundingRate": 0.0001,
      "fundingTime": 1767254400002,
      "fundingTimeIso": "2026-01-01T08:00:00.002Z",
      "fundingRatePercent": 0.01
    },
    {
      "symbol": "BTCUSDT",
      "rateType": "Regular",
      "markPrice": 87986.8,
      "fundingRate": 0.00001711,
      "fundingTime": 1767283200001,
      "fundingTimeIso": "2026-01-01T16:00:00.001Z",
      "fundingRatePercent": 0.001711
    }
  ],
  "symbol": "BTCUSDT",
  "exchange": "binance"
}
GETGlobal Long Short Ratio/v1/finance:binance-futures/global-long-short-ratioThe share of ALL accounts holding a long against a short on one contract.

Parameters

symbolstringrequired
Futures contract. Accepts BTCUSDT, BTC/USDT or btc_usdt
periodenumoptional
Bucket size. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d — the upstream refuses 8h. Default 1d Values: 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d.
countnumberoptional
Rows to return, oldest first. Default 30, max 1000
startTimestringoptional
Window start, inclusive. Only the last 30 days exist. ISO date or epoch milliseconds
endTimestringoptional
Window end, inclusive. ISO date or epoch milliseconds

Request

curl -X GET "https://api.zpi.web.id/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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 20,
  "items": [
    {
      "time": 1785542400000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-01T00:00:00.000Z",
      "longAccount": 0.6882,
      "shortAccount": 0.3118,
      "longShortRatio": 2.2072
    },
    {
      "time": 1785628800000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-02T00:00:00.000Z",
      "longAccount": 0.6869,
      "shortAccount": 0.3131,
      "longShortRatio": 2.1939
    },
    {
      "time": 1785715200000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-03T00:00:00.000Z",
      "longAccount": 0.6599,
      "shortAccount": 0.3401,
      "longShortRatio": 1.9403
    },
    {
      "time": 1785801600000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-04T00:00:00.000Z",
      "longAccount": 0.5997,
      "shortAccount": 0.4003,
      "longShortRatio": 1.4981
    },
    {
      "time": 1785888000000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-05T00:00:00.000Z",
      "longAccount": 0.5611,
      "shortAccount": 0.4389,
      "longShortRatio": 1.2784
    },
    {
      "time": 1785974400000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-06T00:00:00.000Z",
      "longAccount": 0.5342,
      "shortAccount": 0.4658,
      "longShortRatio": 1.1468
    }
  ],
  "period": "1d",
  "symbol": "BTCUSDT",
  "exchange": "binance"
}
GETIndex Price Klines/v1/finance:binance-futures/index-price-klinesCandles of the INDEX price for a pair — the spot composite the venue computes

Parameters

pairstringrequired
Underlying pair, not a contract symbol. Accepts BTCUSDT, BTC/USDT or btc_usdt
intervalenumoptional
Candle size. Default 1d. Unlike spot there is no 1s candle Values: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M.
countnumberoptional
Number of candles. Default 500, max 1500 — higher than spot's 1000, and 1501 is refused outright
startTimestringoptional
Oldest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds
endTimestringoptional
Newest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds

Request

curl -X GET "https://api.zpi.web.id/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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "pair": "BTCUSDT",
  "count": 60,
  "candles": [
    {
      "low": 87556.68586957,
      "date": "2026-01-01T00:00:00.000Z",
      "high": 88917.7673913,
      "open": 87646.83543478,
      "close": 88838.44543478,
      "openTime": 1767225600000,
      "closeTime": 1767311999999
    },
    {
      "low": 88402.73217391,
      "date": "2026-01-02T00:00:00.000Z",
      "high": 90937.43826087,
      "open": 88838.44543478,
      "close": 89990.35413043,
      "openTime": 1767312000000,
      "closeTime": 1767398399999
    },
    {
      "low": 89329.85869565,
      "date": "2026-01-03T00:00:00.000Z",
      "high": 90728.18347826,
      "open": 89990.28652174,
      "close": 90630.362,
      "openTime": 1767398400000,
      "closeTime": 1767484799999
    }
  ],
  "exchange": "binance",
  "interval": "1d"
}
GETKlines/v1/finance:binance-futures/klinesOHLCV candles for one USD-M futures contract — perpetual or dated delivery.

Parameters

symbolstringrequired
Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925
intervalenumoptional
Candle size. Default 1d. Unlike spot there is no 1s candle Values: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M.
countnumberoptional
Number of candles. Default 500, max 1500 — higher than spot's 1000, and 1501 is refused outright
startTimestringoptional
Oldest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds
endTimestringoptional
Newest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-futures/klines?symbol=BTCUSDT&interval=1d&count=500&startTime=2026-01-01&endTime=2026-03-01" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 60,
  "symbol": "BTCUSDT",
  "candles": [
    {
      "low": 87508.4,
      "date": "2026-01-01T00:00:00.000Z",
      "high": 88881.4,
      "open": 87608.3,
      "close": 88800,
      "openTime": 1767225600000,
      "closeTime": 1767311999999,
      "tradeCount": 1056983,
      "volumeBase": 47941.303,
      "volumeQuote": 4221684071.5216
    },
    {
      "low": 88324.4,
      "date": "2026-01-02T00:00:00.000Z",
      "high": 90945.1,
      "open": 88800,
      "close": 89951.4,
      "openTime": 1767312000000,
      "closeTime": 1767398399999,
      "tradeCount": 3761821,
      "volumeBase": 176662.448,
      "volumeQuote": 15818436364.5132
    },
    {
      "low": 89261.2,
      "date": "2026-01-03T00:00:00.000Z",
      "high": 90716.9,
      "open": 89951.5,
      "close": 90595.8,
      "openTime": 1767398400000,
      "closeTime": 1767484799999,
      "tradeCount": 1281323,
      "volumeBase": 56891.269,
      "volumeQuote": 5120704164.6601
    }
  ],
  "exchange": "binance",
  "interval": "1d"
}
GETMark Price Klines/v1/finance:binance-futures/mark-price-klinesCandles of the MARK price for one contract — the price liquidations and

Parameters

symbolstringrequired
Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925
intervalenumoptional
Candle size. Default 1d. Unlike spot there is no 1s candle Values: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M.
countnumberoptional
Number of candles. Default 500, max 1500 — higher than spot's 1000, and 1501 is refused outright
startTimestringoptional
Oldest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds
endTimestringoptional
Newest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds

Request

curl -X GET "https://api.zpi.web.id/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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 60,
  "symbol": "BTCUSDT",
  "candles": [
    {
      "low": 87528.2,
      "date": "2026-01-01T00:00:00.000Z",
      "high": 88885.41797101,
      "open": 87608.3,
      "close": 88799.9,
      "openTime": 1767225600000,
      "closeTime": 1767311999999
    },
    {
      "low": 88360.8,
      "date": "2026-01-02T00:00:00.000Z",
      "high": 90924.9,
      "open": 88799.9,
      "close": 89951.89852174,
      "openTime": 1767312000000,
      "closeTime": 1767398399999
    },
    {
      "low": 89271.43899275,
      "date": "2026-01-03T00:00:00.000Z",
      "high": 90717.58831884,
      "open": 89951.89852174,
      "close": 90595.9,
      "openTime": 1767398400000,
      "closeTime": 1767484799999
    },
    {
      "low": 90595.85751667,
      "date": "2026-01-04T00:00:00.000Z",
      "high": 91756.2,
      "open": 90595.85826667,
      "close": 91514.70271739,
      "openTime": 1767484800000,
      "closeTime": 1767571199999
    },
    {
      "low": 91482.75260145,
      "date": "2026-01-05T00:00:00.000Z",
      "high": 94754.7,
      "open": 91512.43532609,
      "close": 93822.3,
      "openTime": 1767571200000,
      "closeTime": 1767657599999
    },
    {
      "low": 91239.88807971,
      "date": "2026-01-06T00:00:00.000Z",
      "high": 94415.4,
      "open": 93822.4,
      "close": 93708.1,
      "openTime": 1767657600000,
      "closeTime": 1767743999999
    }
  ],
  "exchange": "binance",
  "interval": "1d"
}
GETOpen Interest Hist/v1/finance:binance-futures/open-interest-histOpen interest sampled on a fixed bucket — the size of the outstanding position

Parameters

symbolstringrequired
Futures contract. Accepts BTCUSDT, BTC/USDT or btc_usdt
periodenumoptional
Bucket size. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d — the upstream refuses 8h. Default 1d Values: 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d.
countnumberoptional
Rows to return, oldest first. Default 30, max 1000
startTimestringoptional
Window start, inclusive. Only the last 30 days exist. ISO date or epoch milliseconds
endTimestringoptional
Window end, inclusive. ISO date or epoch milliseconds

Request

curl -X GET "https://api.zpi.web.id/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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 20,
  "items": [
    {
      "time": 1785542400000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-01T00:00:00.000Z",
      "openInterest": 109523.589,
      "circulatingSupply": 20063506,
      "openInterestValue": 6884630899.8222
    },
    {
      "time": 1785628800000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-02T00:00:00.000Z",
      "openInterest": 108516.03,
      "circulatingSupply": 20063981,
      "openInterestValue": 6813971110.569
    },
    {
      "time": 1785715200000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-03T00:00:00.000Z",
      "openInterest": 109126.559,
      "circulatingSupply": 20064465,
      "openInterestValue": 6934992824.45
    },
    {
      "time": 1785801600000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-04T00:00:00.000Z",
      "openInterest": 108556.03,
      "circulatingSupply": 20064946,
      "openInterestValue": 6893003948.116
    },
    {
      "time": 1785888000000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-05T00:00:00.000Z",
      "openInterest": 108225.652,
      "circulatingSupply": 20065409,
      "openInterestValue": 6934623587.2912
    },
    {
      "time": 1785974400000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-06T00:00:00.000Z",
      "openInterest": 107104.832,
      "circulatingSupply": 20065865,
      "openInterestValue": 6922603001.0048
    }
  ],
  "period": "1d",
  "symbol": "BTCUSDT",
  "exchange": "binance"
}
GETOpen Interest/v1/finance:binance-futures/open-interestOpen interest on one contract right now: how many contracts are outstanding,

Parameters

symbolstringrequired
Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-futures/open-interest?symbol=BTCUSDT" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "time": 1787238812537,
  "symbol": "BTCUSDT",
  "timeIso": "2026-08-20T15:13:32.537Z",
  "exchange": "binance",
  "openInterest": 109142.214
}
GETPremium Index/v1/finance:binance-futures/premium-indexMark price and index price for one contract, with the funding rate the next

Parameters

symbolstringrequired
Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-futures/premium-index?symbol=BTCUSDT" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "time": 1787238825000,
  "symbol": "BTCUSDT",
  "timeIso": "2026-08-20T15:13:45.000Z",
  "exchange": "binance",
  "markPrice": 72254.67183333,
  "indexPrice": 72290.27086957,
  "interestRate": 0.0001,
  "lastFundingRate": 0.0001,
  "nextFundingTime": 1787241600000,
  "nextFundingTimeIso": "2026-08-20T16:00:00.000Z",
  "estimatedSettlePrice": 71879.31012319,
  "lastFundingRatePercent": 0.01
}
GETTaker Long Short Ratio/v1/finance:binance-futures/taker-long-short-ratioTaker flow on one contract: how much volume crossed the spread to buy against

Parameters

symbolstringrequired
Futures contract. Accepts BTCUSDT, BTC/USDT or btc_usdt
periodenumoptional
Bucket size. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d — the upstream refuses 8h. Default 1d Values: 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d.
countnumberoptional
Rows to return, oldest first. Default 30, max 1000
startTimestringoptional
Window start, inclusive. Only the last 30 days exist. ISO date or epoch milliseconds
endTimestringoptional
Window end, inclusive. ISO date or epoch milliseconds

Request

curl -X GET "https://api.zpi.web.id/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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 20,
  "items": [
    {
      "time": 1785456000000,
      "timeIso": "2026-07-31T00:00:00.000Z",
      "buyVolume": 87864.89,
      "sellVolume": 87100.045,
      "buySellRatio": 1.0088
    },
    {
      "time": 1785542400000,
      "timeIso": "2026-08-01T00:00:00.000Z",
      "buyVolume": 26052.699,
      "sellVolume": 28685.412,
      "buySellRatio": 0.9082
    },
    {
      "time": 1785628800000,
      "timeIso": "2026-08-02T00:00:00.000Z",
      "buyVolume": 42853.182,
      "sellVolume": 41187.225,
      "buySellRatio": 1.0404
    },
    {
      "time": 1785715200000,
      "timeIso": "2026-08-03T00:00:00.000Z",
      "buyVolume": 73781.443,
      "sellVolume": 78062.419,
      "buySellRatio": 0.9452
    },
    {
      "time": 1785801600000,
      "timeIso": "2026-08-04T00:00:00.000Z",
      "buyVolume": 67900.448,
      "sellVolume": 62124.852,
      "buySellRatio": 1.093
    },
    {
      "time": 1785888000000,
      "timeIso": "2026-08-05T00:00:00.000Z",
      "buyVolume": 74933.311,
      "sellVolume": 70186.934,
      "buySellRatio": 1.0676
    }
  ],
  "period": "1d",
  "symbol": "BTCUSDT",
  "exchange": "binance"
}
GETTicker 24hr/v1/finance:binance-futures/ticker-24hrRolling 24-hour statistics for one contract.

Parameters

symbolstringrequired
Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-futures/ticker-24hr?symbol=BTCUSDT" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "low": 66544.4,
  "high": 72598,
  "last": 72248,
  "open": 66588.2,
  "change": 5659.8,
  "symbol": "BTCUSDT",
  "lastQty": 0.03,
  "exchange": "binance",
  "openTime": 1787152440000,
  "closeTime": 1787238843456,
  "tradeCount": 8291638,
  "volumeBase": 416667.919,
  "lastTradeId": 7987900714,
  "volumeQuote": 29103083152.07,
  "firstTradeId": 7979582933,
  "changePercent": 8.5,
  "weightedAvgPrice": 69847.19
}
GETTop Long Short Account Ratio/v1/finance:binance-futures/top-long-short-account-ratioThe same headcount as the global series, restricted to the largest accounts

Parameters

symbolstringrequired
Futures contract. Accepts BTCUSDT, BTC/USDT or btc_usdt
periodenumoptional
Bucket size. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d — the upstream refuses 8h. Default 1d Values: 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d.
countnumberoptional
Rows to return, oldest first. Default 30, max 1000
startTimestringoptional
Window start, inclusive. Only the last 30 days exist. ISO date or epoch milliseconds
endTimestringoptional
Window end, inclusive. ISO date or epoch milliseconds

Request

curl -X GET "https://api.zpi.web.id/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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 20,
  "items": [
    {
      "time": 1785542400000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-01T00:00:00.000Z",
      "longAccount": 0.7031,
      "shortAccount": 0.2969,
      "longShortRatio": 2.3681
    },
    {
      "time": 1785628800000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-02T00:00:00.000Z",
      "longAccount": 0.6933,
      "shortAccount": 0.3067,
      "longShortRatio": 2.2605
    },
    {
      "time": 1785715200000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-03T00:00:00.000Z",
      "longAccount": 0.6625,
      "shortAccount": 0.3375,
      "longShortRatio": 1.963
    },
    {
      "time": 1785801600000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-04T00:00:00.000Z",
      "longAccount": 0.614,
      "shortAccount": 0.386,
      "longShortRatio": 1.5907
    },
    {
      "time": 1785888000000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-05T00:00:00.000Z",
      "longAccount": 0.5696,
      "shortAccount": 0.4304,
      "longShortRatio": 1.3234
    },
    {
      "time": 1785974400000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-06T00:00:00.000Z",
      "longAccount": 0.5472,
      "shortAccount": 0.4528,
      "longShortRatio": 1.2085
    }
  ],
  "period": "1d",
  "symbol": "BTCUSDT",
  "exchange": "binance"
}
GETTop Long Short Position Ratio/v1/finance:binance-futures/top-long-short-position-ratioThe largest accounts' positioning weighted by POSITION rather than by head:

Parameters

symbolstringrequired
Futures contract. Accepts BTCUSDT, BTC/USDT or btc_usdt
periodenumoptional
Bucket size. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d — the upstream refuses 8h. Default 1d Values: 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d.
countnumberoptional
Rows to return, oldest first. Default 30, max 1000
startTimestringoptional
Window start, inclusive. Only the last 30 days exist. ISO date or epoch milliseconds
endTimestringoptional
Window end, inclusive. ISO date or epoch milliseconds

Request

curl -X GET "https://api.zpi.web.id/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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "count": 20,
  "items": [
    {
      "time": 1785542400000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-01T00:00:00.000Z",
      "longAccount": 0.6165,
      "shortAccount": 0.3835,
      "longShortRatio": 1.6072
    },
    {
      "time": 1785628800000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-02T00:00:00.000Z",
      "longAccount": 0.6161,
      "shortAccount": 0.3839,
      "longShortRatio": 1.605
    },
    {
      "time": 1785715200000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-03T00:00:00.000Z",
      "longAccount": 0.6141,
      "shortAccount": 0.3859,
      "longShortRatio": 1.5913
    },
    {
      "time": 1785801600000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-04T00:00:00.000Z",
      "longAccount": 0.6007,
      "shortAccount": 0.3993,
      "longShortRatio": 1.5043
    },
    {
      "time": 1785888000000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-05T00:00:00.000Z",
      "longAccount": 0.606,
      "shortAccount": 0.394,
      "longShortRatio": 1.5381
    },
    {
      "time": 1785974400000,
      "symbol": "BTCUSDT",
      "timeIso": "2026-08-06T00:00:00.000Z",
      "longAccount": 0.6006,
      "shortAccount": 0.3994,
      "longShortRatio": 1.5036
    }
  ],
  "period": "1d",
  "symbol": "BTCUSDT",
  "exchange": "binance"
}

Related APIs

More in finance

Pluang

finance/pluang

Data pasar Pluang lintas aset: order book, running trade, tradebook dan ringkasan broker per saham IDX, plus saham Amerika, emas, kripto, sinyal analis dan berita.

23.3K calls·1d cache

Binance Vision

finance/binance-vision

Binance's public bulk archive: klines, 5-minute open-interest and long/short metrics, funding, book depth and liquidations, back to 2017.

4.7K calls·1d cache

TradingView

finance/tradingview

Screener, charts, technical indicators, fundamentals, news and the macro calendar across 16 markets — Indonesian equities, US equities, crypto, forex and futures.

52.7K calls·1d cache

Stockbit

finance/stockbit

Data saham IDX dari Stockbit: harga, chart intraday, profil emiten, diskusi komunitas, dan kamus investasi.

17.5K calls·1d cache

Yahoo Finance

finance/yahoo-finance

Global quotes, fundamentals, statements, options, earnings, ownership and analyst coverage. Jakarta listings via the .JK suffix.

12.7K calls·5m cache

IDX (Bursa Efek Indonesia)

finance/idx

Data Bursa Efek Indonesia: ringkasan saham & indeks, top movers, broker, emiten, laporan keuangan, berita, dan passthrough ke ratusan endpoint /primary/.

75.6K calls·1d cache
Browse APIsPricingDocsMCP serverGet an API key
zapi.One key, one response shape.
TermsPrivacyCookiesAUPRefunds© 2026