Yes. The Free tier is 600 requests a month at 100 requests a minute, across every endpoint in the catalogue, 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 catalogue yet?

Yes, through the community Discord, on any tier.

Binance Futures

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

19 endpoints40.7k calls7/19 passing

Get API key

Agg Trades

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

GET/v1/finance:binance-futures/agg-trades

failed last check5s cache

Parameters

Name	Type	In	Description
symbol	string	query	Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925. Required.
count	number	query	Rows to return, newest last. Default 500, max 1000.
startTime	string	query	Window start, inclusive. Only the last 2 days exist. ISO timestamp or epoch milliseconds.
endTime	string	query	Window end, inclusive. ISO timestamp or epoch milliseconds.
fromId	string	query	Resume from this aggregate trade id instead of a time window.

Example response

{"project":"finance:binance-futures",  "data": {"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"  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Basis

The gap between a futures contract and its index — the carry a calendar spread

GET/v1/finance:binance-futures/basis

failed last check1m cache

Parameters

Name	Type	In	Description
pair	string	query	Underlying pair, not a contract symbol. Accepts BTCUSDT, BTC/USDT or btc_usdt. Required.
contractType	enum	query	Which contract to measure against the index. Default PERPETUAL. One of PERPETUAL, CURRENT_QUARTER, NEXT_QUARTER.
period	enum	query	Bucket size. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d — the upstream refuses 8h. Default 1d. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d.
count	number	query	Rows to return, oldest first. Default 30, max 1000.
startTime	string	query	Window start, inclusive. Only the last 30 days exist. ISO date or epoch milliseconds.
endTime	string	query	Window end, inclusive. ISO date or epoch milliseconds.

Example response

{"project":"finance:binance-futures",  "data": {"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"  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Book Ticker

Best bid and ask on one contract — the top of the book without the depth.

GET/v1/finance:binance-futures/book-ticker

failed last check5s cache

Parameters

Name	Type	In	Description
symbol	string	query	Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925. Required.

Example response

{"project":"finance:binance-futures",  "data": {"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  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Continuous Klines

OHLCV candles for a continuous contract: one unbroken series across successive

GET/v1/finance:binance-futures/continuous-klines

failed last check30s cache

Parameters

Name	Type	In	Description
pair	string	query	Underlying pair, not a contract symbol. Accepts BTCUSDT, BTC/USDT or btc_usdt. Required.
contractType	enum	query	Which contract in the series. Default PERPETUAL. One of PERPETUAL, CURRENT_QUARTER, NEXT_QUARTER, TRADIFI_PERPETUAL.
interval	enum	query	Candle size. Default 1d. Unlike spot there is no 1s candle. One of 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M.
count	number	query	Number of candles. Default 500, max 1500 — higher than spot's 1000, and 1501 is refused outright.
startTime	string	query	Oldest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds.
endTime	string	query	Newest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds.

Example response

{"project":"finance:binance-futures",  "data": {"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"  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Depth

Order book for one contract — the resting bids and asks behind the quote.

GET/v1/finance:binance-futures/depth

failed last check10s cache

Parameters

Name	Type	In	Description
symbol	string	query	Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925. Required.
limit	number	query	Levels per side. Default 50, max 1000.

Example response

{"project":"finance:binance-futures",  "data": {    "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  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Exchange Info

Instrument specifications for USD-M futures: tick size, lot size, minimum

GET/v1/finance:binance-futures/exchange-info

failed last check10m cache

Parameters

Name	Type	In	Description
symbol	string	query	One contract. Accepts BTCUSDT, BTC/USDT or a dated contract such as BTCUSDT_260925.
symbols	string	query	Several contracts, comma separated. Max 100.
quote	enum	query	Restrict to contracts margined in this asset when no symbol is given. Default USDT. One of all, USDT, USDC, BTC, USD1.
contractType	enum	query	Keep only one kind of contract. Default all. One of all, PERPETUAL, CURRENT_QUARTER, NEXT_QUARTER, TRADIFI_PERPETUAL.
search	string	query	Filter by base asset.
status	enum	query	Keep only tradable contracts, or every listed one including SETTLING and PENDING_TRADING. Default trading. One of all, trading.
count	number	query	Rows to return. Default 100, max 500.

Example response

{"project":"finance:binance-futures",  "data": {"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"  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Funding Info

The funding RULES rather than the settled rates: how often each contract

GET/v1/finance:binance-futures/funding-info

failed last check10m cache

Parameters

Name	Type	In	Description
symbol	string	query	One contract. Leave empty to list every contract with custom funding rules.
count	number	query	Rows to return. Default 200, max 1000.

Example response

{"project":"finance:binance-futures",  "data": {"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"  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Funding Rate

Settled funding history for one contract — what longs actually paid shorts, or

GET/v1/finance:binance-futures/funding-rate

failed last check1m cache

Parameters

Name	Type	In	Description
symbol	string	query	Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925. Required.
count	number	query	Settlements to return, oldest first. Default 100, max 1000 — but without startTime the upstream clamps to 500.
startTime	string	query	Window start, inclusive. ISO date or epoch milliseconds.
endTime	string	query	Window end, inclusive. ISO date or epoch milliseconds.

Example response

{"project":"finance:binance-futures",  "data": {"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"  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Global Long Short Ratio

The share of ALL accounts holding a long against a short on one contract.

GET/v1/finance:binance-futures/global-long-short-ratio

failed last check1m cache

Parameters

Name	Type	In	Description
symbol	string	query	Futures contract. Accepts BTCUSDT, BTC/USDT or btc_usdt. Required.
period	enum	query	Bucket size. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d — the upstream refuses 8h. Default 1d. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d.
count	number	query	Rows to return, oldest first. Default 30, max 1000.
startTime	string	query	Window start, inclusive. Only the last 30 days exist. ISO date or epoch milliseconds.
endTime	string	query	Window end, inclusive. ISO date or epoch milliseconds.

Example response

{"project":"finance:binance-futures",  "data": {"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"  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Index Price Klines

Candles of the INDEX price for a pair — the spot composite the venue computes

GET/v1/finance:binance-futures/index-price-klines

failed last check30s cache

Parameters

Name	Type	In	Description
pair	string	query	Underlying pair, not a contract symbol. Accepts BTCUSDT, BTC/USDT or btc_usdt. Required.
interval	enum	query	Candle size. Default 1d. Unlike spot there is no 1s candle. One of 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M.
count	number	query	Number of candles. Default 500, max 1500 — higher than spot's 1000, and 1501 is refused outright.
startTime	string	query	Oldest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds.
endTime	string	query	Newest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds.

Example response

{"project":"finance:binance-futures",  "data": {"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"  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Klines

OHLCV candles for one USD-M futures contract — perpetual or dated delivery.

GET/v1/finance:binance-futures/klines

failed last check30s cache

Parameters

Name	Type	In	Description
symbol	string	query	Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925. Required.
interval	enum	query	Candle size. Default 1d. Unlike spot there is no 1s candle. One of 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M.
count	number	query	Number of candles. Default 500, max 1500 — higher than spot's 1000, and 1501 is refused outright.
startTime	string	query	Oldest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds.
endTime	string	query	Newest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds.

Example response

{"project":"finance:binance-futures",  "data": {"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"  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Mark Price Klines

Candles of the MARK price for one contract — the price liquidations and

GET/v1/finance:binance-futures/mark-price-klines

failed last check30s cache

Parameters

Name	Type	In	Description
symbol	string	query	Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925. Required.
interval	enum	query	Candle size. Default 1d. Unlike spot there is no 1s candle. One of 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M.
count	number	query	Number of candles. Default 500, max 1500 — higher than spot's 1000, and 1501 is refused outright.
startTime	string	query	Oldest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds.
endTime	string	query	Newest candle to return, matched on its open time and inclusive. ISO date or epoch milliseconds.

Example response

{"project":"finance:binance-futures",  "data": {"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"  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Open Interest Hist

Open interest sampled on a fixed bucket — the size of the outstanding position

GET/v1/finance:binance-futures/open-interest-hist

slow · 4.4s1m cache

Parameters

Name	Type	In	Description
symbol	string	query	Futures contract. Accepts BTCUSDT, BTC/USDT or btc_usdt. Required.
period	enum	query	Bucket size. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d — the upstream refuses 8h. Default 1d. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d.
count	number	query	Rows to return, oldest first. Default 30, max 1000.
startTime	string	query	Window start, inclusive. Only the last 30 days exist. ISO date or epoch milliseconds.
endTime	string	query	Window end, inclusive. ISO date or epoch milliseconds.

Example response

{"project":"finance:binance-futures",  "data": {"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"  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Open Interest

Open interest on one contract right now: how many contracts are outstanding,

GET/v1/finance:binance-futures/open-interest

passing · 0.2s5s cache

Parameters

Name	Type	In	Description
symbol	string	query	Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925. Required.

Example response

{"project":"finance:binance-futures",  "data": {"time":1787475070104,"symbol":"BTCUSDT","timeIso":"2026-08-23T08:51:10.104Z","exchange":"binance","openInterest":107311.42  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Premium Index

Mark price and index price for one contract, with the funding rate the next

GET/v1/finance:binance-futures/premium-index

passing · 0.2s5s cache

Parameters

Name	Type	In	Description
symbol	string	query	Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925. Required.

Example response

{"project":"finance:binance-futures",  "data": {"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  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Taker Long Short Ratio

Taker flow on one contract: how much volume crossed the spread to buy against

GET/v1/finance:binance-futures/taker-long-short-ratio

passing · 0.2s1m cache

Parameters

Name	Type	In	Description
symbol	string	query	Futures contract. Accepts BTCUSDT, BTC/USDT or btc_usdt. Required.
period	enum	query	Bucket size. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d — the upstream refuses 8h. Default 1d. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d.
count	number	query	Rows to return, oldest first. Default 30, max 1000.
startTime	string	query	Window start, inclusive. Only the last 30 days exist. ISO date or epoch milliseconds.
endTime	string	query	Window end, inclusive. ISO date or epoch milliseconds.

Example response

{"project":"finance:binance-futures",  "data": {"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"  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Ticker 24hr

Rolling 24-hour statistics for one contract.

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

slow · 1.2s15s cache

Parameters

Name	Type	In	Description
symbol	string	query	Futures contract. Accepts BTCUSDT, BTC/USDT, btc_usdt, or a dated contract such as BTCUSDT_260925. Required.

Example response

{"project":"finance:binance-futures",  "data": {"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  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Top Long Short Account Ratio

The same headcount as the global series, restricted to the largest accounts

GET/v1/finance:binance-futures/top-long-short-account-ratio

slow · 2.2s1m cache

Parameters

Name	Type	In	Description
symbol	string	query	Futures contract. Accepts BTCUSDT, BTC/USDT or btc_usdt. Required.
period	enum	query	Bucket size. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d — the upstream refuses 8h. Default 1d. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d.
count	number	query	Rows to return, oldest first. Default 30, max 1000.
startTime	string	query	Window start, inclusive. Only the last 30 days exist. ISO date or epoch milliseconds.
endTime	string	query	Window end, inclusive. ISO date or epoch milliseconds.

Example response

{"project":"finance:binance-futures",  "data": {"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"  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Top Long Short Position Ratio

The largest accounts' positioning weighted by POSITION rather than by head:

GET/v1/finance:binance-futures/top-long-short-position-ratio

passing · 0.2s1m cache

Parameters

Name	Type	In	Description
symbol	string	query	Futures contract. Accepts BTCUSDT, BTC/USDT or btc_usdt. Required.
period	enum	query	Bucket size. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d — the upstream refuses 8h. Default 1d. One of 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d.
count	number	query	Rows to return, oldest first. Default 30, max 1000.
startTime	string	query	Window start, inclusive. Only the last 30 days exist. ISO date or epoch milliseconds.
endTime	string	query	Window end, inclusive. ISO date or epoch milliseconds.

Example response

{"project":"finance:binance-futures",  "data": {"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"  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Try it

Live request with your key

const data = await client.run(  "finance:binance-futures",  "agg-trades",  { symbol: "BTCUSDT", count: 500, startTime: "2026-08-20T00:00:00Z", endTime: "2026-08-20T01:00:00Z", fromId: "3413731512" });

Binance Futures

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

19 endpoints40.7k calls7/19 passing

Get API key

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

GET/v1/…binance-futures/agg-trades

failed last check5s cache

Try it

Parameters

symbol

string · query · required

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

count

number · query · optional

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

startTime

string · query · optional

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

endTime

string · query · optional

Window end, inclusive. ISO timestamp or epoch milliseconds.

fromId

string · query · optional

Resume from this aggregate trade id instead of a time window.

Example response

{"project":"finance:binance-futures",  "data": {"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"  },"timestamp":"2026-08-20T16:59:35Z"}

Errors

401Missing or invalid x-api-key
404Not found or private
429Rate limit or monthly quota reached

Code

const data = await client.run(  "finance:binance-futures",  "agg-trades",  { symbol: "BTCUSDT", count: 500, startTime: "2026-08-20T00:00:00Z", endTime: "2026-08-20T01:00:00Z", fromId: "3413731512" });