On-Chain API

All On-Chain Metrics

477 metrics across 71 supported assets, generated from the same manifests used by the API.

Reset
477 endpoints, catalog 927ed17c749a5e0cPage 1 of 10
1yprolegacy

Legacy V1 compatibility path. Production historically returned 'supply-1yr-plus' for this endpoint; use the canonical replacement for new integrations.

On-Chain Metrics
GET /api/v1/onchain/1yTry in Playground

Canonical replacement: /api/v1/onchain/supply-1yr-plus

Response fields

block_height: number?btc_price: number?date: string?formattedDate: string?hodl_wave_realized_cap_pct_band_0: number?hodl_wave_realized_cap_pct_band_1: number?hodl_wave_realized_cap_pct_band_10: number?hodl_wave_realized_cap_pct_band_11: number?hodl_wave_realized_cap_pct_band_2: number?hodl_wave_realized_cap_pct_band_3: number?hodl_wave_realized_cap_pct_band_4: number?hodl_wave_realized_cap_pct_band_5: number?hodl_wave_realized_cap_pct_band_6: number?hodl_wave_realized_cap_pct_band_7: number?hodl_wave_realized_cap_pct_band_8: number?hodl_wave_realized_cap_pct_band_9: number?hodl_wave_supply_pct_band_0: number?hodl_wave_supply_pct_band_1: number?hodl_wave_supply_pct_band_10: number?hodl_wave_supply_pct_band_11: number?hodl_wave_supply_pct_band_2: number?hodl_wave_supply_pct_band_3: number?hodl_wave_supply_pct_band_4: number?hodl_wave_supply_pct_band_5: number?hodl_wave_supply_pct_band_6: number?hodl_wave_supply_pct_band_7: number?hodl_wave_supply_pct_band_8: number?hodl_wave_supply_pct_band_9: number?price: number?supply_1yr_plus: number?supply_1yr_plus_btc: number?supply_1yr_plus_change: number?supply_1yr_plus_change_negative: number?supply_1yr_plus_change_positive: number?supply_1yr_plus_pct: number?supply_less_1yr: number?supply_less_1yr_pct: number?timestamp: integer?ledger_index: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
a2vrpro

A2vr

On-Chain Metrics
GET /api/v1/onchain/a2vrTry in Playground

Response fields

a2vr: number?a2vr_momentum: number?a2vr_momentum_positive: number?a2vr_sma: number?block_height: number?btc_price: number?coinblocks_created: number?coinblocks_destroyed: number?cumulative_coinblocks_created: number?cumulative_coinblocks_destroyed: number?date: string?formattedDate: string?liveliness: number?price: number?timestamp: integer?vaultedness: number?ledger_index: number?active: number?ratio: number?vaulted: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
a2vr-mompro

A2vr Mom

On-Chain Metrics
GET /api/v1/onchain/a2vr-mom?chain=hyperliquidTry in Playground

Response fields

a2vr_mom: number?btc_price: number?date: string?price: number?timestamp: integer?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
a2vr-momentumpro

A2vr Momentum

On-Chain Metrics
GET /api/v1/onchain/a2vr-momentumTry in Playground

Response fields

a2vr: number?a2vr_momentum: number?a2vr_momentum_negative: number?a2vr_momentum_positive: number?a2vr_sma: number?a2vr_sma_30: number?a2vr_sma_365: number?block_height: number?btc_price: number?coinblocks_created: number?coinblocks_destroyed: number?cumulative_coinblocks_created: number?cumulative_coinblocks_destroyed: number?date: string?formattedDate: string?liveliness: number?price: number?timestamp: integer?vaultedness: number?ledger_index: number?momentum: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
a2vr-sma30pro

A2vr Sma30

On-Chain Metrics
GET /api/v1/onchain/a2vr-sma30?chain=hyperliquidTry in Playground

Response fields

a2vr_sma30: number?btc_price: number?date: string?price: number?timestamp: integer?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
accumulation-indexpro

Accumulation Index

On-Chain Metrics
GET /api/v1/onchain/accumulation-indexTry in Playground

Response fields

block_height: number?btc_price: number?date: string?formattedDate: string?overall_score: number?overall_score_amvrv: number?score_100to1kbtc: number?score_100to1kbtc_amvrv: number?score_10to100btc: number?score_10to100btc_amvrv: number?score_1kto10kbtc: number?score_1kto10kbtc_amvrv: number?score_1to10btc: number?score_1to10btc_amvrv: number?score_above10kbtc: number?score_above10kbtc_amvrv: number?score_amvrv_weighted: number?score_lth_weighted: number?score_sopr_filtered: number?score_sub1btc: number?score_sub1btc_amvrv: number?score_wealth_blend: number?timestamp: integer?price: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
acddpro

Acdd

On-Chain Metrics
GET /api/v1/onchain/acddTry in Playground

Response fields

acdd: number?acdd_oscillator: number?acdd_sma90: number?block_height: number?btc_price: number?cdd: number?circulating_supply_btc: number?coin_days_destroyed: number?cumulative_value_days_destroyed: number?cumulative_vdd: number?date: string?formattedDate: string?price: number?supply_adjusted_cdd: number?timestamp: integer?value_days_destroyed: number?value_days_destroyed_usd: number?vdd: number?vdd_usd: number?ledger_index: number?adjusted: number?cum_cdd: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
acdd-sma90pro

Acdd Sma90

On-Chain Metrics
GET /api/v1/onchain/acdd-sma90?chain=hyperliquidTry in Playground

Response fields

acdd_sma90: number?btc_price: number?date: string?price: number?timestamp: integer?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
active-addressespro

Active Addresses

On-Chain Metrics
GET /api/v1/onchain/active-addressesTry in Playground

Response fields

active_addresses: number?block_height: number?btc_price: number?date: string?formattedDate: string?price: number?receiving: number?sending: number?timestamp: integer?active_addresses_30d_sma: number?active_addresses_7d_sma: number?ledger_index: number?receiving_addresses: number?sending_addresses: number?total_addresses: number?active_addresses_proxy_tx_count: number?tx_count: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
active-addresses-todaypro

