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 Vision

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

Endpoints: 15
Requests: 4.7k
Updated: 6 hours ago
For LLMs: llms.txt

Endpoint health3 hours ago

agg-tradespassing, 1.2s
book-depthpassing, 1.0s
checksumpassing, 0.3s
datasetspassing, 2.1s
datespassing, 0.3s

+ 10 more endpoints

15/15 passingdaily 01:00 WIB

Playground

15 endpoints

GET/v1/finance:binance-vision/agg-trades1d cache5 paramschecking key…

Parameters

Response

EXAMPLE

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

Code examples

Agg Trades

zpi-sdkrecommended

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

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

const data = await client.run("finance:binance-vision", "agg-trades", {
  "symbol": "BTCUSDT",
  "date": "2026-08-18",
  "market": "um",
  "page": 1,
  "limit": 10000
});
console.log(data);

Full SDK reference →

cURL

request.sh

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/agg-trades?symbol=BTCUSDT&date=2026-08-18&market=um&page=1&limit=10000" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Full reference

15 endpoints · plain text

GETAgg Trades/v1/finance:binance-vision/agg-tradesAggregated trades — one row per run of same-side fills at one price. A BTCUSDT

Parameters

symbolstringrequired: Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: 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.
marketenumoptional: um (USD-margined futures), spot, cm (coin-margined futures). Default um. Values: um, spot, cm.
pagenumberoptional: Page of rows. Default 1.
limitnumberoptional: Rows per page. Default 10000, max 50000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/agg-trades?symbol=BTCUSDT&date=2026-08-18&market=um&page=1&limit=10000" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETBook Depth/v1/finance:binance-vision/book-depthOrder-book depth sampled every 30 seconds across twelve price bands, one UTC day

Parameters

symbolstringrequired: Futures symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: 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.
marketenumoptional: um (USD-margined futures), cm (coin-margined futures). Default um. Values: um, cm.
percentagenumberoptional: Keep one band only. Bands present: -5, -4, -3, -2, -1, -0.2, 0.2, 1, 2, 3, 4, 5.
pagenumberoptional: Page of rows. Default 1.
limitnumberoptional: Rows per page. Default 2880, max 10000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/book-depth?symbol=BTCUSDT&date=2026-08-18&market=um&percentage=0.2&page=1&limit=2880" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETChecksum/v1/finance:binance-vision/checksumDownloads one archive and checks it against the SHA-256 Binance publishes beside

Parameters

symbolstringrequired: Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: YYYY-MM-DD for a daily archive, YYYY-MM for a monthly one.
seriesenumoptional: Archive series. Default klines. Values: klines, mark-price-klines, index-price-klines, premium-index-klines, metrics, funding-rate, book-depth, book-ticker, agg-trades, trades, liquidations.
marketenumoptional: spot, um (USD-margined futures), cm (coin-margined futures). Default um. Values: spot, um, cm.
intervalenumoptional: Candle interval, for kline series only; the monthly token is 1mo, not 1M. Default 5m. Values: 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/checksum?symbol=BTCUSDT&date=2026-08-18&series=klines&market=um&interval=5m" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETDatasets/v1/finance:binance-vision/datasetsWhich series a market publishes at a given cadence. The asymmetries are real:

Parameters

marketenumoptional: spot, um (USD-margined futures), cm (coin-margined futures). Default um. Values: spot, um, cm.
periodenumoptional: Archive cadence. Default daily. Values: daily, monthly.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/datasets?market=um&period=daily" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETDates/v1/finance:binance-vision/datesWhich days or months actually exist for one symbol and series — the backfill

Parameters

symbolstringrequired: Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
seriesenumoptional: Archive series. Default klines. Values: klines, mark-price-klines, index-price-klines, premium-index-klines, metrics, funding-rate, book-depth, book-ticker, agg-trades, trades, liquidations.
marketenumoptional: spot, um (USD-margined futures), cm (coin-margined futures). Default um. Values: spot, um, cm.
periodenumoptional: Archive cadence. Default daily. Values: daily, monthly.
intervalenumoptional: Candle interval, for kline series only; the monthly token is 1mo, not 1M. Default 5m. Values: 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo.
fromstringoptional: Start at this date, YYYY-MM-DD or YYYY-MM. Skips straight there in the index.
tostringoptional: Stop after this date, YYYY-MM-DD or YYYY-MM.
pagenumberoptional: Page of dates. Default 1.
limitnumberoptional: Dates per page. Default 200, max 1000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/dates?symbol=BTCUSDT&series=klines&market=um&period=daily&interval=5m&from=2026-08-01&to=2026-08-19&page=1&limit=200" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETFunding Rate/v1/finance:binance-vision/funding-rateRealised funding for one perpetual, one calendar month per archive.

