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 Vision

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

15 endpoints8.1k calls15/15 passing

Get API key

Agg Trades

Aggregated trades — one row per run of same-side fills at one price. A BTCUSDT

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

passing · 1.8s1d cache

Parameters

Name	Type	In	Description
symbol	string	query	Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined). Required.
date	string	query	YYYY-MM-DD for a daily archive, YYYY-MM for a monthly one. Futures run from 2019-12-31 and spot from 2017-08-17. Required.
market	enum	query	um (USD-margined futures), spot, cm (coin-margined futures). Default um. One of um, spot, cm.
page	number	query	Page of rows. Default 1.
limit	number	query	Rows per page. Default 10000, max 50000.

Example response

{"project":"finance:binance-vision",  "data": {"date":"2026-08-18","page":1,"count":10000,    "items": [      {"price":64504.1,"quantity":0.026,"aggTradeId":3409890025,"isBestMatch":null,"lastTradeId":7976144183,"firstTradeId":7976144181,"isBuyerMaker":true,"transactTime":1787011200015,"transactTimeIso":"2026-08-18T00:00:00.015Z"      },      {"price":64504.2,"quantity":0.078,"aggTradeId":3409890026,"isBestMatch":null,"lastTradeId":7976144187,"firstTradeId":7976144184,"isBuyerMaker":false,"transactTime":1787011200092,"transactTimeIso":"2026-08-18T00:00:00.092Z"      },      {"price":64504.2,"quantity":1.713,"aggTradeId":3409890027,"isBestMatch":null,"lastTradeId":7976144201,"firstTradeId":7976144188,"isBuyerMaker":false,"transactTime":1787011200206,"transactTimeIso":"2026-08-18T00:00:00.206Z"      }    ],"total":545233,"market":"um","period":"daily","symbol":"BTCUSDT","dataset":"agg-trades","hasMore":true,    "checksum": {"sha256":"0c1e12cf9577020702f824146734914271937f7b3c332ef13f5b7e44df246258","verified":true    },"nextPage":2,"provider":"binance-vision","timestampUnit":"ms"  },"timestamp":"2026-08-20T14:52:19Z"}

Errors

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

Book Depth

Order-book depth sampled every 30 seconds across twelve price bands, one UTC day

GET/v1/finance:binance-vision/book-depth

passing · 1.1s1d cache

Parameters

Name	Type	In	Description
symbol	string	query	Futures symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined). Required.
date	string	query	UTC day, YYYY-MM-DD. Published from 2023-01-01 to T-1, with no file for 2023-02-08, 2023-02-09 or 2024-04-18. Required.
market	enum	query	um (USD-margined futures), cm (coin-margined futures). Default um. One of um, cm.
percentage	number	query	Keep one band only. Bands present: -5, -4, -3, -2, -1, -0.2, 0.2, 1, 2, 3, 4, 5.
page	number	query	Page of rows. Default 1.
limit	number	query	Rows per page. Default 2880, max 10000.

Example response

{"project":"finance:binance-vision",  "data": {"date":"2026-08-18","page":1,    "bands": [      -5,      -4,      -3    ],"count":2880,    "items": [      {"depth":786.859,"notional":50816122.798,"timestamp":1787011206000,"percentage":0.2,"timestampIso":"2026-08-18T00:00:06.000Z"      },      {"depth":922.184,"notional":59572413.1697,"timestamp":1787011233000,"percentage":0.2,"timestampIso":"2026-08-18T00:00:33.000Z"      },      {"depth":909.812,"notional":58768136.9999,"timestamp":1787011262000,"percentage":0.2,"timestampIso":"2026-08-18T00:01:02.000Z"      }    ],"total":2880,"market":"um","symbol":"BTCUSDT","dataset":"book-depth","hasMore":false,    "checksum": {"sha256":"49d48cb486ac68c314f77beb4b7df328e140972165a2fce955cbfe4e8f30b279","verified":true    },"nextPage":null,"provider":"binance-vision","percentage":0.2,"missingRows":0,"expectedRows":2880,"timestampUnit":"ms","sampleIntervalSeconds":30  },"timestamp":"2026-08-20T14:52:19Z"}