Active Addresses Today

On-Chain Metrics
GET /api/v1/onchain/active-addresses-today?chain=hyperliquidTry in Playground

Response fields

active_addresses_today: number?btc_price: number?date: string?price: number?timestamp: integer?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
active-mvrvpro

Active Mvrv

On-Chain Metrics
GET /api/v1/onchain/active-mvrvTry in Playground

Response fields

active_market_cap: number?active_mvrv: number?active_mvrv_0sigma_price: number?active_realized_cap: number?active_realized_price: number?active_supply_btc: number?aviv_nupl: number?aviv_ratio: number?block_height: number?btc_price: number?circulating_supply_btc: number?cointime_price: number?date: string?formattedDate: string?investor_cap: number?liveliness: number?market_cap: number?mvrv_ratio: number?nupl: number?price: number?realized_cap: number?supply_in_loss_btc: number?supply_in_profit_btc: number?thermocap: number?timestamp: integer?true_market_mean_price: number?vaulted_price: number?vaulted_supply_btc: number?vaultedness: number?ledger_index: number?4year_average: number?4year_minus_1_sigma: number?4year_minus_2_sigma: number?4year_plus_1_sigma: number?4year_plus_2_sigma: number?alltime_average: number?alltime_minus_1_sigma: number?alltime_minus_2_sigma: number?alltime_plus_1_sigma: number?alltime_plus_2_sigma: number?lth_mvrv: number?market_cap_usd: number?mvrv: number?mvrv_0sigma_price: number?mvrv_minus_1sigma_price: number?mvrv_plus_1sigma_price: number?realized_cap_usd: number?realized_price: number?sth_mvrv: number?z_score: number?mvrv_4year_average: number?mvrv_4year_minus_sigma: number?mvrv_4year_plus_sigma: number?mvrv_alltime_average: number?mvrv_alltime_minus_sigma: number?mvrv_alltime_plus_sigma: number?mvrv_mean: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
active-mvrv-normpro

Active Mvrv Norm

On-Chain Metrics
GET /api/v1/onchain/active-mvrv-normTry in Playground

Response fields

active_mvrv: number?active_mvrv_norm: number?amvrv_norm: number?amvrv_norm_pct: number?block_height: number?btc_price: number?date: string?formattedDate: string?price: number?timestamp: integer?active_realized_price: number?ledger_index: number?norm_4year_average: number?norm_4year_minus_sigma: number?norm_4year_plus_sigma: number?norm_alltime_average: number?norm_alltime_minus_sigma: number?norm_alltime_plus_sigma: number?active_mvrv_0sigma_price: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
active-supplypro

Active Supply

On-Chain Metrics
GET /api/v1/onchain/active-supply?chain=xrpTry in Playground

Response fields

active_supply: number?btc_price: number?date: string?formattedDate: string?ledger_index: number?price: number?timestamp: integer?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
active-supply-profit-losspro

Active Supply Profit Loss

On-Chain Metrics
GET /api/v1/onchain/active-supply-profit-lossTry in Playground

Response fields

active_supply: number?active_supply_in_loss: number?active_supply_in_profit: number?block_height: number?btc_in_loss: number?btc_in_profit: number?btc_price: number?date: string?formattedDate: string?pct_active_in_loss: number?pct_active_in_profit: number?percent_btc_in_loss: number?percent_btc_in_profit: number?price: number?supply_in_loss_btc: number?supply_in_loss_percent: number?supply_in_profit_btc: number?supply_in_profit_percent: number?timestamp: integer?active_supply_profit_loss: number?ledger_index: number?abs_loss: number?abs_profit: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
active-supply-skewpro

Active Supply Skew

On-Chain Metrics
GET /api/v1/onchain/active-supply-skew?chain=ethereumTry in Playground

Response fields

active_supply: number?active_supply_skew: number?aviv_norm: number?circulating_supply: number?mvrv_norm: number?btc_price: number?date: string?formattedDate: string?ledger_index: number?price: number?timestamp: integer?block_height: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
active-vaulted-profit-losspro

Active Vaulted Profit Loss

On-Chain Metrics
GET /api/v1/onchain/active-vaulted-profit-lossTry in Playground

Response fields

active_supply_btc: number?block_height: number?btc_in_loss: number?btc_in_profit: number?btc_price: number?date: string?formattedDate: string?percent_btc_in_loss: number?percent_btc_in_profit: number?price: number?supply_in_loss_btc: number?supply_in_loss_percent: number?supply_in_profit_btc: number?supply_in_profit_percent: number?timestamp: integer?vaulted_supply_btc: number?active_supply_in_loss: number?active_supply_in_profit: number?ledger_index: number?vaulted_supply_in_loss: number?vaulted_supply_in_profit: number?active_supply_ltc: number?vaulted_supply_ltc: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
addr-count-heatmappro

Addr Count Heatmap

On-Chain Metrics
GET /api/v1/onchain/addr-count-heatmapTry in Playground

Response fields

btc_price: number?buckets: number?date: string?formattedDate: string?timestamp: integer?block_height: number?price: number?bucket_prices: number?scale: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
addr-count-heatmap-by-agepro

Addr Count Heatmap By Age

On-Chain Metrics
GET /api/v1/onchain/addr-count-heatmap-by-ageTry in Playground

Response fields

btc_price: number?by_age: number?date: string?formattedDate: string?timestamp: integer?block_height: number?price: number?bucket_prices: number?buckets: number?scale: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
addr-count-heatmap-lthpro

Addr Count Heatmap Lth

On-Chain Metrics
GET /api/v1/onchain/addr-count-heatmap-lthTry in Playground

Response fields

btc_price: number?buckets: number?date: string?formattedDate: string?timestamp: integer?block_height: number?price: number?bucket_prices: number?scale: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
addr-count-heatmap-sthpro

Addr Count Heatmap Sth

