# Binance Vision — Zapi reference

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

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ content, message, errors }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/finance/binance-vision
- Endpoint catalog: https://zpi.web.id/category/finance
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## Binance Vision

**Category:** finance · **Slug:** `binance-vision`
**Detail page:** https://zpi.web.id/api/finance/binance-vision

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

**Tags:** binance, crypto, klines, futures, archive, ohlcv

### Agg Trades

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

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:binance-vision/agg-trades`
- **Cache TTL:** 86400s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `symbol` | string | query | yes | Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined). |
| `date` | string | query | yes | 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(um|spot|cm) | query | no | um (USD-margined futures), spot, cm (coin-margined futures). Default um. |
| `page` | number | query | no | Page of rows. Default 1. |
| `limit` | number | query | no | Rows per page. Default 10000, max 50000. |

**cURL:**
```bash
curl "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: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:binance-vision/agg-trades?symbol=BTCUSDT&date=2026-08-18&market=um&page=1&limit=10000", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:binance-vision/agg-trades?symbol=BTCUSDT&date=2026-08-18&market=um&page=1&limit=10000",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "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"
    },
    {
      "price": 64504.1,
      "quantity": 0.007,
      "aggTradeId": 3409890028,
      "isBestMatch": null,
      "lastTradeId": 7976144202,
      "firstTradeId": 7976144202,
      "isBuyerMaker": true,
      "transactTime": 1787011200247,
      "transactTimeIso": "2026-08-18T00:00:00.247Z"
    },
    {
      "price": 64504.2,
      "quantity": 0.946,
      "aggTradeId": 3409890029,
      "isBestMatch": null,
      "lastTradeId": 7976144208,
      "firstTradeId": 7976144203,
      "isBuyerMaker": false,
      "transactTime": 1787011200326,
      "transactTimeIso": "2026-08-18T00:00:00.326Z"
    },
    {
      "price": 64504.1,
      "quantity": 0.012,
      "aggTradeId": 3409890030,
      "isBestMatch": null,
      "lastTradeId": 7976144209,
      "firstTradeId": 7976144209,
      "isBuyerMaker": true,
      "transactTime": 1787011200347,
      "transactTimeIso": "2026-08-18T00:00:00.347Z"
    }
  ],
  "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"
}
```

---

### Book Depth

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

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:binance-vision/book-depth`
- **Cache TTL:** 86400s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `symbol` | string | query | yes | Futures symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined). |
| `date` | string | query | yes | 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. |
| `market` | enum(um|cm) | query | no | um (USD-margined futures), cm (coin-margined futures). Default um. |
| `percentage` | number | query | no | Keep one band only. Bands present: -5, -4, -3, -2, -1, -0.2, 0.2, 1, 2, 3, 4, 5. |
| `page` | number | query | no | Page of rows. Default 1. |
| `limit` | number | query | no | Rows per page. Default 2880, max 10000. |

**cURL:**
```bash
curl "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: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("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", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.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",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "date": "2026-08-18",
  "page": 1,
  "bands": [
    -5,
    -4,
    -3,
    -2,
    -1,
    -0.2
  ],
  "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"
    },
    {
      "depth": 858.266,
      "notional": 55434515.4216,
      "timestamp": 1787011292000,
      "percentage": 0.2,
      "timestampIso": "2026-08-18T00:01:32.000Z"
    },
    {
      "depth": 812.305,
      "notional": 52445707.1897,
      "timestamp": 1787011323000,
      "percentage": 0.2,
      "timestampIso": "2026-08-18T00:02:03.000Z"
    },
    {
      "depth": 816.231,
      "notional": 52695391.7949,
      "timestamp": 1787011352000,
      "percentage": 0.2,
      "timestampIso": "2026-08-18T00:02:32.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
}
```

---

