# Deribit — Zapi reference

> Deribit public data, including DVOL — the crypto volatility index — at one-second resolution, plus options instruments and index prices.

**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/deribit
- 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

---

## Deribit

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

Deribit public data, including DVOL — the crypto volatility index — at one-second resolution, plus options instruments and index prices.

**Tags:** deribit, crypto, options, volatility, dvol, derivatives

### Book Summary

Top of book, open interest and 24h volume for every Deribit instrument in one

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:deribit/book-summary`
- **Cache TTL:** 15s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `currency` | enum(BTC|ETH|USDC|USDT|EURR) | query | no | Settlement currency. Default BTC |
| `kind` | enum(future|option|spot|future_combo|option_combo) | query | no | Instrument kind. Omit for every kind |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:deribit/book-summary?currency=BTC&kind=future" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:deribit/book-summary?currency=BTC&kind=future", {
  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:deribit/book-summary?currency=BTC&kind=future",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "kind": "future",
  "count": 13,
  "items": [
    {
      "date": "2026-08-20T14:59:36.039Z",
      "time": 1787237976039,
      "low24h": 66152.5,
      "markIv": null,
      "symbol": "BTC-30OCT26",
      "volume": 79.60912343,
      "high24h": 72970,
      "askPrice": 72350,
      "bidPrice": 72327.5,
      "midPrice": 72338.75,
      "lastPrice": 72238.5,
      "markPrice": 72348.81,
      "volumeUsd": 5595640,
      "baseCurrency": "BTC",
      "openInterest": 8088840,
      "quoteCurrency": "USD",
      "volumeNotional": 5595640,
      "underlyingPrice": null,
      "priceChangePct24h": 8.6579,
      "estimatedDeliveryPrice": 71740.86
    },
    {
      "date": "2026-08-20T14:59:36.039Z",
      "time": 1787237976039,
      "low24h": 68405,
      "markIv": null,
      "symbol": "BTC-25JUN27",
      "volume": 84.9230532,
      "high24h": 75140,
      "askPrice": 74415,
      "bidPrice": 74355,
      "midPrice": 74385,
      "lastPrice": 74115,
      "markPrice": 74392.24,
      "volumeUsd": 6136400,
      "baseCurrency": "BTC",
      "openInterest": 10423000,
      "quoteCurrency": "USD",
      "volumeNotional": 6136400,
      "underlyingPrice": null,
      "priceChangePct24h": 8.2484,
      "estimatedDeliveryPrice": 71740.86
    },
    {
      "date": "2026-08-20T14:59:36.039Z",
      "time": 1787237976039,
      "low24h": 65955,
      "markIv": null,
      "symbol": "BTC-23AUG26",
      "volume": 130.46758673,
      "high24h": 72395,
      "askPrice": 71740,
      "bidPrice": 71715,
      "midPrice": 71727.5,
      "lastPrice": 71727.5,
      "markPrice": 71737.15,
      "volumeUsd": 9080690,
      "baseCurrency": "BTC",
      "openInterest": 8264000,
      "quoteCurrency": "USD",
      "volumeNotional": 9080690,
      "underlyingPrice": null,
      "priceChangePct24h": 8.7522,
      "estimatedDeliveryPrice": 71740.86
    },
    {
      "date": "2026-08-20T14:59:36.039Z",
      "time": 1787237976039,
      "low24h": 65862.5,
      "markIv": null,
      "symbol": "BTC-PERPETUAL",
      "volume": 17705.94753784,
      "high24h": 72429,
      "askPrice": 71749,
      "bidPrice": 71748.5,
      "midPrice": 71748.75,
      "lastPrice": 71748.5,
      "markPrice": 71747.68,
      "volumeUsd": 1232348500,
      "baseCurrency": "BTC",
      "openInterest": 824275030,
      "quoteCurrency": "USD",
      "volumeNotional": 1232348500,
      "underlyingPrice": null,
      "priceChangePct24h": 8.8228,
      "estimatedDeliveryPrice": 71740.86
    },
    {
      "date": "2026-08-20T14:59:36.039Z",
      "time": 1787237976039,
      "low24h": 67677.5,
      "markIv": null,
      "symbol": "BTC-26MAR27",
      "volume": 143.91801559,
      "high24h": 74305,
      "askPrice": 73612.5,
      "bidPrice": 73562.5,
      "midPrice": 73587.5,
      "lastPrice": 73562.5,
      "markPrice": 73594.92,
      "volumeUsd": 10333320,
      "baseCurrency": "BTC",
      "openInterest": 55663280,
      "quoteCurrency": "USD",
      "volumeNotional": 10333320,
      "underlyingPrice": null,
      "priceChangePct24h": 8.6957,
      "estimatedDeliveryPrice": 71740.86
    },
    {
      "date": "2026-08-20T14:59:36.039Z",
      "time": 1787237976039,
      "low24h": 65955,
      "markIv": null,
      "symbol": "BTC-22AUG26",
      "volume": 259.85274702,
      "high24h": 72237.5,
      "askPrice": 71735,
      "bidPrice": 71710,
      "midPrice": 71722.5,
      "lastPrice": 71697.5,
      "markPrice": 71733.89,
      "volumeUsd": 18160010,
      "baseCurrency": "BTC",
      "openInterest": 10403550,
      "quoteCurrency": "USD",
      "volumeNotional": 18160010,
      "underlyingPrice": null,
      "priceChangePct24h": 8.7067,
      "estimatedDeliveryPrice": 71740.86
    }
  ],
  "dataset": "book-summary",
  "currency": "BTC",
  "provider": "deribit"
}
```