On-Chain Metrics
GET /api/v1/onchain/addr-count-heatmap-sthTry in Playground

Response fields

btc_price: number?buckets: number?date: string?formattedDate: string?timestamp: integer?block_height: number?price: number?bucket_prices: number?scale: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
address-reusepro

Address Reuse

On-Chain Metrics
GET /api/v1/onchain/address-reuseTry in Playground

Response fields

date: string?formattedDate: string?input_respend_percent: number?input_reuse_percent: number?output_respend_percent: number?output_reuse_percent: number?price: number?timestamp: integer?block_height: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
addresses-in-losspro

Addresses In Loss

On-Chain Metrics
GET /api/v1/onchain/addresses-in-loss?chain=xrpTry in Playground

Response fields

addresses_in_loss: number?btc_price: number?date: string?formattedDate: string?ledger_index: number?price: number?timestamp: integer?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
addresses-in-profitpro

Addresses In Profit

On-Chain Metrics
GET /api/v1/onchain/addresses-in-profit?chain=xrpTry in Playground

Response fields

addresses_in_profit: number?btc_price: number?date: string?formattedDate: string?ledger_index: number?price: number?timestamp: integer?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
adjusted-soprprolegacy

Legacy V1 compatibility path. Production historically returned 'sopr' for this endpoint; use the canonical replacement for new integrations.

On-Chain Metrics
GET /api/v1/onchain/adjusted-soprTry in Playground

Canonical replacement: /api/v1/onchain/sopr

Response fields

adjusted_sopr: number?asopr: number?asopr_sma7: number?btc_price: number?date: string?formattedDate: string?lth_sopr: number?price: number?realized_loss_usd: number?realized_profit_usd: number?sopr: number?sopr_sma7: number?spent_outputs: number?spent_value_usd: number?sth_sopr: number?timestamp: integer?ledger_index: number?block_height: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
age-band-profit-losspro

Age Band Profit Loss

On-Chain Metrics
GET /api/v1/onchain/age-band-profit-lossTry in Playground

Response fields

<1d_loss_usd: number?<1d_profit_usd: number?10y+_loss_usd: number?10y+_profit_usd: number?1d-1w_loss_usd: number?1d-1w_profit_usd: number?1m-3m_loss_usd: number?1m-3m_profit_usd: number?1w-1m_loss_usd: number?1w-1m_profit_usd: number?1y-2y_loss_usd: number?1y-2y_profit_usd: number?2y-3y_loss_usd: number?2y-3y_profit_usd: number?3m-6m_loss_usd: number?3m-6m_profit_usd: number?3y-5y_loss_usd: number?3y-5y_profit_usd: number?5y-7y_loss_usd: number?5y-7y_profit_usd: number?6m-1y_loss_usd: number?6m-1y_profit_usd: number?7y-10y_loss_usd: number?7y-10y_profit_usd: number?age_bands: number?band_0_loss_btc: number?band_0_loss_usd: number?band_0_net_btc: number?band_0_net_usd: number?band_0_profit_btc: number?band_0_profit_usd: number?band_1_loss_btc: number?band_1_loss_usd: number?band_1_net_btc: number?band_1_net_usd: number?band_1_profit_btc: number?band_1_profit_usd: number?band_10_loss_btc: number?band_10_loss_usd: number?band_10_net_btc: number?band_10_net_usd: number?band_10_profit_btc: number?band_10_profit_usd: number?band_11_loss_btc: number?band_11_loss_usd: number?band_11_net_btc: number?band_11_net_usd: number?band_11_profit_btc: number?band_11_profit_usd: number?band_2_loss_btc: number?band_2_loss_usd: number?band_2_net_btc: number?band_2_net_usd: number?band_2_profit_btc: number?band_2_profit_usd: number?band_3_loss_btc: number?band_3_loss_usd: number?band_3_net_btc: number?band_3_net_usd: number?band_3_profit_btc: number?band_3_profit_usd: number?band_4_loss_btc: number?band_4_loss_usd: number?band_4_net_btc: number?band_4_net_usd: number?band_4_profit_btc: number?band_4_profit_usd: number?band_5_loss_btc: number?band_5_loss_usd: number?band_5_net_btc: number?band_5_net_usd: number?band_5_profit_btc: number?band_5_profit_usd: number?band_6_loss_btc: number?band_6_loss_usd: number?band_6_net_btc: number?band_6_net_usd: number?band_6_profit_btc: number?band_6_profit_usd: number?band_7_loss_btc: number?band_7_loss_usd: number?band_7_net_btc: number?band_7_net_usd: number?band_7_profit_btc: number?band_7_profit_usd: number?band_8_loss_btc: number?band_8_loss_usd: number?band_8_net_btc: number?band_8_net_usd: number?band_8_profit_btc: number?band_8_profit_usd: number?band_9_loss_btc: number?band_9_loss_usd: number?band_9_net_btc: number?band_9_net_usd: number?band_9_profit_btc: number?band_9_profit_usd: number?block_height: number?btc_price: number?date: string?formattedDate: string?timestamp: integer?band_0_loss: number?band_0_net: number?band_0_profit: number?band_1_loss: number?band_1_net: number?band_1_profit: number?band_2_loss: number?band_2_net: number?band_2_profit: number?band_3_loss: number?band_3_net: number?band_3_profit: number?band_4_loss: number?band_4_net: number?band_4_profit: number?band_5_loss: number?band_5_net: number?band_5_profit: number?band_6_loss: number?band_6_net: number?band_6_profit: number?band_7_loss: number?band_7_net: number?band_7_profit: number?band_8_loss: number?band_8_net: number?band_8_profit: number?band_9_loss: number?band_9_net: number?band_9_profit: number?price: number?btc_in_loss: number?btc_in_profit: number?current_supply: number?percent_btc_in_loss: number?percent_btc_in_profit: number?supply_in_loss_btc: number?supply_in_loss_pct: number?supply_in_loss_percent: number?supply_in_profit_btc: number?supply_in_profit_pct: number?supply_in_profit_percent: number?circulating_supply_btc: number?ledger_index: number?profit_loss: number?abs_loss: number?abs_profit: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
age-band-soprprolegacy