### Checksum

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

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:binance-vision/checksum`
- **Cache TTL:** 86400s

**Parameters:**

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

**cURL:**
```bash
curl "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: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:binance-vision/checksum?symbol=BTCUSDT&date=2026-08-18&series=klines&market=um&interval=5m", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:binance-vision/checksum?symbol=BTCUSDT&date=2026-08-18&series=klines&market=um&interval=5m",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "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"
}
```

---

### Datasets

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

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:binance-vision/datasets`
- **Cache TTL:** 86400s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `market` | enum(spot|um|cm) | query | no | spot, um (USD-margined futures), cm (coin-margined futures). Default um. |
| `period` | enum(daily|monthly) | query | no | Archive cadence. Default daily. |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:binance-vision/datasets?market=um&period=daily" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:binance-vision/datasets?market=um&period=daily", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:binance-vision/datasets?market=um&period=daily",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "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"
}
```

---

### Dates

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

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:binance-vision/dates`
- **Cache TTL:** 3600s

**Parameters:**

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

**cURL:**
```bash
curl "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: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("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", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.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",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "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"
    },
    {
      "url": "https://data.binance.vision/data/futures/um/daily/klines/BTCUSDT/5m/BTCUSDT-5m-2026-08-04.zip",
      "date": "2026-08-04",
      "bytes": 13570,
      "checksumUrl": "https://data.binance.vision/data/futures/um/daily/klines/BTCUSDT/5m/BTCUSDT-5m-2026-08-04.zip.CHECKSUM",
      "lastModified": "2026-08-05T09:50:43.000Z"
    },
    {
      "url": "https://data.binance.vision/data/futures/um/daily/klines/BTCUSDT/5m/BTCUSDT-5m-2026-08-05.zip",
      "date": "2026-08-05",
      "bytes": 13554,
      "checksumUrl": "https://data.binance.vision/data/futures/um/daily/klines/BTCUSDT/5m/BTCUSDT-5m-2026-08-05.zip.CHECKSUM",
      "lastModified": "2026-08-06T09:45:15.000Z"
    },
    {
      "url": "https://data.binance.vision/data/futures/um/daily/klines/BTCUSDT/5m/BTCUSDT-5m-2026-08-06.zip",
      "date": "2026-08-06",
      "bytes": 13421,
      "checksumUrl": "https://data.binance.vision/data/futures/um/daily/klines/BTCUSDT/5m/BTCUSDT-5m-2026-08-06.zip.CHECKSUM",
      "lastModified": "2026-08-07T09:32:25.000Z"
    }
  ],
  "market": "um",
  "period": "daily",
  "series": "klines",
  "symbol": "BTCUSDT",
  "dataset": "dates",
  "hasMore": false,
  "interval": "5m",
  "nextPage": null,
  "provider": "binance-vision"
}
```

---

### Funding Rate

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

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:binance-vision/funding-rate`
- **Cache TTL:** 86400s

**Parameters:**

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

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:binance-vision/funding-rate?symbol=BTCUSDT&date=2026-07&market=um" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:binance-vision/funding-rate?symbol=BTCUSDT&date=2026-07&market=um", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:binance-vision/funding-rate?symbol=BTCUSDT&date=2026-07&market=um",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "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"
}
```

---

