Skip to main content
Loading market data…
GET/api/v1/on-chain/{asset}/active-addressesHobbyist tier+ · 30 req/min

Daily unique active addresses (sender or receiver) — CoinMetrics `AdrActCnt`.

Count of unique addresses that appeared as either sender or receiver in the 24h window. A clean proxy for on-chain usage. Available for every asset the CoinMetrics poller covers; empty series is a valid 200 for anything else.

Path parameters

Segments of the URL path, validated server-side.

NameTypeRequiredDefaultDescription
assetstringrequired
Short alphabetic asset code.

Query parameters

All query parameters are optional unless marked required.

NameTypeRequiredDefaultDescription
daysnumberoptional365
History window. Max 730.

Response shape

Always wrapped in the standard envelope. Nullable fields are explicitly marked — treat missing numeric data as a real data-source gap, not as an error.

data payloadtypescript
// Wrapped in the standard envelope:
// {
//   data: /* shape below */,
//   meta?: { total?: number; limit?: number; offset?: number; ... }
// }

{
  asset: string;
  days: number;
  metric: "AdrActCnt";
  points: Array<{ ts: number; value: number }>;
}

Example

Copy the curl, replace YOUR_KEY with a real key from your dashboard, and run.

Requestbash
curl -sS "http://localhost:3000/api/v1/on-chain/BTC/active-addresses?days=90"
Responsejson
{
  "data": {
    "asset": "BTC",
    "days": 90,
    "metric": "AdrActCnt",
    "points": [ { "ts": 1744761600000, "value": 905210 } ]
  },
  "meta": { "total": 1, "days": 90 }
}

Next

Check the error code reference, or get an API key to try the request against your own account.