Legacy V1 compatibility path. Production historically returned 'sopr' for this endpoint; use the canonical replacement for new integrations.

On-Chain Metrics
GET /api/v1/onchain/age-band-soprTry in Playground

Canonical replacement: /api/v1/onchain/sopr

Response fields

adjusted_sopr: number?asopr: number?asopr_sma7: number?btc_price: number?date: string?formattedDate: string?lth_sopr: number?price: number?realized_loss_usd: number?realized_profit_usd: number?sopr: number?sopr_sma7: number?spent_outputs: number?spent_value_usd: number?sth_sopr: number?timestamp: integer?ledger_index: number?block_height: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
age-bandspro

Age Bands

On-Chain Metrics
GET /api/v1/onchain/age-bandsTry in Playground

Response fields

block_height: number?btc_price: number?date: string?formattedDate: string?hodl_wave_realized_cap_pct_band_0: number?hodl_wave_realized_cap_pct_band_1: number?hodl_wave_realized_cap_pct_band_10: number?hodl_wave_realized_cap_pct_band_11: number?hodl_wave_realized_cap_pct_band_2: number?hodl_wave_realized_cap_pct_band_3: number?hodl_wave_realized_cap_pct_band_4: number?hodl_wave_realized_cap_pct_band_5: number?hodl_wave_realized_cap_pct_band_6: number?hodl_wave_realized_cap_pct_band_7: number?hodl_wave_realized_cap_pct_band_8: number?hodl_wave_realized_cap_pct_band_9: number?hodl_wave_supply_pct_band_0: number?hodl_wave_supply_pct_band_1: number?hodl_wave_supply_pct_band_10: number?hodl_wave_supply_pct_band_11: number?hodl_wave_supply_pct_band_2: number?hodl_wave_supply_pct_band_3: number?hodl_wave_supply_pct_band_4: number?hodl_wave_supply_pct_band_5: number?hodl_wave_supply_pct_band_6: number?hodl_wave_supply_pct_band_7: number?hodl_wave_supply_pct_band_8: number?hodl_wave_supply_pct_band_9: number?lth_cost_basis: number?realized_pl: number?realized_price: number?revived_supply: number?rp_0_1d: number?rp_10y_plus: number?rp_1d_1w: number?rp_1m_3m: number?rp_1w_1m: number?rp_1y_2y: number?rp_2y_3y: number?rp_3m_6m: number?rp_3y_5y: number?rp_5y_7y: number?rp_6m_1y: number?rp_7y_10y: number?sth_cost_basis: number?sw_0_1d: number?sw_10y_plus: number?sw_1d_1w: number?sw_1m_3m: number?sw_1w_1m: number?sw_1y_2y: number?sw_2y_3y: number?sw_3m_6m: number?sw_3y_5y: number?sw_5y_7y: number?sw_6m_1y: number?sw_7y_10y: number?timestamp: integer?revived_10y_plus: number?revived_1y_2y: number?revived_2y_3y: number?revived_3y_5y: number?revived_5y_7y: number?revived_6m_1y: number?revived_7y_10y: number?supply_band_0: number?supply_band_1: number?supply_band_10: number?supply_band_11: number?supply_band_2: number?supply_band_3: number?supply_band_4: number?supply_band_5: number?supply_band_6: number?supply_band_7: number?supply_band_8: number?supply_band_9: number?supply_pct_band_0: number?supply_pct_band_1: number?supply_pct_band_10: number?supply_pct_band_11: number?supply_pct_band_2: number?supply_pct_band_3: number?supply_pct_band_4: number?supply_pct_band_5: number?supply_pct_band_6: number?supply_pct_band_7: number?supply_pct_band_8: number?supply_pct_band_9: number?ledger_index: number?price: number?supply_10y_plus: number?supply_1d_1w: number?supply_1m_3m: number?supply_1w_1m: number?supply_1y_2y: number?supply_24h: number?supply_2y_3y: number?supply_3m_6m: number?supply_3y_5y: number?supply_5y_7y: number?supply_6m_12m: number?supply_7y_10y: number?band_0_label: number?band_10_label: number?band_11_label: number?band_1_label: number?band_2_label: number?band_3_label: number?band_4_label: number?band_5_label: number?band_6_label: number?band_7_label: number?band_8_label: number?band_9_label: number?revived_m6_12m: number?revived_y10_plus: number?revived_y1_2y: number?revived_y2_3y: number?revived_y3_5y: number?revived_y5_7y: number?revived_y7_10y: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
age-cohorts-expandedpro

Age Cohorts Expanded

On-Chain Metrics
GET /api/v1/onchain/age-cohorts-expandedTry in Playground

Response fields

date: string?formattedDate: string?price: number?supply_18m_2y: number?supply_1y_18m: number?supply_6m_9m: number?supply_9m_1y: number?timestamp: integer?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
apparent-demandpro

Apparent Demand

On-Chain Metrics
GET /api/v1/onchain/apparent-demandTry in Playground

Response fields

apparent_demand: number?block_height: number?btc_price: number?cumulative_investor_cap: number?date: string?formattedDate: string?hodl_wave_realized_cap_pct_band_0: number?hodl_wave_realized_cap_pct_band_1: number?hodl_wave_realized_cap_pct_band_10: number?hodl_wave_realized_cap_pct_band_11: number?hodl_wave_realized_cap_pct_band_2: number?hodl_wave_realized_cap_pct_band_3: number?hodl_wave_realized_cap_pct_band_4: number?hodl_wave_realized_cap_pct_band_5: number?hodl_wave_realized_cap_pct_band_6: number?hodl_wave_realized_cap_pct_band_7: number?hodl_wave_realized_cap_pct_band_8: number?hodl_wave_realized_cap_pct_band_9: number?hodl_wave_supply_pct_band_0: number?hodl_wave_supply_pct_band_1: number?hodl_wave_supply_pct_band_10: number?hodl_wave_supply_pct_band_11: number?hodl_wave_supply_pct_band_2: number?hodl_wave_supply_pct_band_3: number?hodl_wave_supply_pct_band_4: number?hodl_wave_supply_pct_band_5: number?hodl_wave_supply_pct_band_6: number?hodl_wave_supply_pct_band_7: number?hodl_wave_supply_pct_band_8: number?hodl_wave_supply_pct_band_9: number?price: number?timestamp: integer?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
asolpro