Errors

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

Checksum

Downloads one archive and checks it against the SHA-256 Binance publishes beside

GET/v1/finance:binance-vision/checksum

passing · 0.4s1d cache

Parameters

Name	Type	In	Description
symbol	string	query	Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined). Required.
date	string	query	YYYY-MM-DD for a daily archive, YYYY-MM for a monthly one. Required.
series	enum	query	Archive series. Default klines. One of klines, mark-price-klines, index-price-klines, premium-index-klines, metrics, funding-rate, book-depth, book-ticker, agg-trades, trades, liquidations.
market	enum	query	spot, um (USD-margined futures), cm (coin-margined futures). Default um. One of spot, um, cm.
interval	enum	query	Candle interval, for kline series only; the monthly token is 1mo, not 1M. Default 5m. One of 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo.

Example response

{"project":"finance:binance-vision",  "data": {"url":"https://data.binance.vision/data/futures/um/daily/klines/BTCUSDT/5m/BTCUSDT-5m-2026-08-18.zip","date":"2026-08-18","bytes":13277,"market":"um","period":"daily","series":"klines","sha256":"88af317df415c466291381545fdb1f767d9bd3cf510598e999bf2f446fe63790","symbol":"BTCUSDT","dataset":"checksum","interval":"5m","provider":"binance-vision","verified":true,"lastModified":"2026-08-19T09:19:14.000Z","publishedSha256":"88af317df415c466291381545fdb1f767d9bd3cf510598e999bf2f446fe63790"  },"timestamp":"2026-08-20T14:52:19Z"}

Errors

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

Datasets

Which series a market publishes at a given cadence. The asymmetries are real:

GET/v1/finance:binance-vision/datasets

passing · 0.6s1d cache

Parameters

Name	Type	In	Description
market	enum	query	spot, um (USD-margined futures), cm (coin-margined futures). Default um. One of spot, um, cm.
period	enum	query	Archive cadence. Default daily. One of daily, monthly.

Example response

{"project":"finance:binance-vision",  "data": {"count":10,    "items": [      {"prefix":"data/futures/um/daily/aggTrades/","series":"agg-trades"      },      {"prefix":"data/futures/um/daily/bookDepth/","series":"book-depth"      },      {"prefix":"data/futures/um/daily/bookTicker/","series":"book-ticker"      },      {"prefix":"data/futures/um/daily/indexPriceKlines/","series":"index-price-klines"      },      {"prefix":"data/futures/um/daily/klines/","series":"klines"      },      {"prefix":"data3/liquidationSnapshot/","series":"liquidations"      }    ],"market":"um","period":"daily","dataset":"datasets","provider":"binance-vision"  },"timestamp":"2026-08-20T14:52:19Z"}

Errors

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

Dates

Which days or months actually exist for one symbol and series — the backfill

GET/v1/finance:binance-vision/dates

passing · 0.3s1h cache

Parameters

Name	Type	In	Description
symbol	string	query	Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined). Required.
series	enum	query	Archive series. Default klines. One of klines, mark-price-klines, index-price-klines, premium-index-klines, metrics, funding-rate, book-depth, book-ticker, agg-trades, trades, liquidations.
market	enum	query	spot, um (USD-margined futures), cm (coin-margined futures). Default um. One of spot, um, cm.
period	enum	query	Archive cadence. Default daily. One of daily, monthly.
interval	enum	query	Candle interval, for kline series only; the monthly token is 1mo, not 1M. Default 5m. One of 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo.
from	string	query	Start at this date, YYYY-MM-DD or YYYY-MM. Skips straight there in the index.
to	string	query	Stop after this date, YYYY-MM-DD or YYYY-MM.
page	number	query	Page of dates. Default 1.
limit	number	query	Dates per page. Default 200, max 1000.

Example response

