# Binance — Zapi reference

> Global crypto spot market data — 24h statistics, candles and order book depth from the largest venue.

**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:** `{ status, message, content }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/finance/binance
- 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

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

Global crypto spot market data — 24h statistics, candles and order book depth from the largest venue.

**Tags:** crypto, exchange, orderbook, klines, usdt

### Ticker

24-hour statistics for one spot pair.

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

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `symbol` | string | query | yes | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt |

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

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

**Example response:**
```json
{
  "ask": 62986.66,
  "bid": 62986.65,
  "low": 62275,
  "high": 63150,
  "last": 62986.66,
  "open": 62971.86,
  "askQty": 4.04187,
  "bidQty": 3.92792,
  "change": 14.8,
  "symbol": "BTCUSDT",
  "exchange": "binance",
  "openTime": 1785549235012,
  "closeTime": 1785635635012,
  "tradeCount": 826869,
  "volumeBase": 7308.28437,
  "volumeQuote": 459748760.2615933,
  "changePercent": 0.024,
  "previousClose": 62971.86,
  "weightedAvgPrice": 62907.89150855
}
```

---

### Tickers

Every spot pair at once, filterable by quote asset.

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

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `quote` | enum(all|USDT|USDC|BTC|ETH|BNB|FDUSD|TRY|EUR) | query | no | Restrict to pairs quoted in this asset. Default USDT |
| `search` | string | query | no | Filter by base asset |
| `sort` | enum(volume|change|symbol) | query | no | Sort key, descending for volume and change. Default volume |
| `count` | number | query | no | Rows to return. Default 100, max 500 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:binance/tickers?quote=USDT&search=btc&sort=volume&count=100" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:binance/tickers?quote=USDT&search=btc&sort=volume&count=100", {
  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/tickers?quote=USDT&search=btc&sort=volume&count=100",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "sort": "volume",
  "count": 10,
  "items": [
    {
      "low": 1.0007,
      "base": "USDC",
      "high": 1.0009,
      "last": 1.00085,
      "quote": "USDT",
      "change": -0.00003,
      "symbol": "USDCUSDT",
      "tradeCount": 505338,
      "volumeBase": 465800496,
      "volumeQuote": 466177265.05961,
      "changePercent": -0.003
    },
    {
      "low": 62275,
      "base": "BTC",
      "high": 63150,
      "last": 62991.99,
      "quote": "USDT",
      "change": 20.13,
      "symbol": "BTCUSDT",
      "tradeCount": 827359,
      "volumeBase": 7311.09465,
      "volumeQuote": 459925771.4156871,
      "changePercent": 0.032
    },
    {
      "low": 1822.06,
      "base": "ETH",
      "high": 1875.45,
      "last": 1856.5,
      "quote": "USDT",
      "change": -10.05,
      "symbol": "ETHUSDT",
      "tradeCount": 878480,
      "volumeBase": 113651.93,
      "volumeQuote": 210628641.95109,
      "changePercent": -0.538
    },
    {
      "low": 0.0407,
      "base": "MIRA",
      "high": 0.0433,
      "last": 0.041,
      "quote": "USDT",
      "change": -0.0018,
      "symbol": "MIRAUSDT",
      "tradeCount": 124310,
      "volumeBase": 2191410638.9,
      "volumeQuote": 94077365.95299,
      "changePercent": -4.206
    },
    {
      "low": 70.58,
      "base": "SOL",
      "high": 73.21,
      "last": 72.65,
      "quote": "USDT",
      "change": -0.39,
      "symbol": "SOLUSDT",
      "tradeCount": 272860,
      "volumeBase": 1105628.794,
      "volumeQuote": 79911008.59277,
      "changePercent": -0.534
    },
    {
      "low": 573.5,
      "base": "BNB",
      "high": 592.8,
      "last": 577.93,
      "quote": "USDT",
      "change": -11.92,
      "symbol": "BNBUSDT",
      "tradeCount": 492848,
      "volumeBase": 105720.504,
      "volumeQuote": 61457961.68883,
      "changePercent": -2.021
    },
    {
      "low": 0.99986,
      "base": "USD1",
      "high": 1.00004,
      "last": 0.99993,
      "quote": "USDT",
      "change": -0.00011,
      "symbol": "USD1USDT",
      "tradeCount": 102808,
      "volumeBase": 57487899,
      "volumeQuote": 57483361.20734,
      "changePercent": -0.011
    },
    {
      "low": 37.07,
      "base": "GIGGLE",
      "high": 55.71,
      "last": 42.51,
      "quote": "USDT",
      "change": -2.97,
      "symbol": "GIGGLEUSDT",
      "tradeCount": 841714,
      "volumeBase": 1065602.953,
      "volumeQuote": 48090911.77891,
      "changePercent": -6.53
    }
  ],
  "quote": "USDT",
  "total": 723,
  "exchange": "binance"
}
```

---

### Klines