Asol

On-Chain Metrics
GET /api/v1/onchain/asol?chain=xrpTry in Playground

Response fields

asol: number?btc_price: number?date: string?formattedDate: string?ledger_index: number?price: number?timestamp: integer?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
asoprprolegacy

Legacy V1 compatibility path. Production historically returned 'sopr' for this endpoint; use the canonical replacement for new integrations.

On-Chain Metrics
GET /api/v1/onchain/asoprTry in Playground

Canonical replacement: /api/v1/onchain/sopr

Response fields

adjusted_sopr: number?asopr: number?asopr_sma7: number?btc_price: number?date: string?formattedDate: string?lth_sopr: number?price: number?realized_loss_usd: number?realized_profit_usd: number?sopr: number?sopr_sma7: number?spent_outputs: number?spent_value_usd: number?sth_sopr: number?timestamp: integer?ledger_index: number?block_height: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
avivpro

Aviv

On-Chain Metrics
GET /api/v1/onchain/avivTry in Playground

Response fields

active_cap: number?active_supply_btc: number?aviv: number?aviv_ratio: number?aviv_z_score: number?block_height: number?btc_price: number?cointime_price: number?date: string?formattedDate: string?investor_cap: number?price: number?timestamp: integer?true_market_mean: number?active_realized_price: number?active_supply: number?aviv_sma_30: number?aviv_sma_365: number?ledger_index: number?a2vr: number?active_mvrv: number?aviv_nupl: number?block_count: number?blocks: number?btc_in_loss: number?btc_in_profit: number?circulating_supply_btc: number?coin_days_destroyed: number?coinbase_rewards_btc: number?coinblocks_created: number?coinblocks_destroyed: number?cumulative_coinblocks_created: number?cumulative_coinblocks_destroyed: number?cumulative_investor_cap: number?cumulative_value_days_destroyed: number?cumulative_vdd: number?daily_blocks: number?daily_realized_loss_btc: number?daily_realized_loss_usd: number?daily_realized_profit_btc: number?daily_realized_profit_usd: number?fees_btc: number?investor_cap_usd: number?investor_to_mcap_ratio: number?last_height: number?liveliness: number?lth_btc_in_loss: number?lth_btc_in_profit: number?lth_cost_basis: number?lth_cost_basis_usd: number?lth_mvrv: number?lth_net_position_change: number?lth_percentage: number?lth_realized_cap: number?lth_realized_cap_usd: number?lth_realized_loss_usd: number?lth_realized_price: number?lth_realized_profit_usd: number?lth_rpl_ratio: number?lth_sopr: number?lth_supply: number?lth_supply_btc: number?market_cap: number?market_cap_usd: number?mvrv: number?mvrv_ratio: number?net_realized_pl_usd: number?net_rpl: number?nupl: number?pct_circulating_lth_in_loss: number?pct_circulating_lth_in_profit: number?pct_circulating_sth_in_loss: number?pct_circulating_sth_in_profit: number?pct_lth_in_loss: number?pct_lth_in_profit: number?pct_sth_in_loss: number?pct_sth_in_profit: number?percent_btc_in_loss: number?percent_btc_in_profit: number?realized_cap: number?realized_cap_created: number?realized_cap_destroyed: number?realized_cap_net: number?realized_cap_usd: number?realized_price: number?rpl_ratio: number?spent_outputs: number?sth_btc_in_loss: number?sth_btc_in_profit: number?sth_cost_basis: number?sth_cost_basis_usd: number?sth_mvrv: number?sth_net_position_change: number?sth_percentage: number?sth_realized_cap: number?sth_realized_cap_usd: number?sth_realized_loss_usd: number?sth_realized_price: number?sth_realized_profit_usd: number?sth_rpl_ratio: number?sth_sopr: number?sth_supply: number?sth_supply_btc: number?supply_btc: number?supply_in_loss_btc: number?supply_in_loss_percent: number?supply_in_profit_btc: number?supply_in_profit_percent: number?thermocap: number?total_fees_btc: number?true_market_mean_price: number?tx_count: number?utxos_created: number?utxos_spent: number?value_days_destroyed: number?value_days_destroyed_usd: number?vaulted_price: number?vaulted_supply_btc: number?vaultedness: number?vdd_usd: number?z_score: number?zero_line: number?active_realized_cap: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
aviv-bandspro

Aviv Bands

On-Chain Metrics
GET /api/v1/onchain/aviv-bandsTry in Playground

Response fields

active_mvrv: number?active_realized_price: number?active_supply_btc: number?aviv: number?aviv_lower_1sd: number?aviv_lower_2sd: number?aviv_mean: number?aviv_nupl: number?aviv_ratio: number?aviv_upper_1sd: number?aviv_upper_2sd: number?block_height: number?btc_price: number?circulating_supply_btc: number?cointime_price: number?date: string?formattedDate: string?investor_cap: number?liveliness: number?market_cap: number?mvrv_ratio: number?nupl: number?price: number?price_at_aviv_mean: number?price_at_aviv_minus_1_sigma: number?price_at_aviv_minus_2_sigma: number?price_at_aviv_plus_1_sigma: number?price_at_aviv_plus_2_sigma: number?price_mean: number?price_minus_1_sigma: number?price_plus_1_sigma: number?realized_cap: number?supply_in_loss_btc: number?supply_in_profit_btc: number?thermocap: number?timestamp: integer?true_market_mean: number?true_market_mean_price: number?vaulted_price: number?vaulted_supply_btc: number?vaultedness: number?ledger_index: number?price_at_aviv_minus_1sigma: number?price_at_aviv_minus_half_sigma: number?price_at_aviv_plus_1sigma: number?price_at_aviv_plus_2sigma: number?price_at_aviv_plus_3sigma: number?price_at_aviv_plus_half_sigma: number?active_realized_cap: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
aviv-meanpro

