# Blockchain Info — Zapi reference

> One named on-chain time series from blockchain.info's chart API.

**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/blockchain-info
- 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

---

## Blockchain Info

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

One named on-chain time series from blockchain.info's chart API.

**Tags:** finance, blockchain-info

### Chart

One named on-chain time series from blockchain.info's chart API.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:blockchain-info/chart`
- **Cache TTL:** 900s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `chart` | enum(mempool-size|mempool-count|mempool-growth|transactions-per-second|utxo-count|avg-confirmation-time|median-confirmation-time|market-price|market-cap|trade-volume|total-bitcoins|avg-block-size|blocks-size|n-transactions|n-transactions-total|n-transactions-per-block|n-transactions-excluding-popular|n-unique-addresses|hash-rate|difficulty|miners-revenue|transaction-fees|transaction-fees-usd|cost-per-transaction|cost-per-transaction-percent|output-volume|estimated-transaction-volume|estimated-transaction-volume-usd|my-wallet-n-users) | query | no | Chart name. mempool-size, mempool-count, mempool-growth and transactions-per-second publish every 15 minutes; utxo-count hourly; avg-confirmation-time every 6 hours; the rest daily. |
| `timespan` | string | query | no | Window as Ndays, Nweeks, Nyears, Nhours or all. Upstream default is 1 week for mempool charts, 1 year elsewhere. |
| `start` | string | query | no | Start date (YYYY-MM-DD). Combine with timespan to window the series. |
| `rollingAverage` | string | query | no | Average each point over this duration. Same grammar as timespan. |
| `sampled` | enum(true|false) | query | no | true downsamples to ~1500 points. Default false, which returns full resolution. |
| `limit` | number | query | no | Keep only the most recent N points. Omit for everything the upstream returned. |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:blockchain-info/chart?chart=transactions-per-second&timespan=30days&start=2026-06-01&rollingAverage=8hours&sampled=false&limit=5000" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:blockchain-info/chart?chart=transactions-per-second&timespan=30days&start=2026-06-01&rollingAverage=8hours&sampled=false&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:blockchain-info/chart?chart=transactions-per-second&timespan=30days&start=2026-06-01&rollingAverage=8hours&sampled=false&limit=5000",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "unit": "Transactions Per Second",
  "chart": "transactions-per-second",
  "count": 668,
  "items": [
    {
      "date": "2026-08-14T02:30:00.000Z",
      "time": 1786674600,
      "value": 4.45
    },
    {
      "date": "2026-08-14T02:45:00.000Z",
      "time": 1786675500,
      "value": 3.066666666666667
    },
    {
      "date": "2026-08-14T03:00:00.000Z",
      "time": 1786676400,
      "value": 4.733333333333333
    },
    {
      "date": "2026-08-14T03:15:00.000Z",
      "time": 1786677300,
      "value": 2.2333333333333334
    },
    {
      "date": "2026-08-14T03:30:00.000Z",
      "time": 1786678200,
      "value": 3.7666666666666666
    },
    {
      "date": "2026-08-14T03:45:00.000Z",
      "time": 1786679100,
      "value": 6.033333333333333
    },
    {
      "date": "2026-08-14T04:00:00.000Z",
      "time": 1786680000,
      "value": 5.416666666666667
    },
    {
      "date": "2026-08-14T04:15:00.000Z",
      "time": 1786680900,
      "value": 23.6
    }
  ],
  "total": 668,
  "period": "minute",
  "dataset": "chart",
  "sampled": false,
  "provider": "blockchain-info",
  "timespan": null,
  "description": "The number of Bitcoin transactions added to the mempool per second."
}
```

---

### Stats

Current Bitcoin network snapshot — 20 fields, one flat object, no list.

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

**Parameters:**

_No parameters._

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:blockchain-info/stats" \
  -H "x-api-key: YOUR_API_KEY"
```

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

**Example response:**
```json
{
  "date": "2026-08-21T02:22:44.000Z",
  "time": 1787278964,
  "dataset": "stats",
  "txCount": 534117,
  "btcMined": 41875000000,
  "hashRate": 849165771849.8738,
  "provider": "blockchain-info",
  "totalBtc": 2007305000000000,
  "blocksSize": 220380617,
  "difficulty": 127479855693691,
  "blocksMined": 134,
  "blocksTotal": 963376,
  "totalBtcSent": 123512756825852,
  "totalFeesBtc": -41875000000,
  "marketPriceUsd": 73774.99,
  "tradeVolumeBtc": 9765.02,
  "tradeVolumeUsd": 720414252.8498001,
  "estimatedBtcSent": 16173449886814,
  "minersRevenueBtc": 0,
  "minersRevenueUsd": 0,
  "nextRetargetHeight": 963647,
  "minutesBetweenBlocks": 10.1729,
  "estimatedTransactionVolumeUsd": 11931961036.652044
}
```

---


_Generated: 2026-08-21T07:41:52.761Z_