{"project":"finance:binance-vision",  "data": {"to":"2026-08-19","from":"2026-08-01","page":1,"count":19,    "items": [      {"url":"https://data.binance.vision/data/futures/um/daily/klines/BTCUSDT/5m/BTCUSDT-5m-2026-08-01.zip","date":"2026-08-01","bytes":12923,"checksumUrl":"https://data.binance.vision/data/futures/um/daily/klines/BTCUSDT/5m/BTCUSDT-5m-2026-08-01.zip.CHECKSUM","lastModified":"2026-08-02T09:38:55.000Z"      },      {"url":"https://data.binance.vision/data/futures/um/daily/klines/BTCUSDT/5m/BTCUSDT-5m-2026-08-02.zip","date":"2026-08-02","bytes":13232,"checksumUrl":"https://data.binance.vision/data/futures/um/daily/klines/BTCUSDT/5m/BTCUSDT-5m-2026-08-02.zip.CHECKSUM","lastModified":"2026-08-03T09:59:11.000Z"      },      {"url":"https://data.binance.vision/data/futures/um/daily/klines/BTCUSDT/5m/BTCUSDT-5m-2026-08-03.zip","date":"2026-08-03","bytes":13684,"checksumUrl":"https://data.binance.vision/data/futures/um/daily/klines/BTCUSDT/5m/BTCUSDT-5m-2026-08-03.zip.CHECKSUM","lastModified":"2026-08-04T09:38:23.000Z"      }    ],"market":"um","period":"daily","series":"klines","symbol":"BTCUSDT","dataset":"dates","hasMore":false,"interval":"5m","nextPage":null,"provider":"binance-vision"  },"timestamp":"2026-08-20T14:52:19Z"}

Errors

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

Funding Rate

Realised funding for one perpetual, one calendar month per archive.

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

passing · 0.4s1d cache

Parameters

Name	Type	In	Description
symbol	string	query	Perpetual symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined). Required.
date	string	query	Calendar month, YYYY-MM. Published monthly only, from 2020-01, and the current month appears once it closes. Required.
market	enum	query	um (USD-margined futures), cm (coin-margined futures). Default um. One of um, cm.

Example response

{"project":"finance:binance-vision",  "data": {"count":93,    "items": [      {"calcTime":1782864000000,"calcTimeIso":"2026-07-01T00:00:00.000Z","lastFundingRate":0.00005532,"fundingIntervalHours":8      },      {"calcTime":1782892800000,"calcTimeIso":"2026-07-01T08:00:00.000Z","lastFundingRate":0.00001853,"fundingIntervalHours":8      },      {"calcTime":1782921600000,"calcTimeIso":"2026-07-01T16:00:00.000Z","lastFundingRate":0.00007073,"fundingIntervalHours":8      },      {"calcTime":1782950400000,"calcTimeIso":"2026-07-02T00:00:00.000Z","lastFundingRate":0.00008001,"fundingIntervalHours":8      },      {"calcTime":1782979200000,"calcTimeIso":"2026-07-02T08:00:00.000Z","lastFundingRate":0.00005238,"fundingIntervalHours":8      },      {"calcTime":1783008000000,"calcTimeIso":"2026-07-02T16:00:00.000Z","lastFundingRate":0.00005261,"fundingIntervalHours":8      }    ],"month":"2026-07","market":"um","symbol":"BTCUSDT","dataset":"funding-rate",    "checksum": {"sha256":"e36fcc66f493d7d9ec348c852fc22e9f318c79cf7adae17398a3994ae0adc41e","verified":true    },"provider":"binance-vision","timestampUnit":"ms"  },"timestamp":"2026-08-20T14:52:19Z"}

Errors

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

Index Price Klines

Index-price candles — the spot composite Binance derives the mark price from.

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

passing · 0.4s1d cache

Parameters

