Yes. The Free tier is 600 requests a month at 100 requests a minute, across every endpoint in the catalog, with no credit card. Nothing about it expires.

What happens when I hit the quota?

Requests return 429 with the limit, what you have used, and which window you tripped — nothing is queued, and nothing is charged. The monthly quota resets on the 1st (UTC). There is no rollover: unused requests do not carry into the next month.

Do failed requests use up my quota?

A 5xx does not. If a source breaks on our side, the request is excluded from your monthly count. A 4xx does count — a wrong parameter is still a request we answered. Per-minute throttling counts everything, so a retry loop is still throttled.

Which tier do I need?

Start on Free. Every response carries the remaining quota in its headers, and the dashboard reads the same number enforcement uses, so you will see the ceiling coming rather than discovering it.

How is Zapi different from RapidAPI or Apify?

Zapi focuses on a consistent REST contract — one API key, one response format, one error pattern for every source. No need to learn per-provider quirks like on traditional marketplaces, and no need to set up scraping workflows like on Apify.

What about the legality of accessing public data?

Zapi only accesses data that is publicly available without a login. Responsibility for how it is ultimately used stays with the developer — make sure your use case complies with the original source's ToS and the regulations in your operating region.

Is there an official SDK?

One: zpi-sdk, for TypeScript and JavaScript. It carries a typed error hierarchy, retries only what is safe to retry, submits bulk jobs, and verifies webhook signatures. Everything else is plain REST — cURL or any HTTP client works.

Can I request a source that isn't in the catalog yet?

Yes, through the community Discord, on any tier.

Why are Pro and Ultra marked Soon?

Checkout is not open yet. The limits and features listed on those tiers are already built and enforced — what is pending is billing, not the product.

Binance Futures

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

llms.txt

Endpoints19

12/19 passing
checked 20 hours ago · daily 01:00 WIB

Agg Trades

Compressed trades for one contract: fills at the same price, from the same

GET/v1/finance:binance-futures/agg-trades5s cache5 paramschecking key…

Parameters

Response

EXAMPLE

{
  "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
    }
  ],
  "symbol": "BTCUSDT",
  "exchange": "binance"
}

Code

Agg Trades

index.ts

// 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);

Recommended · typed errors, safe retries and bulk jobsSDK reference

Full reference

19 endpoints · plain text

GET

Agg Trades/v1/finance:binance-futures/agg-trades

5 params

Compressed 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "symbol": "BTCUSDT",
  "exchange": "binance"
}

GET

Basis/v1/finance:binance-futures/basis

6 params

The 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "period": "1d",
  "exchange": "binance",
  "contractType": "PERPETUAL"
}

GET

Book Ticker/v1/finance:binance-futures/book-ticker

1 param

Best 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.zapi.ink/v1/finance:binance-futures/book-ticker?symbol=BTCUSDT" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
}

GET

Continuous Klines/v1/finance:binance-futures/continuous-klines

6 params

OHLCV 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "exchange": "binance",
  "interval": "1d",
  "contractType": "PERPETUAL"
}

GET

Depth/v1/finance:binance-futures/depth

2 params

Order 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.zapi.ink/v1/finance:binance-futures/depth?symbol=BTCUSDT&limit=50" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
}

GET

Exchange Info/v1/finance:binance-futures/exchange-info

7 params

Instrument 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.zapi.ink/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": 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"
      ],
      "marginAsset": "USDT",
      "minNotional": 50,
      "onboardDate": 1567965300000,
      "permissions": [
        "GRID"
      ],
      "timeInForce": [
        "GTC"
      ],
      "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
    }
  ],
  "serverTime": 1787472010896,
  "contractType": "all",
  "serverTimeIso": "2026-08-23T08:00:10.896Z"
}

GET

Funding Info/v1/finance:binance-futures/funding-info

2 params

The 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.zapi.ink/v1/finance:binance-futures/funding-info?symbol=LPTUSDT&count=200" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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"
}

GET

Funding Rate/v1/finance:binance-futures/funding-rate

4 params

Settled 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.zapi.ink/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": 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",
  "exchange": "binance"
}

GET

Global Long Short Ratio/v1/finance:binance-futures/global-long-short-ratio

5 params

The 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "period": "1d",
  "symbol": "BTCUSDT",
  "exchange": "binance"
}

GET

Index Price Klines/v1/finance:binance-futures/index-price-klines

5 params

Candles 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "exchange": "binance",
  "interval": "1d"
}

GET

Klines/v1/finance:binance-futures/klines

5 params

OHLCV 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "exchange": "binance",
  "interval": "1d"
}

GET

Mark Price Klines/v1/finance:binance-futures/mark-price-klines

5 params

Candles 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "exchange": "binance",
  "interval": "1d"
}

GET

Open Interest Hist/v1/finance:binance-futures/open-interest-hist

5 params

Open 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "period": "1d",
  "symbol": "BTCUSDT",
  "exchange": "binance"
}

GET

Open Interest/v1/finance:binance-futures/open-interest

1 param

Open 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.zapi.ink/v1/finance:binance-futures/open-interest?symbol=BTCUSDT" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "time": 1787475070104,
  "symbol": "BTCUSDT",
  "timeIso": "2026-08-23T08:51:10.104Z",
  "exchange": "binance",
  "openInterest": 107311.42
}

GET

Premium Index/v1/finance:binance-futures/premium-index

1 param

Mark 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.zapi.ink/v1/finance:binance-futures/premium-index?symbol=BTCUSDT" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
}

GET

Taker Long Short Ratio/v1/finance:binance-futures/taker-long-short-ratio

5 params