---

### Funding Rate History

Hourly funding for one Deribit perpetual, with the index it was struck on.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:deribit/funding-rate-history`
- **Cache TTL:** 60s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `symbol` | string | query | no | Perpetual instrument name |
| `start` | string | query | no | Oldest hour to include. Epoch ms/s or ISO date. Defaults to seven days back |
| `end` | string | query | no | Newest hour to include. Epoch ms/s or ISO date. Defaults to now |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:deribit/funding-rate-history?symbol=BTC-PERPETUAL&start=2026-08-13T00%3A00%3A00Z&end=2026-08-20T00%3A00%3A00Z" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:deribit/funding-rate-history?symbol=BTC-PERPETUAL&start=2026-08-13T00%3A00%3A00Z&end=2026-08-20T00%3A00%3A00Z", {
  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:deribit/funding-rate-history?symbol=BTC-PERPETUAL&start=2026-08-13T00%3A00%3A00Z&end=2026-08-20T00%3A00%3A00Z",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 168,
  "items": [
    {
      "date": "2026-08-13T01:00:00.000Z",
      "time": 1786582800000,
      "indexPrice": 63495.11,
      "interest1h": 0.000007511698674394949,
      "interest8h": 0.00004911071730031578,
      "previousIndexPrice": 63413.47
    },
    {
      "date": "2026-08-13T02:00:00.000Z",
      "time": 1786586400000,
      "indexPrice": 63391.67,
      "interest1h": 0.0000030121484716520185,
      "interest8h": 0.00004117415585266742,
      "previousIndexPrice": 63495.11
    },
    {
      "date": "2026-08-13T03:00:00.000Z",
      "time": 1786590000000,
      "indexPrice": 63483.87,
      "interest1h": 0.0000015973149776453194,
      "interest8h": 0.00003248514867255686,
      "previousIndexPrice": 63391.67
    },
    {
      "date": "2026-08-13T04:00:00.000Z",
      "time": 1786593600000,
      "indexPrice": 63584,
      "interest1h": 0.0000024490050545234122,
      "interest8h": 0.000030038661823743066,
      "previousIndexPrice": 63483.87
    },
    {
      "date": "2026-08-13T05:00:00.000Z",
      "time": 1786597200000,
      "indexPrice": 63628.5,
      "interest1h": 0.0000049281227417091035,
      "interest8h": 0.00003133237488612422,
      "previousIndexPrice": 63584
    },
    {
      "date": "2026-08-13T06:00:00.000Z",
      "time": 1786600800000,
      "indexPrice": 63813.23,
      "interest1h": 0.0000024846883603425967,
      "interest8h": 0.00003232543799943846,
      "previousIndexPrice": 63628.5
    }
  ],
  "symbol": "BTC-PERPETUAL",
  "dataset": "funding-rate-history",
  "provider": "deribit"
}
```

