Discovery and markets API

Bitcoin on-chain metrics brief: a holder metric in a few points

One metric (holder supply, realized price, SOPR, NUPL, reserve risk and more) in at most 60 points.

GET/api/external/discovery/bitcoin-onchain-metrics-brief

Get a free API key Try it in the API reference

What it returns

The brief of bitcoin-onchain-metrics; prefer it unless you need every day. The same metric and window, with the daily series thinned to at most 60 points evenly spaced over it, the first and the newest closed day always kept, each exactly as bitcoin-onchain-metrics lists it. A day between two listed points is not shown: ask the full endpoint for it.

Chains

This endpoint is not tied to a chain: it takes no chain in its request.

Request

Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.

curl -H "x-dex-data-key: $DEXDATA_API_KEY" \
  "https://api.dexdata.io/api/external/discovery/bitcoin-onchain-metrics-brief?metric=active-addresses"

Parameters
Parameter	Description
`metric` query · string · required	The metric.`active-addressesnew-addresseslong-term-holder-supplyshort-term-holder-supplylth-realized-pricesth-realized-pricelth-soprsth-soprnuplreserve-riskrhodl-ratio`
`days` query · string · optional	Trailing window in days back from the newest point, or `all`. Defaults to 365.`30903651825all`

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of Bitcoin on-chain metrics brief: a holder metric in a few points
Field	Type	Description
`metric`	string	The metric answered.
`days`	string	The window answered.
`valueNames`	string[]	The keys of every point's `values`, in order.
`pointCount`	integer	Daily points in the full series over the window.
`points`	object[]	At most 60 of the series' points, evenly spaced over the window, oldest first; the first and the newest are always kept.
`points[].timestamp`	integer	Unix seconds, 00:00 UTC of the day.
`points[].priceUsd`	number \| null	Bitcoin's USD price that day.
`points[].values`	object	The figure that day, keyed by `valueNames`; `null` where there is none.

Price per call

Every call: 6 credits

Charged only when the call succeeds. Prices as of 2026-10-30; the current ones are always in the API reference.

What do Bitcoin's on-chain holder and address metrics say?
The full answer this one condenses
Where is Bitcoin in its market cycle by the standard valuation models?
The price-based cycle models over the same days.
How many market-cycle top indicators are flashing right now?
About 30 cycle-top indicators (MVRV, Pi cycle, Puell, NUPL, Mayer, dominance and more), each with its reading, the level that marks a top, and whether it is hit now.
Is the crypto market greedy or fearful, and is it altcoin season?
Crypto fear and greed index, altcoin season index, bitcoin dominance and the US exchange premium as daily series over 30, 90 or 365 days or all history.
What is bitcoin, or one US dollar, worth in each currency right now?
Rates per BTC and per USD for 59 fiat currencies, 14 crypto units and gold and silver: convert any USD price into euros, yen, sats or ounces of gold.
Which macro releases (CPI, jobs, GDP, rates) are due or just out?
Economic calendar for the next or last seven days: CPI, payrolls, GDP, PMIs and rate decisions with forecast, previous and actual, filtered by importance or country.

Start building with DexData today

Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.

Get a free API key