OHLCV candles from one minute to one month.

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

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `symbol` | string | query | yes | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt |
| `interval` | enum(1m|3m|5m|15m|30m|1h|2h|4h|6h|8h|12h|1d|3d|1w|1M) | query | no | Candle size. Default 1d |
| `count` | number | query | no | Number of candles. Default 200, max 1000 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:binance/klines?symbol=BTCUSDT&interval=1d&count=200" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:binance/klines?symbol=BTCUSDT&interval=1d&count=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/klines?symbol=BTCUSDT&interval=1d&count=200",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 30,
  "symbol": "BTCUSDT",
  "candles": [
    {
      "low": 62328.24,
      "date": "2026-07-04T00:00:00.000Z",
      "high": 63461.99,
      "open": 62583.26,
      "close": 63144.01,
      "openTime": 1783123200000,
      "closeTime": 1783209599999,
      "tradeCount": 1643288,
      "volumeBase": 9139.8274,
      "volumeQuote": 574233846.0826051
    },
    {
      "low": 62436.59,
      "date": "2026-07-05T00:00:00.000Z",
      "high": 63999,
      "open": 63144.01,
      "close": 63650,
      "openTime": 1783209600000,
      "closeTime": 1783295999999,
      "tradeCount": 1790183,
      "volumeBase": 9172.07758,
      "volumeQuote": 577866444.607444
    },
    {
      "low": 61306.84,
      "date": "2026-07-06T00:00:00.000Z",
      "high": 64700,
      "open": 63650.01,
      "close": 64042.02,
      "openTime": 1783296000000,
      "closeTime": 1783382399999,
      "tradeCount": 3777895,
      "volumeBase": 21435.28437,
      "volumeQuote": 1347956046.4032269
    },
    {
      "low": 62671.39,
      "date": "2026-07-07T00:00:00.000Z",
      "high": 64314,
      "open": 64042.93,
      "close": 63363.99,
      "openTime": 1783382400000,
      "closeTime": 1783468799999,
      "tradeCount": 3282102,
      "volumeBase": 16834.20823,
      "volumeQuote": 1069267686.8886092
    },
    {
      "low": 61544.56,
      "date": "2026-07-08T00:00:00.000Z",
      "high": 63761.99,
      "open": 63364,
      "close": 62290,
      "openTime": 1783468800000,
      "closeTime": 1783555199999,
      "tradeCount": 3598487,
      "volumeBase": 18620.09796,
      "volumeQuote": 1160087170.620036
    },
    {
      "low": 61705.29,
      "date": "2026-07-09T00:00:00.000Z",
      "high": 63500,
      "open": 62290.01,
      "close": 63230,
      "openTime": 1783555200000,
      "closeTime": 1783641599999,
      "tradeCount": 3176050,
      "volumeBase": 16742.80672,
      "volumeQuote": 1050849813.269484
    },
    {
      "low": 62926.01,
      "date": "2026-07-10T00:00:00.000Z",
      "high": 64692.83,
      "open": 63230.01,
      "close": 64161.72,
      "openTime": 1783641600000,
      "closeTime": 1783727999999,
      "tradeCount": 2927425,
      "volumeBase": 17589.00122,
      "volumeQuote": 1126097961.002051
    },
    {
      "low": 63819,
      "date": "2026-07-11T00:00:00.000Z",
      "high": 64504.11,
      "open": 64161.72,
      "close": 63819,
      "openTime": 1783728000000,
      "closeTime": 1783814399999,
      "tradeCount": 1406178,
      "volumeBase": 9151.97432,
      "volumeQuote": 587469874.5668087
    }
  ],
  "exchange": "binance",
  "interval": "1d"
}
```

---

### Order book

Resting bids and asks for one spot pair.

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

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `symbol` | string | query | yes | Trading pair. Accepts BTCUSDT, BTC/USDT or btc_usdt |
| `limit` | number | query | no | Levels per side. Default 50, max 500 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:binance/depth?symbol=BTCUSDT&limit=50" \
  -H "x-api-key: YOUR_API_KEY"
```

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

**Example response:**
```json
{
  "asks": [
    {
      "price": 62992,
      "amount": 2.41343
    },
    {
      "price": 62992.01,
      "amount": 0.00142
    },
    {
      "price": 62992.02,
      "amount": 0.00016
    },
    {
      "price": 62992.08,
      "amount": 0.00008
    },
    {
      "price": 62992.74,
      "amount": 0.00008
    },
    {
      "price": 62992.8,
      "amount": 0.00018
    },
    {
      "price": 62992.81,
      "amount": 0.05142
    },
    {
      "price": 62992.82,
      "amount": 0.17044
    }
  ],
  "bids": [
    {
      "price": 62991.99,
      "amount": 6.46597
    },
    {
      "price": 62991.98,
      "amount": 0.00016
    },
    {
      "price": 62991.97,
      "amount": 0.00016
    },
    {
      "price": 62991.44,
      "amount": 0.004
    },
    {
      "price": 62991.32,
      "amount": 0.00018
    },
    {
      "price": 62991.31,
      "amount": 0.04207
    },
    {
      "price": 62991.29,
      "amount": 0.00018
    },
    {
      "price": 62991.28,
      "amount": 0.16704
    }
  ],
  "spread": 0.01,
  "symbol": "BTCUSDT",
  "askCount": 10,
  "bidCount": 10,
  "exchange": "binance"
}
```

---


_Generated: 2026-08-02T14:22:51.405Z_