Parameters

symbolstringrequired: Perpetual symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: Calendar month, YYYY-MM. Published monthly only, from 2020-01, and the current month appears once it closes.
marketenumoptional: um (USD-margined futures), cm (coin-margined futures). Default um. Values: um, cm.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/funding-rate?symbol=BTCUSDT&date=2026-07&market=um" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETIndex Price Klines/v1/finance:binance-vision/index-price-klinesIndex-price candles — the spot composite Binance derives the mark price from.

Parameters

symbolstringrequired: Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: YYYY-MM-DD for a daily archive, YYYY-MM for a monthly one. Archives run to T-1.
marketenumoptional: um (USD-margined futures), cm (coin-margined futures). Default um. Values: um, cm.
intervalenumoptional: Candle interval; the monthly token is 1mo, not 1M. Default 5m. Values: 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo.
pagenumberoptional: Page of rows. Default 1.
limitnumberoptional: Rows per page. Default 5000, max 20000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/index-price-klines?symbol=BTCUSDT&date=2026-08-18&market=um&interval=5m&page=1&limit=5000" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETIntervals/v1/finance:binance-vision/intervalsWhich candle intervals one symbol actually has, listed rather than assumed. Spot

Parameters

symbolstringrequired: Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
seriesenumoptional: Kline series. Default klines. Values: klines, mark-price-klines, index-price-klines, premium-index-klines.
marketenumoptional: spot, um (USD-margined futures), cm (coin-margined futures). Default um. Values: spot, um, cm.
periodenumoptional: Archive cadence. Default daily. Values: daily, monthly.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/intervals?symbol=BTCUSDT&series=klines&market=um&period=daily" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETKlines/v1/finance:binance-vision/klinesTraded OHLCV candles for one symbol and one archive file, from Binance's public

Parameters

symbolstringrequired: Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: YYYY-MM-DD for a daily archive, YYYY-MM for a monthly one. Archives run to T-1.
marketenumoptional: um (USD-margined futures), spot, cm (coin-margined futures). Default um. Values: um, spot, cm.
intervalenumoptional: Candle interval; the monthly token is 1mo, not 1M. Default 5m. Values: 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo.
pagenumberoptional: Page of rows. Default 1.
limitnumberoptional: Rows per page. Default 5000, max 20000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/klines?symbol=BTCUSDT&date=2026-08-18&market=um&interval=5m&page=1&limit=5000" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETLiquidations/v1/finance:binance-vision/liquidationsForced-liquidation orders for one symbol and one UTC day. Discontinued, not

Parameters

symbolstringrequired: Futures symbol; use BTCUSD_PERP style for coin-margined.
datestringrequired: UTC day, YYYY-MM-DD. UM ends 2024-03-31 and CM ends 2024-10-14; later dates have no archive.
marketenumoptional: um (USD-margined futures), cm (coin-margined futures). Default um. Values: um, cm.
pagenumberoptional: Page of rows. Default 1.
limitnumberoptional: Rows per page. Default 5000, max 20000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/liquidations?symbol=BTCUSDT&date=2024-03-31&market=um&page=1&limit=5000" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETMark Price Klines/v1/finance:binance-vision/mark-price-klinesMark-price candles — the price Binance liquidates against, not the price anything

Parameters

symbolstringrequired: Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: YYYY-MM-DD for a daily archive, YYYY-MM for a monthly one. Archives run to T-1.
marketenumoptional: um (USD-margined futures), cm (coin-margined futures). Default um. Values: um, cm.
intervalenumoptional: Candle interval; the monthly token is 1mo, not 1M. Default 5m. Values: 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo.
pagenumberoptional: Page of rows. Default 1.
limitnumberoptional: Rows per page. Default 5000, max 20000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/mark-price-klines?symbol=BTCUSDT&date=2026-08-18&market=um&interval=5m&page=1&limit=5000" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETMetrics/v1/finance:binance-vision/metricsFive-minute open interest and long/short positioning for one futures symbol and

Parameters

symbolstringrequired: Futures symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: UTC day, YYYY-MM-DD. BTCUSDT runs from 2020-09-01, ETHUSDT from 2021-12-01, and archives run to T-1.
marketenumoptional: um (USD-margined futures), cm (coin-margined futures). Default um. Values: um, cm.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/metrics?symbol=BTCUSDT&date=2026-08-18&market=um" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETPremium Index Klines/v1/finance:binance-vision/premium-index-klinesPremium-index candles — the perpetual's basis over the index, which is what the