Aviv Mean

On-Chain Metrics
GET /api/v1/onchain/aviv-mean?chain=hyperliquidTry in Playground

Response fields

aviv_mean: number?btc_price: number?date: string?price: number?timestamp: integer?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
aviv-mompro

Aviv Mom

On-Chain Metrics
GET /api/v1/onchain/aviv-mom?chain=hyperliquidTry in Playground

Response fields

aviv_mom: number?btc_price: number?date: string?price: number?timestamp: integer?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
aviv-momentumpro

Aviv Momentum

On-Chain Metrics
GET /api/v1/onchain/aviv-momentumTry in Playground

Response fields

active_mvrv: number?active_realized_price: number?active_supply_btc: number?aviv_momentum: number?aviv_nupl: number?aviv_ratio: number?aviv_sma_30: number?aviv_sma_365: number?block_height: number?btc_price: number?circulating_supply_btc: number?cointime_price: number?date: string?formattedDate: string?investor_cap: number?liveliness: number?market_cap: number?mvrv_ratio: number?nupl: number?price: number?realized_cap: number?supply_in_loss_btc: number?supply_in_profit_btc: number?thermocap: number?timestamp: integer?true_market_mean_price: number?vaulted_price: number?vaulted_supply_btc: number?vaultedness: number?ledger_index: number?aviv_ratio_momentum_negative: number?aviv_ratio_momentum_positive: number?aviv_ratio_sma: number?momentum: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
aviv-nuplpro

Aviv Nupl

On-Chain Metrics
GET /api/v1/onchain/aviv-nuplTry in Playground

Response fields

active_cap: number?active_realized_price: number?active_supply_btc: number?aviv_nupl: number?aviv_ratio: number?block_height: number?btc_price: number?cumulative_investor_cap: number?date: string?formattedDate: string?price: number?timestamp: integer?ledger_index: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
aviv-sdpro

Aviv Sd

On-Chain Metrics
GET /api/v1/onchain/aviv-sd?chain=hyperliquidTry in Playground

Response fields

aviv_sd: number?btc_price: number?date: string?price: number?timestamp: integer?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
aviv-sma30pro

Aviv Sma30

On-Chain Metrics
GET /api/v1/onchain/aviv-sma30?chain=hyperliquidTry in Playground

Response fields

aviv_sma30: number?btc_price: number?date: string?price: number?timestamp: integer?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
aviv-z-scorepro

Aviv Z Score

On-Chain Metrics
GET /api/v1/onchain/aviv-z-scoreTry in Playground

Response fields

active_mvrv: number?active_realized_price: number?active_supply_btc: number?aviv_nupl: number?aviv_ratio: number?aviv_z_score: number?block_height: number?btc_price: number?circulating_supply_btc: number?cointime_price: number?date: string?formattedDate: string?investor_cap: number?liveliness: number?market_cap: number?mvrv_ratio: number?nupl: number?price: number?realized_cap: number?supply_in_loss_btc: number?supply_in_profit_btc: number?thermocap: number?timestamp: integer?true_market_mean: number?true_market_mean_price: number?vaulted_price: number?vaulted_supply_btc: number?vaultedness: number?ledger_index: number?aviv: number?aviv_all_time_average: number?aviv_lower_band_1: number?aviv_upper_band_2: number?aviv_upper_band_3: number?z_score: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
balance-distributionpro

Balance Distribution

On-Chain Metrics
GET /api/v1/onchain/balance-distributionTry in Playground

Response fields

addr_count_0_001to0_01btc: number?addr_count_0_01to0_1btc: number?addr_count_0_1to1btc: number?addr_count_100to1kbtc: number?addr_count_10kto100kbtc: number?addr_count_10to100btc: number?addr_count_1kto10kbtc: number?addr_count_1to10btc: number?addr_count_above100kbtc: number?addr_count_above10kbtc: number?addr_count_sub0_001btc: number?addr_count_sub1btc: number?addr_pct_0_001to0_01btc: number?addr_pct_0_01to0_1btc: number?addr_pct_0_1to1btc: number?addr_pct_100to1kbtc: number?addr_pct_10kto100kbtc: number?addr_pct_10to100btc: number?addr_pct_1kto10kbtc: number?addr_pct_1to10btc: number?addr_pct_above100kbtc: number?addr_pct_above10kbtc: number?addr_pct_sub0_001btc: number?addr_pct_sub1btc: number?btc_in_0_001to0_01btc: number?btc_in_0_01to0_1btc: number?btc_in_0_1to1btc: number?btc_in_100to1kbtc: number?btc_in_10kto100kbtc: number?btc_in_10to100btc: number?btc_in_1kto10kbtc: number?btc_in_1to10btc: number?btc_in_above100kbtc: number?btc_in_above10kbtc: number?btc_in_sub0_001btc: number?btc_in_sub1btc: number?btc_pct_0_001to0_01btc: number?btc_pct_0_01to0_1btc: number?btc_pct_0_1to1btc: number?btc_pct_100to1kbtc: number?btc_pct_10kto100kbtc: number?btc_pct_10to100btc: number?btc_pct_1kto10kbtc: number?btc_pct_1to10btc: number?btc_pct_above100kbtc: number?btc_pct_above10kbtc: number?btc_pct_sub0_001btc: number?btc_pct_sub1btc: number?btc_price: number?date: string?formattedDate: string?timestamp: integer?total_addresses: number?total_btc: number?addresses_crab: number?addresses_dolphin: number?addresses_fish: number?addresses_humpback: number?addresses_in_loss: number?addresses_in_profit: number?addresses_megalodon: number?addresses_shark: number?addresses_shrimp: number?addresses_whale: number?crab: number?crab_pct: number?fish: number?fish_pct: number?humpback: number?humpback_pct: number?ledger_index: number?megalodon: number?megalodon_pct: number?percent_addresses_in_profit: number?plankton: number?plankton_pct: number?price: number?shark: number?shark_pct: number?shrimp: number?shrimp_pct: number?supply_crab: number?supply_dolphin: number?supply_fish: number?supply_humpback: number?supply_megalodon: number?supply_pct_crab: number?supply_pct_dolphin: number?supply_pct_fish: number?supply_pct_humpback: number?supply_pct_megalodon: number?supply_pct_shark: number?supply_pct_shrimp: number?supply_pct_whale: number?supply_shark: number?supply_shrimp: number?supply_whale: number?whale: number?whale_pct: number?bands: number?crab_btc: number?fish_btc: number?humpback_btc: number?plankton_btc: number?shark_btc: number?shrimp_btc: number?whale_btc: number?band: number?block_height: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
balance-distribution-flowspro