### Index Price Klines

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

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:binance-vision/index-price-klines`
- **Cache TTL:** 86400s

**Parameters:**

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

**cURL:**
```bash
curl "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: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("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", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.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",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "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
    },
    {
      "low": 64425.83021739,
      "high": 64437.47304348,
      "open": 64430.57173913,
      "close": 64437.46152174,
      "volume": null,
      "openTime": 1787011800000,
      "closeTime": 1787012099999,
      "priceType": "index",
      "tradeCount": 300,
      "openTimeIso": "2026-08-18T00:10:00.000Z",
      "quoteVolume": null,
      "closeTimeIso": "2026-08-18T00:14:59.999Z",
      "takerBuyVolume": null,
      "takerBuyQuoteVolume": null
    },
    {
      "low": 64437.46586957,
      "high": 64480.87152174,
      "open": 64437.46586957,
      "close": 64459.80934783,
      "volume": null,
      "openTime": 1787012100000,
      "closeTime": 1787012399999,
      "priceType": "index",
      "tradeCount": 300,
      "openTimeIso": "2026-08-18T00:15:00.000Z",
      "quoteVolume": null,
      "closeTimeIso": "2026-08-18T00:19:59.999Z",
      "takerBuyVolume": null,
      "takerBuyQuoteVolume": null
    },
    {
      "low": 64447.88978261,
      "high": 64495.93543478,
      "open": 64459.66586957,
      "close": 64478.06413043,
      "volume": null,
      "openTime": 1787012400000,
      "closeTime": 1787012699999,
      "priceType": "index",
      "tradeCount": 300,
      "openTimeIso": "2026-08-18T00:20:00.000Z",
      "quoteVolume": null,
      "closeTimeIso": "2026-08-18T00:24:59.999Z",
      "takerBuyVolume": null,
      "takerBuyQuoteVolume": null
    },
    {
      "low": 64454.59695652,
      "high": 64480.54869565,
      "open": 64478.06413043,
      "close": 64459.61826087,
      "volume": null,
      "openTime": 1787012700000,
      "closeTime": 1787012999999,
      "priceType": "index",
      "tradeCount": 300,
      "openTimeIso": "2026-08-18T00:25:00.000Z",
      "quoteVolume": null,
      "closeTimeIso": "2026-08-18T00:29: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"
}
```

---

### Intervals

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

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:binance-vision/intervals`
- **Cache TTL:** 86400s

**Parameters:**

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

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:binance-vision/intervals?symbol=BTCUSDT&series=klines&market=um&period=daily" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:binance-vision/intervals?symbol=BTCUSDT&series=klines&market=um&period=daily", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:binance-vision/intervals?symbol=BTCUSDT&series=klines&market=um&period=daily",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "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"
}
```

---

### Klines

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

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:binance-vision/klines`
- **Cache TTL:** 86400s

**Parameters:**

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

**cURL:**
```bash
curl "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: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:binance-vision/klines?symbol=BTCUSDT&date=2026-08-18&market=um&interval=5m&page=1&limit=5000", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.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",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "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
    },
    {
      "low": 64388.7,
      "high": 64414,
      "open": 64397,
      "close": 64413.9,
      "volume": 196.179,
      "openTime": 1787011800000,
      "closeTime": 1787012099999,
      "priceType": "last",
      "tradeCount": 4177,
      "openTimeIso": "2026-08-18T00:10:00.000Z",
      "quoteVolume": 12633572.5295,
      "closeTimeIso": "2026-08-18T00:14:59.999Z",
      "takerBuyVolume": 103.86,
      "takerBuyQuoteVolume": 6688494.3022
    },
    {
      "low": 64413.9,
      "high": 64466.4,
      "open": 64414,
      "close": 64433,
      "volume": 220.722,
      "openTime": 1787012100000,
      "closeTime": 1787012399999,
      "priceType": "last",
      "tradeCount": 5253,
      "openTimeIso": "2026-08-18T00:15:00.000Z",
      "quoteVolume": 14222871.9751,
      "closeTimeIso": "2026-08-18T00:19:59.999Z",
      "takerBuyVolume": 135.729,
      "takerBuyQuoteVolume": 8746034.2627
    },
    {
      "low": 64417.5,
      "high": 64476.8,
      "open": 64433,
      "close": 64448,
      "volume": 233.614,
      "openTime": 1787012400000,
      "closeTime": 1787012699999,
      "priceType": "last",
      "tradeCount": 5872,
      "openTimeIso": "2026-08-18T00:20:00.000Z",
      "quoteVolume": 15056134.4154,
      "closeTimeIso": "2026-08-18T00:24:59.999Z",
      "takerBuyVolume": 147.405,
      "takerBuyQuoteVolume": 9499895.6637
    },
    {
      "low": 64419.2,
      "high": 64452.1,
      "open": 64448,
      "close": 64429.6,
      "volume": 110.019,
      "openTime": 1787012700000,
      "closeTime": 1787012999999,
      "priceType": "last",
      "tradeCount": 3507,
      "openTimeIso": "2026-08-18T00:25:00.000Z",
      "quoteVolume": 7089306.411,
      "closeTimeIso": "2026-08-18T00:29:59.999Z",
      "takerBuyVolume": 33.043,
      "takerBuyQuoteVolume": 2129142.4751
    }
  ],
  "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"
}
```