Name	Type	In	Description
symbol	string	query	Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined). Required.
date	string	query	YYYY-MM-DD for a daily archive, YYYY-MM for a monthly one. Archives run to T-1. Required.
market	enum	query	um (USD-margined futures), cm (coin-margined futures). Default um. One of um, cm.
interval	enum	query	Candle interval; the monthly token is 1mo, not 1M. Default 5m. One of 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo.
page	number	query	Page of rows. Default 1.
limit	number	query	Rows per page. Default 5000, max 20000.

Example response

{"project":"finance:binance-vision",  "data": {"date":"2026-08-18","page":1,"count":288,    "items": [      {"low":64488.35434783,"high":64560.23043478,"open":64536.60173913,"close":64489.72130435,"volume":null,"openTime":1787011200000,"closeTime":1787011499999,"priceType":"index","tradeCount":300,"openTimeIso":"2026-08-18T00:00:00.000Z","quoteVolume":null,"closeTimeIso":"2026-08-18T00:04:59.999Z","takerBuyVolume":null,"takerBuyQuoteVolume":null      },      {"low":64427.3373913,"high":64489.86130435,"open":64489.72130435,"close":64430.56369565,"volume":null,"openTime":1787011500000,"closeTime":1787011799999,"priceType":"index","tradeCount":300,"openTimeIso":"2026-08-18T00:05:00.000Z","quoteVolume":null,"closeTimeIso":"2026-08-18T00:09:59.999Z","takerBuyVolume":null,"takerBuyQuoteVolume":null      }    ],"total":288,"market":"um","period":"daily","symbol":"BTCUSDT","dataset":"index-price-klines","hasMore":false,    "checksum": {"sha256":"4c259c59a3c30020f44be5410cd9787743e307c8434008c8d50f3f235b708ff1","verified":true    },"interval":"5m","nextPage":null,"provider":"binance-vision","priceType":"index","missingRows":0,"expectedRows":288,"timestampUnit":"ms"  },"timestamp":"2026-08-20T14:52:19Z"}

Errors

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

Intervals

Which candle intervals one symbol actually has, listed rather than assumed. Spot

GET/v1/finance:binance-vision/intervals

passing · 0.2s1d cache

Parameters

Name	Type	In	Description
symbol	string	query	Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined). Required.
series	enum	query	Kline series. Default klines. One of klines, mark-price-klines, index-price-klines, premium-index-klines.
market	enum	query	spot, um (USD-margined futures), cm (coin-margined futures). Default um. One of spot, um, cm.
period	enum	query	Archive cadence. Default daily. One of daily, monthly.

Example response

{"project":"finance:binance-vision",  "data": {"count":15,    "items": [      {"stepMs":60000,"interval":"1m"      },      {"stepMs":180000,"interval":"3m"      },      {"stepMs":300000,"interval":"5m"      },      {"stepMs":900000,"interval":"15m"      },      {"stepMs":1800000,"interval":"30m"      },      {"stepMs":3600000,"interval":"1h"      }    ],"market":"um","period":"daily","series":"klines","symbol":"BTCUSDT","dataset":"intervals","provider":"binance-vision"  },"timestamp":"2026-08-20T14:52:19Z"}

Errors

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

Klines

Traded OHLCV candles for one symbol and one archive file, from Binance's public

GET/v1/finance:binance-vision/klines

passing · 0.5s1d cache

Parameters

Name	Type	In	Description
symbol	string	query	Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined). Required.
date	string	query	YYYY-MM-DD for a daily archive, YYYY-MM for a monthly one. Archives run to T-1. Required.
market	enum	query	um (USD-margined futures), spot, cm (coin-margined futures). Default um. One of um, spot, cm.
interval	enum	query	Candle interval; the monthly token is 1mo, not 1M. Default 5m. One of 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo.
page	number	query	Page of rows. Default 1.
limit	number	query	Rows per page. Default 5000, max 20000.

Example response