Parameters

symbolstringrequired: Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: YYYY-MM-DD for a daily archive, YYYY-MM for a monthly one. Archives run to T-1.
marketenumoptional: um (USD-margined futures), cm (coin-margined futures). Default um. Values: um, cm.
intervalenumoptional: Candle interval; the monthly token is 1mo, not 1M. Default 5m. Values: 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo.
pagenumberoptional: Page of rows. Default 1.
limitnumberoptional: Rows per page. Default 5000, max 20000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/premium-index-klines?symbol=BTCUSDT&date=2026-08-18&market=um&interval=5m&page=1&limit=5000" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETSymbols/v1/finance:binance-vision/symbolsEvery symbol that has an archive in one series, straight from the bucket index.

Parameters

seriesenumoptional: Archive series. Default klines. Values: klines, mark-price-klines, index-price-klines, premium-index-klines, metrics, funding-rate, book-depth, book-ticker, agg-trades, trades, liquidations.
marketenumoptional: spot, um (USD-margined futures), cm (coin-margined futures). Default um. Values: spot, um, cm.
periodenumoptional: Archive cadence. metrics and book-depth are daily only, funding-rate monthly only. Default daily. Values: daily, monthly.
querystringoptional: Keep only symbols containing this text.
pagenumberoptional: Page of symbols. Default 1.
limitnumberoptional: Symbols per page. Default 200, max 1000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/symbols?series=klines&market=um&period=daily&query=BTC&page=1&limit=200" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETTrades/v1/finance:binance-vision/tradesIndividual trades, one row per fill. A BTCUSDT futures day is 1.6M rows and 12 MB

Parameters

symbolstringrequired: Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: 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.
marketenumoptional: um (USD-margined futures), spot, cm (coin-margined futures). Default um. Values: um, spot, cm.
pagenumberoptional: Page of rows. Default 1.
limitnumberoptional: Rows per page. Default 10000, max 50000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/trades?symbol=BTCUSDT&date=2026-08-18&market=um&page=1&limit=10000" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

Binance Vision

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

Endpoints: 15
Requests: 4.7k
Updated: 6 hours ago
For LLMs: llms.txt

Endpoint health3 hours ago

agg-tradespassing, 1.2s
book-depthpassing, 1.0s
checksumpassing, 0.3s
datasetspassing, 2.1s
datespassing, 0.3s

+ 10 more endpoints

15/15 passingdaily 01:00 WIB

Playground

15 endpoints

GET/v1/finance:binance-vision/agg-trades1d cache5 paramschecking key…

Parameters

Response

EXAMPLE

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

Code examples

Agg Trades

zpi-sdkrecommended

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

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

const data = await client.run("finance:binance-vision", "agg-trades", {
  "symbol": "BTCUSDT",
  "date": "2026-08-18",
  "market": "um",
  "page": 1,
  "limit": 10000
});
console.log(data);

Full SDK reference →

cURL

request.sh

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/agg-trades?symbol=BTCUSDT&date=2026-08-18&market=um&page=1&limit=10000" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Full reference

15 endpoints · plain text

GETAgg Trades/v1/finance:binance-vision/agg-tradesAggregated trades — one row per run of same-side fills at one price. A BTCUSDT

Parameters

symbolstringrequired: Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: 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.
marketenumoptional: um (USD-margined futures), spot, cm (coin-margined futures). Default um. Values: um, spot, cm.
pagenumberoptional: Page of rows. Default 1.
limitnumberoptional: Rows per page. Default 10000, max 50000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/agg-trades?symbol=BTCUSDT&date=2026-08-18&market=um&page=1&limit=10000" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETBook Depth/v1/finance:binance-vision/book-depthOrder-book depth sampled every 30 seconds across twelve price bands, one UTC day

Parameters

symbolstringrequired: Futures symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: 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.
marketenumoptional: um (USD-margined futures), cm (coin-margined futures). Default um. Values: um, cm.
percentagenumberoptional: Keep one band only. Bands present: -5, -4, -3, -2, -1, -0.2, 0.2, 1, 2, 3, 4, 5.
pagenumberoptional: Page of rows. Default 1.
limitnumberoptional: Rows per page. Default 2880, max 10000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/book-depth?symbol=BTCUSDT&date=2026-08-18&market=um&percentage=0.2&page=1&limit=2880" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETChecksum/v1/finance:binance-vision/checksumDownloads one archive and checks it against the SHA-256 Binance publishes beside

Parameters