---

### Liquidations

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

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:binance-vision/liquidations`
- **Cache TTL:** 86400s

**Parameters:**

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

**cURL:**
```bash
curl "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: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:binance-vision/liquidations?symbol=BTCUSDT&date=2024-03-31&market=um&page=1&limit=5000", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:binance-vision/liquidations?symbol=BTCUSDT&date=2024-03-31&market=um&page=1&limit=5000",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "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
    },
    {
      "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
    },
    {
      "side": "SELL",
      "time": 1711843408644,
      "price": 69397.78,
      "timeIso": "2024-03-31T00:03:28.644Z",
      "orderType": "LIMIT",
      "orderStatus": "FILLED",
      "timeInForce": "IOC",
      "averagePrice": 69682.2,
      "lastFillQuantity": 0.012,
      "originalQuantity": 0.012,
      "accumulatedFillQuantity": 0.012
    },
    {
      "side": "SELL",
      "time": 1711843408644,
      "price": 69397.78,
      "timeIso": "2024-03-31T00:03:28.644Z",
      "orderType": "LIMIT",
      "orderStatus": "FILLED",
      "timeInForce": "IOC",
      "averagePrice": 69682.2,
      "lastFillQuantity": 0.012,
      "originalQuantity": 0.012,
      "accumulatedFillQuantity": 0.012
    }
  ],
  "total": 1544,
  "market": "um",
  "symbol": "BTCUSDT",
  "dataset": "liquidations",
  "hasMore": false,
  "checksum": {
    "sha256": "d81de4e236f73ccbdb1173db3d8a9c2f316e41de22ac6e77e5c94a29ffbc4134",
    "verified": true
  },
  "nextPage": null,
  "provider": "binance-vision",
  "timestampUnit": "ms"
}
```

---

### Mark Price Klines

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

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:binance-vision/mark-price-klines`
- **Cache TTL:** 86400s

**Parameters:**

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

**cURL:**
```bash
curl "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: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("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", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.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",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "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
    },
    {
      "low": 64388.8,
      "high": 64414,
      "open": 64397,
      "close": 64413.9,
      "volume": null,
      "openTime": 1787011800000,
      "closeTime": 1787012099999,
      "priceType": "mark",
      "tradeCount": 300,
      "openTimeIso": "2026-08-18T00:10:00.000Z",
      "quoteVolume": null,
      "closeTimeIso": "2026-08-18T00:14:59.999Z",
      "takerBuyVolume": null,
      "takerBuyQuoteVolume": null
    },
    {
      "low": 64413.9,
      "high": 64467.13863768,
      "open": 64413.9,
      "close": 64434.38625362,
      "volume": null,
      "openTime": 1787012100000,
      "closeTime": 1787012399999,
      "priceType": "mark",
      "tradeCount": 300,
      "openTimeIso": "2026-08-18T00:15:00.000Z",
      "quoteVolume": null,
      "closeTimeIso": "2026-08-18T00:19:59.999Z",
      "takerBuyVolume": null,
      "takerBuyQuoteVolume": null
    },
    {
      "low": 64417.5,
      "high": 64476.8,
      "open": 64433,
      "close": 64450.04192754,
      "volume": null,
      "openTime": 1787012400000,
      "closeTime": 1787012699999,
      "priceType": "mark",
      "tradeCount": 300,
      "openTimeIso": "2026-08-18T00:20:00.000Z",
      "quoteVolume": null,
      "closeTimeIso": "2026-08-18T00:24:59.999Z",
      "takerBuyVolume": null,
      "takerBuyQuoteVolume": null
    },
    {
      "low": 64422.95573913,
      "high": 64452.1,
      "open": 64450.04627536,
      "close": 64429.5,
      "volume": null,
      "openTime": 1787012700000,
      "closeTime": 1787012999999,
      "priceType": "mark",
      "tradeCount": 300,
      "openTimeIso": "2026-08-18T00:25:00.000Z",
      "quoteVolume": null,
      "closeTimeIso": "2026-08-18T00:29: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"
}
```