{"project":"finance:binance-vision",  "data": {"date":"2026-08-18","page":1,"count":288,    "items": [      {"low":64449.8,"high":64541.6,"open":64504.1,"close":64454.1,"volume":542.045,"openTime":1787011200000,"closeTime":1787011499999,"priceType":"last","tradeCount":8311,"openTimeIso":"2026-08-18T00:00:00.000Z","quoteVolume":34960235.8617,"closeTimeIso":"2026-08-18T00:04:59.999Z","takerBuyVolume":253.468,"takerBuyQuoteVolume":16347166.0489      },      {"low":64386.6,"high":64454.1,"open":64454,"close":64397,"volume":476.964,"openTime":1787011500000,"closeTime":1787011799999,"priceType":"last","tradeCount":7508,"openTimeIso":"2026-08-18T00:05:00.000Z","quoteVolume":30720499.7668,"closeTimeIso":"2026-08-18T00:09:59.999Z","takerBuyVolume":156.896,"takerBuyQuoteVolume":10104513.5208      }    ],"total":288,"market":"um","period":"daily","symbol":"BTCUSDT","dataset":"klines","hasMore":false,    "checksum": {"sha256":"88af317df415c466291381545fdb1f767d9bd3cf510598e999bf2f446fe63790","verified":true    },"interval":"5m","nextPage":null,"provider":"binance-vision","priceType":"last","missingRows":0,"expectedRows":288,"timestampUnit":"ms"  },"timestamp":"2026-08-20T14:52:19Z"}

Errors

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

Liquidations

Forced-liquidation orders for one symbol and one UTC day. Discontinued, not

GET/v1/finance:binance-vision/liquidations

passing · 0.5s1d cache

Parameters

Name	Type	In	Description
symbol	string	query	Futures symbol; use BTCUSD_PERP style for coin-margined. Required.
date	string	query	UTC day, YYYY-MM-DD. UM ends 2024-03-31 and CM ends 2024-10-14; later dates have no archive. Required.
market	enum	query	um (USD-margined futures), cm (coin-margined futures). Default um. One of um, cm.
page	number	query	Page of rows. Default 1.
limit	number	query	Rows per page. Default 5000, max 20000.

Example response

{"project":"finance:binance-vision",  "data": {"date":"2024-03-31","page":1,"count":1544,    "items": [      {"side":"SELL","time":1711843207773,"price":69356.21,"timeIso":"2024-03-31T00:00:07.773Z","orderType":"LIMIT","orderStatus":"FILLED","timeInForce":"IOC","averagePrice":69627.6,"lastFillQuantity":0.002,"originalQuantity":0.002,"accumulatedFillQuantity":0.002      },      {"side":"SELL","time":1711843207773,"price":69356.21,"timeIso":"2024-03-31T00:00:07.773Z","orderType":"LIMIT","orderStatus":"FILLED","timeInForce":"IOC","averagePrice":69627.6,"lastFillQuantity":0.002,"originalQuantity":0.002,"accumulatedFillQuantity":0.002      },      {"side":"SELL","time":1711843214054,"price":69349.19,"timeIso":"2024-03-31T00:00:14.054Z","orderType":"LIMIT","orderStatus":"FILLED","timeInForce":"IOC","averagePrice":69627.6,"lastFillQuantity":0.002,"originalQuantity":0.002,"accumulatedFillQuantity":0.002      }    ],"total":1544,"market":"um","symbol":"BTCUSDT","dataset":"liquidations","hasMore":false,    "checksum": {"sha256":"d81de4e236f73ccbdb1173db3d8a9c2f316e41de22ac6e77e5c94a29ffbc4134","verified":true    },"nextPage":null,"provider":"binance-vision","timestampUnit":"ms"  },"timestamp":"2026-08-20T14:52:19Z"}

Errors

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

Mark Price Klines

Mark-price candles — the price Binance liquidates against, not the price anything

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

passing · 0.5s1d cache

Parameters