---

### Historical Volatility

Realised volatility for one Deribit currency — the backward-looking twin of

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:deribit/historical-volatility`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `currency` | enum(BTC|ETH|USDC|USDT|EURR) | query | no | Index currency. Default BTC |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:deribit/historical-volatility?currency=BTC" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:deribit/historical-volatility?currency=BTC", {
  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:deribit/historical-volatility?currency=BTC",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 384,
  "items": [
    {
      "date": "2026-08-04T17:00:00.000Z",
      "time": 1785862800000,
      "volatility": 28.69387387574387
    },
    {
      "date": "2026-08-04T17:00:00.000Z",
      "time": 1785862800000,
      "volatility": 28.69387387574387
    },
    {
      "date": "2026-08-04T18:00:00.000Z",
      "time": 1785866400000,
      "volatility": 28.71583025957184
    },
    {
      "date": "2026-08-04T19:00:00.000Z",
      "time": 1785870000000,
      "volatility": 28.70983568463423
    },
    {
      "date": "2026-08-04T20:00:00.000Z",
      "time": 1785873600000,
      "volatility": 28.71183839968203
    },
    {
      "date": "2026-08-04T21:00:00.000Z",
      "time": 1785877200000,
      "volatility": 28.70813156705442
    }
  ],
  "dataset": "historical-volatility",
  "currency": "BTC",
  "provider": "deribit"
}
```

---

### Index Price Names

Every index name Deribit publishes — the input vocabulary for index-price.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:deribit/index-price-names`
- **Cache TTL:** 3600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | no | Filter the names by substring |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:deribit/index-price-names?query=btc" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:deribit/index-price-names?query=btc", {
  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:deribit/index-price-names?query=btc",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 10,
  "items": [
    "btc_usd",
    "btc_usdc",
    "btc_usdt",
    "drbfix-btc_usdc",
    "eth_btc",
    "btc_eurr"
  ],
  "query": "btc",
  "total": 344,
  "dataset": "index-price-names",
  "provider": "deribit"
}
```

---

### Index Price

The spot index Deribit settles one contract family against.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:deribit/index-price`
- **Cache TTL:** 5s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `indexName` | string | query | no | Index name. The full list is the index-price-names endpoint |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:deribit/index-price?indexName=btc_usd" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:deribit/index-price?indexName=btc_usd", {
  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:deribit/index-price?indexName=btc_usd",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "dataset": "index-price",
  "provider": "deribit",
  "indexName": "btc_usd",
  "indexPrice": 71770.14,
  "estimatedDeliveryPrice": 71770.14
}
```

---

### Instruments