Balance Distribution Flows

On-Chain Metrics
GET /api/v1/onchain/balance-distribution-flowsTry in Playground

Response fields

block_height: number?btc_in_100to1kbtc: number?btc_in_10to100btc: number?btc_in_1kto10kbtc: number?btc_in_1to10btc: number?btc_in_above10kbtc: number?btc_in_sub1btc: number?btc_price: number?date: string?flow_0_001to0_01btc: number?flow_0_01to0_1btc: number?flow_0_1to1btc: number?flow_100to1kbtc: number?flow_10kto100kbtc: number?flow_10to100btc: number?flow_1kto10kbtc: number?flow_1to10btc: number?flow_above100kbtc: number?flow_above10kbtc: number?flow_sub0_001btc: number?flow_sub1btc: number?formattedDate: string?timestamp: integer?addr_count_0_001to0_01btc: number?addr_count_0_01to0_1btc: number?addr_count_0_1to1btc: number?addr_count_100to1kbtc: number?addr_count_10kto100kbtc: number?addr_count_10to100btc: number?addr_count_1kto10kbtc: number?addr_count_1to10btc: number?addr_count_above100kbtc: number?addr_count_above10kbtc: number?addr_count_sub0_001btc: number?addr_count_sub1btc: number?addr_pct_0_001to0_01btc: number?addr_pct_0_01to0_1btc: number?addr_pct_0_1to1btc: number?addr_pct_100to1kbtc: number?addr_pct_10kto100kbtc: number?addr_pct_10to100btc: number?addr_pct_1kto10kbtc: number?addr_pct_1to10btc: number?addr_pct_above100kbtc: number?addr_pct_above10kbtc: number?addr_pct_sub0_001btc: number?addr_pct_sub1btc: number?btc_in_0_001to0_01btc: number?btc_in_0_01to0_1btc: number?btc_in_0_1to1btc: number?btc_in_10kto100kbtc: number?btc_in_above100kbtc: number?btc_in_sub0_001btc: number?btc_pct_0_001to0_01btc: number?btc_pct_0_01to0_1btc: number?btc_pct_0_1to1btc: number?btc_pct_100to1kbtc: number?btc_pct_10kto100kbtc: number?btc_pct_10to100btc: number?btc_pct_1kto10kbtc: number?btc_pct_1to10btc: number?btc_pct_above100kbtc: number?btc_pct_above10kbtc: number?btc_pct_sub0_001btc: number?btc_pct_sub1btc: number?total_addresses: number?total_btc: number?addresses_crab: number?addresses_dolphin: number?addresses_fish: number?addresses_humpback: number?addresses_in_loss: number?addresses_in_profit: number?addresses_megalodon: number?addresses_shark: number?addresses_shrimp: number?addresses_whale: number?crab: number?crab_pct: number?fish: number?fish_pct: number?humpback: number?humpback_pct: number?ledger_index: number?megalodon: number?megalodon_pct: number?percent_addresses_in_profit: number?plankton: number?plankton_pct: number?price: number?shark: number?shark_pct: number?shrimp: number?shrimp_pct: number?supply_crab: number?supply_dolphin: number?supply_fish: number?supply_humpback: number?supply_megalodon: number?supply_pct_crab: number?supply_pct_dolphin: number?supply_pct_fish: number?supply_pct_humpback: number?supply_pct_megalodon: number?supply_pct_shark: number?supply_pct_shrimp: number?supply_pct_whale: number?supply_shark: number?supply_shrimp: number?supply_whale: number?whale: number?whale_pct: number?bands: number?crab_btc: number?fish_btc: number?humpback_btc: number?plankton_btc: number?shark_btc: number?shrimp_btc: number?whale_btc: number?band: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
balanced-pricepro

Balanced Price

On-Chain Metrics
GET /api/v1/onchain/balanced-priceTry in Playground

Response fields

balanced_price: number?block_height: number?btc_price: number?date: string?formattedDate: string?price: number?realized_price: number?timestamp: integer?transferred_price: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
base-fee-burnpro

Base Fee Burn

On-Chain Metrics
GET /api/v1/onchain/base-fee-burn?chain=hyperliquidTry in Playground

Response fields

base_fee_burn_hype: number?btc_price: number?date: string?price: number?timestamp: integer?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
bedrockpro

Bedrock

On-Chain Metrics
GET /api/v1/onchain/bedrockTry in Playground

Response fields

date: string?floor_pct95: number?floor_pct98: number?floor_pct99: number?formattedDate: string?level_pct10: number?level_pct20: number?level_pct50: number?level_pct80: number?level_pct90: number?price: number?timestamp: integer?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
bitcoin-capspro

Bitcoin Caps

On-Chain Metrics
GET /api/v1/onchain/bitcoin-capsTry in Playground

Response fields

