# CoinMetrics — Zapi reference

> On-chain Bitcoin valuation metrics from the CoinMetrics Community API: realtime MVRV (Market Value to Realized Value), realized cap and daily history.

**Base URL:** `https://api.zapi.ink`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zapi.ink/dashboard/keys.
**Response envelope:** success `{ project, data, timestamp }` (`data` is the payload); errors `{ content, message, errors }`
**Rate limit:** free tier 100 req/min and 600 req/month; paid plans at https://zapi.ink/pricing.

**Related:**
- Detail page: https://zapi.ink/api/finance/coinmetrics
- Category in the catalog: https://zapi.ink/?cat=finance
- Category reference: https://zapi.ink/category/finance/llms.txt
- Concise index: https://zapi.ink/llms.txt
- Full reference: https://zapi.ink/llms-full.txt

---

## CoinMetrics

**Category:** finance · **Slug:** `coinmetrics`
**Detail page:** https://zapi.ink/api/finance/coinmetrics

On-chain Bitcoin valuation metrics from the CoinMetrics Community API: realtime MVRV (Market Value to Realized Value), realized cap and daily history.

**Tags:** finance, crypto, bitcoin, on-chain, coinmetrics

### Bitcoin MVRV (Realtime)

Bitcoin MVRV (Market Value to Realized Value) from CoinMetrics: realtime value that follows the live BTC price (updated every few seconds), market cap, realized cap, valuation zone, plus the latest official daily MVRV and up to 365 days of daily history.

- **Method:** `GET`
- **Endpoint:** `https://api.zapi.ink/v1/finance:coinmetrics/mvrv`
- **Cache TTL:** 15s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `days` | number | query | no | Number of daily MVRV values in `history` (newest last). Default 30, max 365 |

**cURL:**
```bash
curl "https://api.zapi.ink/v1/finance:coinmetrics/mvrv?days=30" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zapi.ink/v1/finance:coinmetrics/mvrv?days=30", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zapi.ink/v1/finance:coinmetrics/mvrv?days=30",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

---


_Generated: 2026-10-26T11:07:51.834Z_