---

### Metrics

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

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:binance-vision/metrics`
- **Cache TTL:** 86400s

**Parameters:**

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

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:binance-vision/metrics?symbol=BTCUSDT&date=2026-08-18&market=um" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:binance-vision/metrics?symbol=BTCUSDT&date=2026-08-18&market=um", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:binance-vision/metrics?symbol=BTCUSDT&date=2026-08-18&market=um",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "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
    },
    {
      "createTime": 1787012100000,
      "createTimeIso": "2026-08-18T00:15:00.000Z",
      "sumOpenInterest": 106389.924,
      "countLongShortRatio": 1.47628829,
      "sumOpenInterestValue": 6855169456.509276,
      "sumTakerLongShortVolRatio": 1.596913,
      "sumTopTraderLongShortRatio": 1.478449,
      "countTopTraderLongShortRatio": 1.52888655
    },
    {
      "createTime": 1787012400000,
      "createTimeIso": "2026-08-18T00:20:00.000Z",
      "sumOpenInterest": 106406.941,
      "countLongShortRatio": 1.47398853,
      "sumOpenInterestValue": 6857931808.831275,
      "sumTakerLongShortVolRatio": 1.709771,
      "sumTopTraderLongShortRatio": 1.479359,
      "countTopTraderLongShortRatio": 1.52654329
    },
    {
      "createTime": 1787012700000,
      "createTimeIso": "2026-08-18T00:25:00.000Z",
      "sumOpenInterest": 106416.443,
      "countLongShortRatio": 1.472301,
      "sumOpenInterestValue": 6856358214.2685,
      "sumTakerLongShortVolRatio": 0.429248,
      "sumTopTraderLongShortRatio": 1.478296,
      "countTopTraderLongShortRatio": 1.52477468
    }
  ],
  "market": "um",
  "symbol": "BTCUSDT",
  "dataset": "metrics",
  "checksum": {
    "sha256": "1db58bdad3275ebd42f68aef01a69e344750fad2f7783926c6b193001c6a06a0",
    "verified": true
  },
  "complete": true,
  "interval": "5m",
  "provider": "binance-vision",
  "missingRows": 0,
  "expectedRows": 288,
  "timestampUnit": "ms"
}
```

---