Taker 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "period": "1d",
  "symbol": "BTCUSDT",
  "exchange": "binance"
}

GET

Ticker 24hr/v1/finance:binance-futures/ticker-24hr

1 param

Rolling 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.zapi.ink/v1/finance:binance-futures/ticker-24hr?symbol=BTCUSDT" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
}

GET

Top Long Short Account Ratio/v1/finance:binance-futures/top-long-short-account-ratio

5 params

The 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "period": "1d",
  "symbol": "BTCUSDT",
  "exchange": "binance"
}

GET

Top Long Short Position Ratio/v1/finance:binance-futures/top-long-short-position-ratio

5 params

The 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "period": "1d",
  "symbol": "BTCUSDT",
  "exchange": "binance"
}

Binance Futures

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

llms.txt

Endpoints19

12/19 passing
checked 20 hours ago · daily 01:00 WIB

Agg Trades

Compressed trades for one contract: fills at the same price, from the same

GET/v1/finance:binance-futures/agg-trades5s cache5 paramschecking key…

Parameters

Response

EXAMPLE

{
  "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
    }
  ],
  "symbol": "BTCUSDT",
  "exchange": "binance"
}

Code

Agg Trades

index.ts

// 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);

Recommended · typed errors, safe retries and bulk jobsSDK reference

Full reference

19 endpoints · plain text

GET

Agg Trades/v1/finance:binance-futures/agg-trades

5 params

Compressed 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "symbol": "BTCUSDT",
  "exchange": "binance"
}

GET

Basis/v1/finance:binance-futures/basis

6 params

The 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "period": "1d",
  "exchange": "binance",
  "contractType": "PERPETUAL"
}

GET

Book Ticker/v1/finance:binance-futures/book-ticker

1 param

Best 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.zapi.ink/v1/finance:binance-futures/book-ticker?symbol=BTCUSDT" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
}

GET

Continuous Klines/v1/finance:binance-futures/continuous-klines

6 params

OHLCV 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "exchange": "binance",
  "interval": "1d",
  "contractType": "PERPETUAL"
}

GET

Depth/v1/finance:binance-futures/depth

2 params

Order 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.zapi.ink/v1/finance:binance-futures/depth?symbol=BTCUSDT&limit=50" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
}

GET

Exchange Info/v1/finance:binance-futures/exchange-info

7 params

Instrument 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.zapi.ink/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": 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"
      ],
      "marginAsset": "USDT",
      "minNotional": 50,
      "onboardDate": 1567965300000,
      "permissions": [
        "GRID"
      ],
      "timeInForce": [
        "GTC"
      ],
      "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
    }
  ],
  "serverTime": 1787472010896,
  "contractType": "all",
  "serverTimeIso": "2026-08-23T08:00:10.896Z"
}

GET

Funding Info/v1/finance:binance-futures/funding-info

2 params

The 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.zapi.ink/v1/finance:binance-futures/funding-info?symbol=LPTUSDT&count=200" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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"
}

GET

Funding Rate/v1/finance:binance-futures/funding-rate

4 params

Settled 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.zapi.ink/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": 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",
  "exchange": "binance"
}

GET

Global Long Short Ratio/v1/finance:binance-futures/global-long-short-ratio

5 params

The 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "period": "1d",
  "symbol": "BTCUSDT",
  "exchange": "binance"
}

GET

Index Price Klines/v1/finance:binance-futures/index-price-klines

5 params

Candles 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "exchange": "binance",
  "interval": "1d"
}

GET

Klines/v1/finance:binance-futures/klines

5 params

OHLCV 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "exchange": "binance",
  "interval": "1d"
}

GET

Mark Price Klines/v1/finance:binance-futures/mark-price-klines

5 params

Candles 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "exchange": "binance",
  "interval": "1d"
}

GET

Open Interest Hist/v1/finance:binance-futures/open-interest-hist

5 params

Open 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "period": "1d",
  "symbol": "BTCUSDT",
  "exchange": "binance"
}

GET

Open Interest/v1/finance:binance-futures/open-interest

1 param

Open 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.zapi.ink/v1/finance:binance-futures/open-interest?symbol=BTCUSDT" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "time": 1787475070104,
  "symbol": "BTCUSDT",
  "timeIso": "2026-08-23T08:51:10.104Z",
  "exchange": "binance",
  "openInterest": 107311.42
}

GET

Premium Index/v1/finance:binance-futures/premium-index

1 param

Mark 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.zapi.ink/v1/finance:binance-futures/premium-index?symbol=BTCUSDT" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
}

GET

Taker Long Short Ratio/v1/finance:binance-futures/taker-long-short-ratio

5 params

Taker 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "period": "1d",
  "symbol": "BTCUSDT",
  "exchange": "binance"
}

GET

Ticker 24hr/v1/finance:binance-futures/ticker-24hr

1 param

Rolling 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.zapi.ink/v1/finance:binance-futures/ticker-24hr?symbol=BTCUSDT" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
}

GET

Top Long Short Account Ratio/v1/finance:binance-futures/top-long-short-account-ratio

5 params

The 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "period": "1d",
  "symbol": "BTCUSDT",
  "exchange": "binance"
}

GET

Top Long Short Position Ratio/v1/finance:binance-futures/top-long-short-position-ratio

5 params

The 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.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: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
    }
  ],
  "period": "1d",
  "symbol": "BTCUSDT",
  "exchange": "binance"
}

Agg Trades

Code

Full reference

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Related APIs

Pluang

IDX (Bursa Efek Indonesia)

TradingView

Stockbit

Investing

Yahoo Finance

Agg Trades

Code

Full reference

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Parameters