Name	Type	In	Description
symbol	string	query	Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined). Required.
date	string	query	YYYY-MM-DD for a daily archive, YYYY-MM for a monthly one. Archives run to T-1. Required.
market	enum	query	um (USD-margined futures), cm (coin-margined futures). Default um. One of um, cm.
interval	enum	query	Candle interval; the monthly token is 1mo, not 1M. Default 5m. One of 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo.
page	number	query	Page of rows. Default 1.
limit	number	query	Rows per page. Default 5000, max 20000.

Example response

{"project":"finance:binance-vision",  "data": {"date":"2026-08-18","page":1,"count":288,    "items": [      {"low":64450,"high":64541.5,"open":64504.1,"close":64454.1,"volume":null,"openTime":1787011200000,"closeTime":1787011499999,"priceType":"mark","tradeCount":300,"openTimeIso":"2026-08-18T00:00:00.000Z","quoteVolume":null,"closeTimeIso":"2026-08-18T00:04:59.999Z","takerBuyVolume":null,"takerBuyQuoteVolume":null      },      {"low":64389.28157246,"high":64454.23682159,"open":64454,"close":64397.1,"volume":null,"openTime":1787011500000,"closeTime":1787011799999,"priceType":"mark","tradeCount":300,"openTimeIso":"2026-08-18T00:05:00.000Z","quoteVolume":null,"closeTimeIso":"2026-08-18T00:09:59.999Z","takerBuyVolume":null,"takerBuyQuoteVolume":null      }    ],"total":288,"market":"um","period":"daily","symbol":"BTCUSDT","dataset":"mark-price-klines","hasMore":false,    "checksum": {"sha256":"8236e929819664224646efb3be726f756736613288652afbb6cdebe74ca6a428","verified":true    },"interval":"5m","nextPage":null,"provider":"binance-vision","priceType":"mark","missingRows":0,"expectedRows":288,"timestampUnit":"ms"  },"timestamp":"2026-08-20T14:52:19Z"}

Errors

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

Metrics

Five-minute open interest and long/short positioning for one futures symbol and

GET/v1/finance:binance-vision/metrics

passing · 0.5s1d cache

Parameters

Name	Type	In	Description
symbol	string	query	Futures symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined). Required.
date	string	query	UTC day, YYYY-MM-DD. BTCUSDT runs from 2020-09-01, ETHUSDT from 2021-12-01, and archives run to T-1. Required.
market	enum	query	um (USD-margined futures), cm (coin-margined futures). Default um. One of um, cm.

Example response

{"project":"finance:binance-vision",  "data": {"date":"2026-08-18","count":288,    "items": [      {"createTime":1787011200000,"createTimeIso":"2026-08-18T00:00:00.000Z","sumOpenInterest":106377.598,"countLongShortRatio":1.48542034,"sumOpenInterestValue":6856472339.2518,"sumTakerLongShortVolRatio":0.878425,"sumTopTraderLongShortRatio":1.484888,"countTopTraderLongShortRatio":1.53751556      },      {"createTime":1787011500000,"createTimeIso":"2026-08-18T00:05:00.000Z","sumOpenInterest":106325.86,"countLongShortRatio":1.48099622,"sumOpenInterestValue":6847077039.006,"sumTakerLongShortVolRatio":0.490069,"sumTopTraderLongShortRatio":1.480877,"countTopTraderLongShortRatio":1.53395809      },      {"createTime":1787011800000,"createTimeIso":"2026-08-18T00:10:00.000Z","sumOpenInterest":106356.292,"countLongShortRatio":1.47826865,"sumOpenInterestValue":6850823557.2588,"sumTakerLongShortVolRatio":1.125194,"sumTopTraderLongShortRatio":1.479356,"countTopTraderLongShortRatio":1.53063027      }    ],"market":"um","symbol":"BTCUSDT","dataset":"metrics",    "checksum": {"sha256":"1db58bdad3275ebd42f68aef01a69e344750fad2f7783926c6b193001c6a06a0","verified":true    },"complete":true,"interval":"5m","provider":"binance-vision","missingRows":0,"expectedRows":288,"timestampUnit":"ms"  },"timestamp":"2026-08-20T14:52:19Z"}

Errors

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