Contract specifications for one Deribit currency — futures, options or spot.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:deribit/instruments`
- **Cache TTL:** 600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `currency` | enum(BTC|ETH|USDC|USDT|EURR|any) | query | no | Settlement currency, or any for every one. Default BTC |
| `kind` | enum(future|option|spot|future_combo|option_combo) | query | no | Instrument kind. Omit for every kind |
| `expired` | enum(true|false) | query | no | Return expired instruments instead of live ones. Default false |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:deribit/instruments?currency=BTC&kind=future&expired=false" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:deribit/instruments?currency=BTC&kind=future&expired=false", {
  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:deribit/instruments?currency=BTC&kind=future&expired=false",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "kind": "future",
  "count": 13,
  "items": [
    {
      "kind": "future",
      "state": "open",
      "symbol": "BTC-PERPETUAL",
      "tickSize": 0.5,
      "expiryDate": "3000-01-01T08:00:00.000Z",
      "expiryTime": 32503708800000,
      "futureType": "reversed",
      "priceIndex": "btc_usd",
      "maxLeverage": 50,
      "baseCurrency": "BTC",
      "contractSize": 10,
      "creationDate": "2018-08-14T10:24:47.000Z",
      "creationTime": 1534242287000,
      "quoteCurrency": "USD",
      "instrumentType": "reversed",
      "minTradeAmount": 10,
      "counterCurrency": "USD",
      "makerCommission": 0.00015,
      "takerCommission": 0.00035,
      "settlementPeriod": "perpetual",
      "settlementCurrency": "BTC",
      "blockTradeMinAmount": 200000,
      "blockTradeCommission": 0.00025
    },
    {
      "kind": "future",
      "state": "open",
      "symbol": "BTC-21AUG26",
      "tickSize": 2.5,
      "expiryDate": "2026-08-21T08:00:00.000Z",
      "expiryTime": 1787299200000,
      "futureType": "reversed",
      "priceIndex": "btc_usd",
      "maxLeverage": 25,
      "baseCurrency": "BTC",
      "contractSize": 10,
      "creationDate": "2026-07-30T08:00:13.000Z",
      "creationTime": 1785398413000,
      "quoteCurrency": "USD",
      "instrumentType": "reversed",
      "minTradeAmount": 10,
      "counterCurrency": "USD",
      "makerCommission": 0.00015,
      "takerCommission": 0.00035,
      "settlementPeriod": "week",
      "settlementCurrency": "BTC",
      "blockTradeMinAmount": 200000,
      "blockTradeCommission": 0.00025
    },
    {
      "kind": "future",
      "state": "open",
      "symbol": "BTC-22AUG26",
      "tickSize": 2.5,
      "expiryDate": "2026-08-22T08:00:00.000Z",
      "expiryTime": 1787385600000,
      "futureType": "reversed",
      "priceIndex": "btc_usd",
      "maxLeverage": 25,
      "baseCurrency": "BTC",
      "contractSize": 10,
      "creationDate": "2026-08-18T08:00:18.000Z",
      "creationTime": 1787040018000,
      "quoteCurrency": "USD",
      "instrumentType": "reversed",
      "minTradeAmount": 10,
      "counterCurrency": "USD",
      "makerCommission": 0.00015,
      "takerCommission": 0.00035,
      "settlementPeriod": "day",
      "settlementCurrency": "BTC",
      "blockTradeMinAmount": 200000,
      "blockTradeCommission": 0.00025
    },
    {
      "kind": "future",
      "state": "open",
      "symbol": "BTC-23AUG26",
      "tickSize": 2.5,
      "expiryDate": "2026-08-23T08:00:00.000Z",
      "expiryTime": 1787472000000,
      "futureType": "reversed",
      "priceIndex": "btc_usd",
      "maxLeverage": 25,
      "baseCurrency": "BTC",
      "contractSize": 10,
      "creationDate": "2026-08-19T08:00:19.000Z",
      "creationTime": 1787126419000,
      "quoteCurrency": "USD",
      "instrumentType": "reversed",
      "minTradeAmount": 10,
      "counterCurrency": "USD",
      "makerCommission": 0.00015,
      "takerCommission": 0.00035,
      "settlementPeriod": "day",
      "settlementCurrency": "BTC",
      "blockTradeMinAmount": 200000,
      "blockTradeCommission": 0.00025
    },
    {
      "kind": "future",
      "state": "open",
      "symbol": "BTC-24AUG26",
      "tickSize": 2.5,
      "expiryDate": "2026-08-24T08:00:00.000Z",
      "expiryTime": 1787558400000,
      "futureType": "reversed",
      "priceIndex": "btc_usd",
      "maxLeverage": 25,
      "baseCurrency": "BTC",
      "contractSize": 10,
      "creationDate": "2026-08-20T08:00:21.000Z",
      "creationTime": 1787212821000,
      "quoteCurrency": "USD",
      "instrumentType": "reversed",
      "minTradeAmount": 10,
      "counterCurrency": "USD",
      "makerCommission": 0.00015,
      "takerCommission": 0.00035,
      "settlementPeriod": "day",
      "settlementCurrency": "BTC",
      "blockTradeMinAmount": 200000,
      "blockTradeCommission": 0.00025
    },
    {
      "kind": "future",
      "state": "open",
      "symbol": "BTC-28AUG26",
      "tickSize": 2.5,
      "expiryDate": "2026-08-28T08:00:00.000Z",
      "expiryTime": 1787904000000,
      "futureType": "reversed",
      "priceIndex": "btc_usd",
      "maxLeverage": 25,
      "baseCurrency": "BTC",
      "contractSize": 10,
      "creationDate": "2026-05-28T08:00:13.000Z",
      "creationTime": 1779955213000,
      "quoteCurrency": "USD",
      "instrumentType": "reversed",
      "minTradeAmount": 10,
      "counterCurrency": "USD",
      "makerCommission": 0.00015,
      "takerCommission": 0.00035,
      "settlementPeriod": "month",
      "settlementCurrency": "BTC",
      "blockTradeMinAmount": 200000,
      "blockTradeCommission": 0.00025
    }
  ],
  "dataset": "instruments",
  "expired": false,
  "currency": "BTC",
  "provider": "deribit"
}
```