active_mvrv: number?active_realized_price: number?active_supply_btc: number?aviv_nupl: number?aviv_ratio: number?block_height: number?btc_price: number?circulating_supply_btc: number?cointime_price: number?cumulative_investor_cap: number?date: string?formattedDate: string?investor_cap: number?investor_cap_usd: number?liveliness: number?lth_cost_basis: number?lth_realized_price: number?market_cap: number?market_cap_usd: number?mvrv_ratio: number?nupl: number?price: number?realized_cap: number?realized_cap_usd: number?sth_cost_basis: number?sth_realized_price: number?supply_in_loss_btc: number?supply_in_profit_btc: number?thermocap: number?thermocap_usd: number?timestamp: integer?true_market_mean_price: number?vaulted_price: number?vaulted_supply_btc: number?vaultedness: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
bitcoin-cycle-indexpro

Bitcoin Cycle Index

On-Chain Metrics
GET /api/v1/onchain/bitcoin-cycle-indexTry in Playground

Response fields

active_mvrv: number?active_realized_price: number?active_supply_btc: number?aviv_nupl: number?aviv_ratio: number?block_height: number?btc_price: number?circulating_supply_btc: number?cointime_price: number?cumulative_investor_cap: number?date: string?formattedDate: string?investor_cap: number?investor_cap_usd: number?liveliness: number?lth_cost_basis: number?lth_realized_price: number?market_cap: number?market_cap_usd: number?mvrv_ratio: number?nupl: number?price: number?realized_cap: number?realized_cap_usd: number?sth_cost_basis: number?sth_realized_price: number?supply_in_loss_btc: number?supply_in_profit_btc: number?thermocap: number?thermocap_usd: number?timestamp: integer?true_market_mean_price: number?vaulted_price: number?vaulted_supply_btc: number?vaultedness: number?a2vr: number?active_cap: number?bitcoin_cycle_index: number?block_count: number?blocks: number?btc_in_loss: number?btc_in_profit: number?coin_days_destroyed: number?coinbase_rewards_btc: number?coinblocks_created: number?coinblocks_destroyed: number?cumulative_coinblocks_created: number?cumulative_coinblocks_destroyed: number?cumulative_value_days_destroyed: number?cumulative_vdd: number?daily_blocks: number?daily_realized_loss_btc: number?daily_realized_loss_usd: number?daily_realized_profit_btc: number?daily_realized_profit_usd: number?fees_btc: number?investor_to_mcap_ratio: number?last_height: number?lth_btc_in_loss: number?lth_btc_in_profit: number?lth_cost_basis_usd: number?lth_mvrv: number?lth_net_position_change: number?lth_percentage: number?lth_realized_cap: number?lth_realized_cap_usd: number?lth_realized_loss_usd: number?lth_realized_profit_usd: number?lth_rpl_ratio: number?lth_sopr: number?lth_supply: number?lth_supply_btc: number?mvrv: number?mvrv_norm: number?net_realized_pl_usd: number?net_rpl: number?nupl_norm: number?pct_circulating_lth_in_loss: number?pct_circulating_lth_in_profit: number?pct_circulating_sth_in_loss: number?pct_circulating_sth_in_profit: number?pct_lth_in_loss: number?pct_lth_in_profit: number?pct_sth_in_loss: number?pct_sth_in_profit: number?percent_btc_in_loss: number?percent_btc_in_profit: number?realized_cap_created: number?realized_cap_destroyed: number?realized_cap_net: number?realized_price: number?rpl_ratio: number?sopr_norm: number?spent_outputs: number?sth_btc_in_loss: number?sth_btc_in_profit: number?sth_cost_basis_usd: number?sth_mvrv: number?sth_net_position_change: number?sth_percentage: number?sth_realized_cap: number?sth_realized_cap_usd: number?sth_realized_loss_usd: number?sth_realized_profit_usd: number?sth_rpl_ratio: number?sth_sopr: number?sth_supply: number?sth_supply_btc: number?supply_btc: number?supply_in_loss_percent: number?supply_in_profit_percent: number?total_fees_btc: number?true_market_mean: number?tx_count: number?utxos_created: number?utxos_spent: number?value_days_destroyed: number?value_days_destroyed_usd: number?vdd_usd: number?z_score: number?zero_line: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
bitcoin-valuation-metricspro

Bitcoin Valuation Metrics

On-Chain Metrics
GET /api/v1/onchain/bitcoin-valuation-metricsTry in Playground

Response fields

block_height: number?btc_price: number?date: string?formattedDate: string?investor_cap: number?market_cap: number?mvrv_ratio: number?nupl: number?price: number?realized_cap: number?thermocap: number?timestamp: integer?active_cap: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
bitcoin-yardstickpro

Bitcoin Yardstick

On-Chain Metrics
GET /api/v1/onchain/bitcoin-yardstickTry in Playground

Response fields

block_height: number?btc_price: number?date: string?formattedDate: string?hash_rate: number?market_cap: number?market_cap_usd: number?price: number?raw_yardstick: number?timestamp: integer?yardstick: number?yardstick_zscore: number?difficulty: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.
block-heightpro

Block Height

On-Chain Metrics
GET /api/v1/onchain/block-heightTry in Playground

Response fields

avg_fees_per_block: number?blocks: number?btc_price: number?coinbase_rewards_btc: number?daily_issuance_btc: number?difficulty: number?hash_rate: number?last_height: number?price: number?total_fees_btc: number?utxos_created: number?utxos_spent: number?date: string?formattedDate: string?ledger_index: number?timestamp: integer?block_height: number?

Query parameters

NameTypeDescription
daysintegerNumber of recent calendar days to return.
limitintegerMaximum number of rows to return.
chainstringChain or asset identifier.
startDatedateInclusive start date in YYYY-MM-DD format.
endDatedateInclusive end date in YYYY-MM-DD format.
formatstringResponse serialization format.
fieldsstringComma-separated response fields to project from each row.
dataResolutionstringRequested on-chain data resolution, when the metric advertises it in /api/onchain/manifest. Daily (1d) is the default; block and sub-day resolutions are served from the same metric endpoint.