Premium Index Klines

Premium-index candles — the perpetual's basis over the index, which is what the

GET/v1/finance:binance-vision/premium-index-klines

passing · 0.6s1d cache

Parameters

Name	Type	In	Description
symbol	string	query	Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined). Required.
date	string	query	YYYY-MM-DD for a daily archive, YYYY-MM for a monthly one. Archives run to T-1. Required.
market	enum	query	um (USD-margined futures), cm (coin-margined futures). Default um. One of um, cm.
interval	enum	query	Candle interval; the monthly token is 1mo, not 1M. Default 5m. One of 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo.
page	number	query	Page of rows. Default 1.
limit	number	query	Rows per page. Default 5000, max 20000.

Example response

{"project":"finance:binance-vision",  "data": {"date":"2026-08-18","page":1,"count":288,    "items": [      {"low":-0.00074406,"high":-0.00032883,"open":-0.00039607,"close":-0.00059903,"volume":null,"openTime":1787011200000,"closeTime":1787011499999,"priceType":"premium","tradeCount":60,"openTimeIso":"2026-08-18T00:00:00.000Z","quoteVolume":null,"closeTimeIso":"2026-08-18T00:04:59.999Z","takerBuyVolume":null,"takerBuyQuoteVolume":null      },      {"low":-0.00067615,"high":-0.00042339,"open":-0.00055291,"close":-0.00051859,"volume":null,"openTime":1787011500000,"closeTime":1787011799999,"priceType":"premium","tradeCount":60,"openTimeIso":"2026-08-18T00:05:00.000Z","quoteVolume":null,"closeTimeIso":"2026-08-18T00:09:59.999Z","takerBuyVolume":null,"takerBuyQuoteVolume":null      }    ],"total":288,"market":"um","period":"daily","symbol":"BTCUSDT","dataset":"premium-index-klines","hasMore":false,    "checksum": {"sha256":"9bd98fa004a9c3fc119940bbc68b441c3d960143c6a4a6fb9243e21b96166d5f","verified":true    },"interval":"5m","nextPage":null,"provider":"binance-vision","priceType":"premium","missingRows":0,"expectedRows":288,"timestampUnit":"ms"  },"timestamp":"2026-08-20T14:52:19Z"}

Errors

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

Symbols

Every symbol that has an archive in one series, straight from the bucket index.

GET/v1/finance:binance-vision/symbols

passing · 0.6s6h cache

Parameters

Name	Type	In	Description
series	enum	query	Archive series. Default klines. One of klines, mark-price-klines, index-price-klines, premium-index-klines, metrics, funding-rate, book-depth, book-ticker, agg-trades, trades, liquidations.
market	enum	query	spot, um (USD-margined futures), cm (coin-margined futures). Default um. One of spot, um, cm.
period	enum	query	Archive cadence. metrics and book-depth are daily only, funding-rate monthly only. Default daily. One of daily, monthly.
query	string	query	Keep only symbols containing this text.
page	number	query	Page of symbols. Default 1.
limit	number	query	Symbols per page. Default 200, max 1000.

Example response

{"project":"finance:binance-vision",  "data": {"page":1,"count":36,    "items": [      "BTCBUSD",      "BTCBUSD_210129",      "BTCBUSD_210226",      "BTCDOMUSDT",      "BTCSTUSDT",      "BTCSTUSDTSETTLED"    ],"query":"BTC","total":36,"market":"um","period":"daily","series":"klines","dataset":"symbols","hasMore":false,"nextPage":null,"provider":"binance-vision"  },"timestamp":"2026-08-20T14:52:19Z"}

Errors

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

Trades

Individual trades, one row per fill. A BTCUSDT futures day is 1.6M rows and 12 MB

GET/v1/finance:binance-vision/trades

passing · 1.7s1d cache

Parameters