---

### Order Book

Depth for one Deribit instrument, plus the funding, open interest, mark and

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:deribit/order-book`

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `symbol` | string | query | no | Instrument name, Deribit's own form |
| `depth` | enum(1|5|10|20|50|100|1000|10000) | query | no | Levels per side. Default 10 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:deribit/order-book?symbol=BTC-PERPETUAL&depth=10" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:deribit/order-book?symbol=BTC-PERPETUAL&depth=10", {
  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:deribit/order-book?symbol=BTC-PERPETUAL&depth=10",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "asks": [
    {
      "size": 7800,
      "price": 72195
    },
    {
      "size": 6000,
      "price": 72195.5
    },
    {
      "size": 1790,
      "price": 72197
    },
    {
      "size": 30580,
      "price": 72198
    },
    {
      "size": 42600,
      "price": 72198.5
    },
    {
      "size": 6000,
      "price": 72199
    }
  ],
  "bids": [
    {
      "size": 17160,
      "price": 72194.5
    },
    {
      "size": 10000,
      "price": 72194
    },
    {
      "size": 6000,
      "price": 72192
    },
    {
      "size": 350,
      "price": 72190
    },
    {
      "size": 580,
      "price": 72188
    },
    {
      "size": 1500,
      "price": 72184.5
    }
  ],
  "date": "2026-08-20T15:15:34.793Z",
  "time": 1787238934793,
  "state": "open",
  "low24h": 66546,
  "symbol": "BTC-PERPETUAL",
  "dataset": "order-book",
  "high24h": 72511.5,
  "askCount": 10,
  "bidCount": 10,
  "changeId": 170552772179,
  "maxPrice": 73273.5,
  "minPrice": 71107,
  "provider": "deribit",
  "funding8h": 0.00000879,
  "lastPrice": 72187,
  "markPrice": 72190.31,
  "volume24h": 17388.78581996,
  "indexPrice": 72188.68,
  "bestAskPrice": 72195,
  "bestBidPrice": 72194.5,
  "openInterest": 822593720,
  "volumeUsd24h": 1213453520,
  "bestAskAmount": 7800,
  "bestBidAmount": 17160,
  "interestValue": 0.0011166989872886256,
  "currentFunding": 0,
  "settlementPrice": 69806.07,
  "priceChangePct24h": 8.3637,
  "volumeNotional24h": 1213453520,
  "estimatedDeliveryPrice": 72188.68
}
```

---

### Ticker