symbolstringrequired: Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: YYYY-MM-DD for a daily archive, YYYY-MM for a monthly one.
seriesenumoptional: Archive series. Default klines. Values: klines, mark-price-klines, index-price-klines, premium-index-klines, metrics, funding-rate, book-depth, book-ticker, agg-trades, trades, liquidations.
marketenumoptional: spot, um (USD-margined futures), cm (coin-margined futures). Default um. Values: spot, um, cm.
intervalenumoptional: Candle interval, for kline series only; the monthly token is 1mo, not 1M. Default 5m. Values: 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/checksum?symbol=BTCUSDT&date=2026-08-18&series=klines&market=um&interval=5m" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETDatasets/v1/finance:binance-vision/datasetsWhich series a market publishes at a given cadence. The asymmetries are real:

Parameters

marketenumoptional: spot, um (USD-margined futures), cm (coin-margined futures). Default um. Values: spot, um, cm.
periodenumoptional: Archive cadence. Default daily. Values: daily, monthly.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/datasets?market=um&period=daily" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETDates/v1/finance:binance-vision/datesWhich days or months actually exist for one symbol and series — the backfill

Parameters

symbolstringrequired: Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
seriesenumoptional: Archive series. Default klines. Values: klines, mark-price-klines, index-price-klines, premium-index-klines, metrics, funding-rate, book-depth, book-ticker, agg-trades, trades, liquidations.
marketenumoptional: spot, um (USD-margined futures), cm (coin-margined futures). Default um. Values: spot, um, cm.
periodenumoptional: Archive cadence. Default daily. Values: daily, monthly.
intervalenumoptional: Candle interval, for kline series only; the monthly token is 1mo, not 1M. Default 5m. Values: 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo.
fromstringoptional: Start at this date, YYYY-MM-DD or YYYY-MM. Skips straight there in the index.
tostringoptional: Stop after this date, YYYY-MM-DD or YYYY-MM.
pagenumberoptional: Page of dates. Default 1.
limitnumberoptional: Dates per page. Default 200, max 1000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/dates?symbol=BTCUSDT&series=klines&market=um&period=daily&interval=5m&from=2026-08-01&to=2026-08-19&page=1&limit=200" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETFunding Rate/v1/finance:binance-vision/funding-rateRealised funding for one perpetual, one calendar month per archive.

Parameters

symbolstringrequired: Perpetual symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: Calendar month, YYYY-MM. Published monthly only, from 2020-01, and the current month appears once it closes.
marketenumoptional: um (USD-margined futures), cm (coin-margined futures). Default um. Values: um, cm.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/funding-rate?symbol=BTCUSDT&date=2026-07&market=um" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETIndex Price Klines/v1/finance:binance-vision/index-price-klinesIndex-price candles — the spot composite Binance derives the mark price from.

Parameters

symbolstringrequired: Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: YYYY-MM-DD for a daily archive, YYYY-MM for a monthly one. Archives run to T-1.
marketenumoptional: um (USD-margined futures), cm (coin-margined futures). Default um. Values: um, cm.
intervalenumoptional: Candle interval; the monthly token is 1mo, not 1M. Default 5m. Values: 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo.
pagenumberoptional: Page of rows. Default 1.
limitnumberoptional: Rows per page. Default 5000, max 20000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/index-price-klines?symbol=BTCUSDT&date=2026-08-18&market=um&interval=5m&page=1&limit=5000" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETIntervals/v1/finance:binance-vision/intervalsWhich candle intervals one symbol actually has, listed rather than assumed. Spot

Parameters

symbolstringrequired: Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
seriesenumoptional: Kline series. Default klines. Values: klines, mark-price-klines, index-price-klines, premium-index-klines.
marketenumoptional: spot, um (USD-margined futures), cm (coin-margined futures). Default um. Values: spot, um, cm.
periodenumoptional: Archive cadence. Default daily. Values: daily, monthly.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/intervals?symbol=BTCUSDT&series=klines&market=um&period=daily" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETKlines/v1/finance:binance-vision/klinesTraded OHLCV candles for one symbol and one archive file, from Binance's public

Parameters

symbolstringrequired: Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: YYYY-MM-DD for a daily archive, YYYY-MM for a monthly one. Archives run to T-1.
marketenumoptional: um (USD-margined futures), spot, cm (coin-margined futures). Default um. Values: um, spot, cm.
intervalenumoptional: Candle interval; the monthly token is 1mo, not 1M. Default 5m. Values: 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo.
pagenumberoptional: Page of rows. Default 1.
limitnumberoptional: Rows per page. Default 5000, max 20000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/klines?symbol=BTCUSDT&date=2026-08-18&market=um&interval=5m&page=1&limit=5000" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETLiquidations/v1/finance:binance-vision/liquidationsForced-liquidation orders for one symbol and one UTC day. Discontinued, not