Name	Type	In	Description
symbol	string	query	Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined). Required.
date	string	query	YYYY-MM-DD for a daily archive, YYYY-MM for a monthly one. Futures run from 2019-12-31 and spot from 2017-08-17. Required.
market	enum	query	um (USD-margined futures), spot, cm (coin-margined futures). Default um. One of um, spot, cm.
page	number	query	Page of rows. Default 1.
limit	number	query	Rows per page. Default 10000, max 50000.

Example response

{"project":"finance:binance-vision",  "data": {"date":"2026-08-18","page":1,"count":10000,    "items": [      {"time":1787011200015,"price":64504.1,"timeIso":"2026-08-18T00:00:00.015Z","tradeId":7976144181,"quantity":0.024,"isBestMatch":null,"isBuyerMaker":true,"quoteQuantity":1548.0984      },      {"time":1787011200024,"price":64504.1,"timeIso":"2026-08-18T00:00:00.024Z","tradeId":7976144182,"quantity":0.001,"isBestMatch":null,"isBuyerMaker":true,"quoteQuantity":64.5041      },      {"time":1787011200048,"price":64504.1,"timeIso":"2026-08-18T00:00:00.048Z","tradeId":7976144183,"quantity":0.001,"isBestMatch":null,"isBuyerMaker":true,"quoteQuantity":64.5041      }    ],"total":1636466,"market":"um","period":"daily","symbol":"BTCUSDT","dataset":"trades","hasMore":true,    "checksum": {"sha256":"8063a3ba07b9af225122b14a1a8f71f7c657d891c38f0a38cf2d52d1fba47ea5","verified":true    },"nextPage":2,"provider":"binance-vision","timestampUnit":"ms"  },"timestamp":"2026-08-20T14:52:19Z"}

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-vision",  "agg-trades",  { symbol: "BTCUSDT", date: "2026-08-18", market: "um", page: 1, limit: 10000 });

Binance Vision

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

15 endpoints8.1k calls15/15 passing

Get API key

Aggregated trades — one row per run of same-side fills at one price. A BTCUSDT

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

passing · 1.8s1d cache

Try it

Parameters

symbol

string · query · required

Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).

date

string · query · required

YYYY-MM-DD for a daily archive, YYYY-MM for a monthly one. Futures run from 2019-12-31 and spot from 2017-08-17.

market

enum · query · optional

um (USD-margined futures), spot, cm (coin-margined futures). Default um.

page

number · query · optional

Page of rows. Default 1.

limit

number · query · optional

Rows per page. Default 10000, max 50000.

Example response

{"project":"finance:binance-vision",  "data": {"date":"2026-08-18","page":1,"count":10000,    "items": [      {"price":64504.1,"quantity":0.026,"aggTradeId":3409890025,"isBestMatch":null,"lastTradeId":7976144183,"firstTradeId":7976144181,"isBuyerMaker":true,"transactTime":1787011200015,"transactTimeIso":"2026-08-18T00:00:00.015Z"      },      {"price":64504.2,"quantity":0.078,"aggTradeId":3409890026,"isBestMatch":null,"lastTradeId":7976144187,"firstTradeId":7976144184,"isBuyerMaker":false,"transactTime":1787011200092,"transactTimeIso":"2026-08-18T00:00:00.092Z"      },      {"price":64504.2,"quantity":1.713,"aggTradeId":3409890027,"isBestMatch":null,"lastTradeId":7976144201,"firstTradeId":7976144188,"isBuyerMaker":false,"transactTime":1787011200206,"transactTimeIso":"2026-08-18T00:00:00.206Z"      }    ],"total":545233,"market":"um","period":"daily","symbol":"BTCUSDT","dataset":"agg-trades","hasMore":true,    "checksum": {"sha256":"0c1e12cf9577020702f824146734914271937f7b3c332ef13f5b7e44df246258","verified":true    },"nextPage":2,"provider":"binance-vision","timestampUnit":"ms"  },"timestamp":"2026-08-20T14:52:19Z"}

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-vision",  "agg-trades",  { symbol: "BTCUSDT", date: "2026-08-18", market: "um", page: 1, limit: 10000 });