Everything Deribit publishes about one instrument in a single call.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:deribit/ticker`
- **Cache TTL:** 5s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `symbol` | string | query | no | Instrument name, Deribit's own form |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:deribit/ticker?symbol=BTC-PERPETUAL" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:deribit/ticker?symbol=BTC-PERPETUAL", {
  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:deribit/ticker?symbol=BTC-PERPETUAL",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "date": "2026-08-20T15:00:24.798Z",
  "time": 1787238024798,
  "state": "open",
  "low24h": 65862.5,
  "symbol": "BTC-PERPETUAL",
  "dataset": "ticker",
  "high24h": 72429,
  "maxPrice": 72846,
  "minPrice": 70692.5,
  "provider": "deribit",
  "funding8h": 0.00001004,
  "lastPrice": 71755,
  "markPrice": 71769.38,
  "volume24h": 17682.42559782,
  "indexPrice": 71765.41,
  "bestAskPrice": 71755,
  "bestBidPrice": 71754.5,
  "openInterest": 822916570,
  "volumeUsd24h": 1230962300,
  "bestAskAmount": 361770,
  "bestBidAmount": 255060,
  "interestValue": 0.0011131102258984174,
  "currentFunding": 0,
  "settlementPrice": 69806.07,
  "priceChangePct24h": 8.8838,
  "volumeNotional24h": 1230962300,
  "estimatedDeliveryPrice": 71765.41
}
```

---

### Trades