### Premium Index Klines

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

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:binance-vision/premium-index-klines`
- **Cache TTL:** 86400s

**Parameters:**

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

**cURL:**
```bash
curl "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: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("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", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.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",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "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
    },
    {
      "low": -0.00061512,
      "high": -0.00035748,
      "open": -0.0005196,
      "close": -0.00036421,
      "volume": null,
      "openTime": 1787011800000,
      "closeTime": 1787012099999,
      "priceType": "premium",
      "tradeCount": 60,
      "openTimeIso": "2026-08-18T00:10:00.000Z",
      "quoteVolume": null,
      "closeTimeIso": "2026-08-18T00:14:59.999Z",
      "takerBuyVolume": null,
      "takerBuyQuoteVolume": null
    },
    {
      "low": -0.00050569,
      "high": -0.00008734,
      "open": -0.00036418,
      "close": -0.00041298,
      "volume": null,
      "openTime": 1787012100000,
      "closeTime": 1787012399999,
      "priceType": "premium",
      "tradeCount": 60,
      "openTimeIso": "2026-08-18T00:15:00.000Z",
      "quoteVolume": null,
      "closeTimeIso": "2026-08-18T00:19:59.999Z",
      "takerBuyVolume": null,
      "takerBuyQuoteVolume": null
    },
    {
      "low": -0.00060605,
      "high": -0.00018062,
      "open": -0.00060605,
      "close": -0.00047469,
      "volume": null,
      "openTime": 1787012400000,
      "closeTime": 1787012699999,
      "priceType": "premium",
      "tradeCount": 60,
      "openTimeIso": "2026-08-18T00:20:00.000Z",
      "quoteVolume": null,
      "closeTimeIso": "2026-08-18T00:24:59.999Z",
      "takerBuyVolume": null,
      "takerBuyQuoteVolume": null
    },
    {
      "low": -0.00058068,
      "high": -0.00037628,
      "open": -0.00046472,
      "close": -0.00046562,
      "volume": null,
      "openTime": 1787012700000,
      "closeTime": 1787012999999,
      "priceType": "premium",
      "tradeCount": 60,
      "openTimeIso": "2026-08-18T00:25:00.000Z",
      "quoteVolume": null,
      "closeTimeIso": "2026-08-18T00:29: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"
}
```

---

### Symbols

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

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:binance-vision/symbols`
- **Cache TTL:** 21600s

**Parameters:**

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

**cURL:**
```bash
curl "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: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:binance-vision/symbols?series=klines&market=um&period=daily&query=BTC&page=1&limit=200", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:binance-vision/symbols?series=klines&market=um&period=daily&query=BTC&page=1&limit=200",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "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"
}
```

---

### Trades

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

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:binance-vision/trades`
- **Cache TTL:** 86400s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `symbol` | string | query | yes | Archive symbol, spelled as Binance spells it (BTCUSD_PERP for coin-margined). |
| `date` | string | query | yes | 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(um|spot|cm) | query | no | um (USD-margined futures), spot, cm (coin-margined futures). Default um. |
| `page` | number | query | no | Page of rows. Default 1. |
| `limit` | number | query | no | Rows per page. Default 10000, max 50000. |

**cURL:**
```bash
curl "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: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:binance-vision/trades?symbol=BTCUSDT&date=2026-08-18&market=um&page=1&limit=10000", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:binance-vision/trades?symbol=BTCUSDT&date=2026-08-18&market=um&page=1&limit=10000",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "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
    },
    {
      "time": 1787011200092,
      "price": 64504.2,
      "timeIso": "2026-08-18T00:00:00.092Z",
      "tradeId": 7976144184,
      "quantity": 0.062,
      "isBestMatch": null,
      "isBuyerMaker": false,
      "quoteQuantity": 3999.2604
    },
    {
      "time": 1787011200143,
      "price": 64504.2,
      "timeIso": "2026-08-18T00:00:00.143Z",
      "tradeId": 7976144185,
      "quantity": 0.002,
      "isBestMatch": null,
      "isBuyerMaker": false,
      "quoteQuantity": 129.0084
    },
    {
      "time": 1787011200143,
      "price": 64504.2,
      "timeIso": "2026-08-18T00:00:00.143Z",
      "tradeId": 7976144186,
      "quantity": 0.012,
      "isBestMatch": null,
      "isBuyerMaker": false,
      "quoteQuantity": 774.0504
    }
  ],
  "total": 1636466,
  "market": "um",
  "period": "daily",
  "symbol": "BTCUSDT",
  "dataset": "trades",
  "hasMore": true,
  "checksum": {
    "sha256": "8063a3ba07b9af225122b14a1a8f71f7c657d891c38f0a38cf2d52d1fba47ea5",
    "verified": true
  },
  "nextPage": 2,
  "provider": "binance-vision",
  "timestampUnit": "ms"
}
```

---


_Generated: 2026-08-20T22:18:48.137Z_