Parameters

symbolstringrequired: Futures symbol; use BTCUSD_PERP style for coin-margined.
datestringrequired: UTC day, YYYY-MM-DD. UM ends 2024-03-31 and CM ends 2024-10-14; later dates have no archive.
marketenumoptional: um (USD-margined futures), cm (coin-margined futures). Default um. Values: um, cm.
pagenumberoptional: Page of rows. Default 1.
limitnumberoptional: Rows per page. Default 5000, max 20000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/liquidations?symbol=BTCUSDT&date=2024-03-31&market=um&page=1&limit=5000" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETMark Price Klines/v1/finance:binance-vision/mark-price-klinesMark-price candles — the price Binance liquidates against, not the price anything

Parameters

symbolstringrequired: Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: YYYY-MM-DD for a daily archive, YYYY-MM for a monthly one. Archives run to T-1.
marketenumoptional: um (USD-margined futures), cm (coin-margined futures). Default um. Values: um, cm.
intervalenumoptional: Candle interval; the monthly token is 1mo, not 1M. Default 5m. Values: 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo.
pagenumberoptional: Page of rows. Default 1.
limitnumberoptional: Rows per page. Default 5000, max 20000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/mark-price-klines?symbol=BTCUSDT&date=2026-08-18&market=um&interval=5m&page=1&limit=5000" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETMetrics/v1/finance:binance-vision/metricsFive-minute open interest and long/short positioning for one futures symbol and

Parameters

symbolstringrequired: Futures symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: UTC day, YYYY-MM-DD. BTCUSDT runs from 2020-09-01, ETHUSDT from 2021-12-01, and archives run to T-1.
marketenumoptional: um (USD-margined futures), cm (coin-margined futures). Default um. Values: um, cm.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/metrics?symbol=BTCUSDT&date=2026-08-18&market=um" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETPremium Index Klines/v1/finance:binance-vision/premium-index-klinesPremium-index candles — the perpetual's basis over the index, which is what the

Parameters

symbolstringrequired: Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: YYYY-MM-DD for a daily archive, YYYY-MM for a monthly one. Archives run to T-1.
marketenumoptional: um (USD-margined futures), cm (coin-margined futures). Default um. Values: um, cm.
intervalenumoptional: Candle interval; the monthly token is 1mo, not 1M. Default 5m. Values: 1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1mo.
pagenumberoptional: Page of rows. Default 1.
limitnumberoptional: Rows per page. Default 5000, max 20000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/premium-index-klines?symbol=BTCUSDT&date=2026-08-18&market=um&interval=5m&page=1&limit=5000" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETSymbols/v1/finance:binance-vision/symbolsEvery symbol that has an archive in one series, straight from the bucket index.

Parameters

seriesenumoptional: Archive series. Default klines. Values: klines, mark-price-klines, index-price-klines, premium-index-klines, metrics, funding-rate, book-depth, book-ticker, agg-trades, trades, liquidations.
marketenumoptional: spot, um (USD-margined futures), cm (coin-margined futures). Default um. Values: spot, um, cm.
periodenumoptional: Archive cadence. metrics and book-depth are daily only, funding-rate monthly only. Default daily. Values: daily, monthly.
querystringoptional: Keep only symbols containing this text.
pagenumberoptional: Page of symbols. Default 1.
limitnumberoptional: Symbols per page. Default 200, max 1000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/symbols?series=klines&market=um&period=daily&query=BTC&page=1&limit=200" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

GETTrades/v1/finance:binance-vision/tradesIndividual trades, one row per fill. A BTCUSDT futures day is 1.6M rows and 12 MB

Parameters

symbolstringrequired: Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined).
datestringrequired: 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.
marketenumoptional: um (USD-margined futures), spot, cm (coin-margined futures). Default um. Values: um, spot, cm.
pagenumberoptional: Page of rows. Default 1.
limitnumberoptional: Rows per page. Default 10000, max 50000.

Request

curl -X GET "https://api.zpi.web.id/v1/finance:binance-vision/trades?symbol=BTCUSDT&date=2026-08-18&market=um&page=1&limit=10000" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

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

Playground

Code examples

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

Related APIs

Pluang

TradingView

Stockbit

Yahoo Finance

IDX (Bursa Efek Indonesia)

Binance Futures

Playground

Code examples

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