Recent public prints for one Deribit instrument.

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

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `symbol` | string | query | no | Instrument name, Deribit's own form |
| `count` | number | query | no | Prints to return. Default 100, max 1000 |
| `sorting` | enum(asc|desc|default) | query | no | Order the exchange applies before the cap. Default desc |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:deribit/trades?symbol=BTC-PERPETUAL&count=100&sorting=desc" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:deribit/trades?symbol=BTC-PERPETUAL&count=100&sorting=desc", {
  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:deribit/trades?symbol=BTC-PERPETUAL&count=100&sorting=desc",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 100,
  "items": [
    {
      "iv": null,
      "date": "2026-08-20T15:00:32.548Z",
      "time": 1787238032548,
      "price": 71769,
      "amount": 330,
      "symbol": "BTC-PERPETUAL",
      "tradeId": "440863223",
      "contracts": 33,
      "direction": "buy",
      "markPrice": 71771,
      "indexPrice": 71767.71,
      "tickDirection": 1,
      "tradeSequence": 296610088
    },
    {
      "iv": null,
      "date": "2026-08-20T15:00:30.853Z",
      "time": 1787238030853,
      "price": 71769,
      "amount": 1280,
      "symbol": "BTC-PERPETUAL",
      "tradeId": "440863222",
      "contracts": 128,
      "direction": "buy",
      "markPrice": 71767.66,
      "indexPrice": 71764.35,
      "tickDirection": 0,
      "tradeSequence": 296610087
    },
    {
      "iv": null,
      "date": "2026-08-20T15:00:30.099Z",
      "time": 1787238030099,
      "price": 71768.5,
      "amount": 1000,
      "symbol": "BTC-PERPETUAL",
      "tradeId": "440863220",
      "contracts": 100,
      "direction": "sell",
      "markPrice": 71767.98,
      "indexPrice": 71764.69,
      "tickDirection": 3,
      "tradeSequence": 296610086
    },
    {
      "iv": null,
      "date": "2026-08-20T15:00:28.890Z",
      "time": 1787238028890,
      "price": 71768.5,
      "amount": 1000,
      "symbol": "BTC-PERPETUAL",
      "tradeId": "440863219",
      "contracts": 100,
      "direction": "sell",
      "markPrice": 71768.89,
      "indexPrice": 71765.58,
      "tickDirection": 3,
      "tradeSequence": 296610085
    },
    {
      "iv": null,
      "date": "2026-08-20T15:00:27.654Z",
      "time": 1787238027654,
      "price": 71768.5,
      "amount": 690,
      "symbol": "BTC-PERPETUAL",
      "tradeId": "440863218",
      "contracts": 69,
      "direction": "sell",
      "markPrice": 71772.16,
      "indexPrice": 71768.73,
      "tickDirection": 2,
      "tradeSequence": 296610084
    },
    {
      "iv": null,
      "date": "2026-08-20T15:00:27.654Z",
      "time": 1787238027654,
      "price": 71771,
      "amount": 90,
      "symbol": "BTC-PERPETUAL",
      "tradeId": "440863217",
      "contracts": 9,
      "direction": "sell",
      "markPrice": 71772.16,
      "indexPrice": 71768.73,
      "tickDirection": 1,
      "tradeSequence": 296610083
    }
  ],
  "symbol": "BTC-PERPETUAL",
  "dataset": "trades",
  "hasMore": true,
  "sorting": "desc",
  "provider": "deribit"
}
```

---

### Volatility Index

DVOL — Deribit's implied-volatility index, crypto's VIX — as OHLC candles.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:deribit/volatility-index`
- **Cache TTL:** 30s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `currency` | enum(BTC|ETH|USDC|USDT|EURR) | query | no | Index currency. BTC and ETH carry the deep history. Default BTC |
| `resolution` | enum(1|60|3600|43200|1D) | query | no | Bar size in seconds, or 1D for a day. Default 60 |
| `start` | string | query | no | Oldest bar to include. Epoch ms/s or ISO date |
| `end` | string | query | no | Newest bar to include. Epoch ms/s or ISO date |
| `page` | number | query | no | Page number, walking backwards in time. Default 1, max 20 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:deribit/volatility-index?currency=BTC&resolution=60&start=2026-08-19T00%3A00%3A00Z&end=2026-08-20T00%3A00%3A00Z&page=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:deribit/volatility-index?currency=BTC&resolution=60&start=2026-08-19T00%3A00%3A00Z&end=2026-08-20T00%3A00%3A00Z&page=1", {
  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:deribit/volatility-index?currency=BTC&resolution=60&start=2026-08-19T00%3A00%3A00Z&end=2026-08-20T00%3A00%3A00Z&page=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "page": 1,
  "count": 1000,
  "items": [
    {
      "low": 34.68,
      "date": "2026-08-19T07:21:00.000Z",
      "high": 34.68,
      "open": 34.68,
      "close": 34.68,
      "openTime": 1787124060000,
      "closeTime": 1787124119999
    },
    {
      "low": 34.68,
      "date": "2026-08-19T07:22:00.000Z",
      "high": 34.69,
      "open": 34.68,
      "close": 34.69,
      "openTime": 1787124120000,
      "closeTime": 1787124179999
    },
    {
      "low": 34.69,
      "date": "2026-08-19T07:23:00.000Z",
      "high": 34.7,
      "open": 34.69,
      "close": 34.7,
      "openTime": 1787124180000,
      "closeTime": 1787124239999
    },
    {
      "low": 34.7,
      "date": "2026-08-19T07:24:00.000Z",
      "high": 34.7,
      "open": 34.7,
      "close": 34.7,
      "openTime": 1787124240000,
      "closeTime": 1787124299999
    },
    {
      "low": 34.7,
      "date": "2026-08-19T07:25:00.000Z",
      "high": 34.73,
      "open": 34.7,
      "close": 34.73,
      "openTime": 1787124300000,
      "closeTime": 1787124359999
    },
    {
      "low": 34.72,
      "date": "2026-08-19T07:26:00.000Z",
      "high": 34.72,
      "open": 34.72,
      "close": 34.72,
      "openTime": 1787124360000,
      "closeTime": 1787124419999
    }
  ],
  "dataset": "volatility-index",
  "hasMore": true,
  "currency": "BTC",
  "nextPage": 2,
  "provider": "deribit",
  "resolution": "60"
}
```

---


_Generated: 2026-08-20T22:24:05.983Z_