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 5 of 10
lth-wealth-attributionpro

Lth Wealth Attribution

On-Chain Metrics
GET /api/v1/onchain/lth-wealth-attributionTry in Playground

Response fields

adjusted_concentration: number?aging_rcap: number?aging_supply_btc: number?block_height: number?btc_price: number?coinbase_btc: number?coinbase_usd: number?cum_f1_aging: number?cum_f2_lth_spending: number?cum_f3_lth_pnl: number?cum_f4_sth_pnl: number?cum_f5_issuance: number?date: string?delta_concentration: number?delta_supply_pct: number?f1_aging: number?f2_lth_spending: number?f3_lth_pnl: number?f4_sth_pnl: number?f5_issuance: number?formattedDate: string?lth_concentration: number?lth_concentration_change_negative: number?lth_concentration_change_positive: number?lth_cost_basis_usd: number?lth_pnl: number?lth_realized_cap: number?lth_spent_btc: number?lth_spent_rcap: number?lth_supply_btc: number?lth_supply_pct: number?lth_wealth_concentration_change: number?lth_wealth_concentration_pct: number?price: number?realized_cap: number?realized_cap_usd: number?residual: number?sf1_aging: number?sf2_lth_spending: number?sf3_issuance: number?sth_concentration: number?sth_pnl: number?sth_supply_pct: number?timestamp: integer?total_supply_btc: 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.
lth-wealth-concentrationpro

Lth Wealth Concentration

On-Chain Metrics
GET /api/v1/onchain/lth-wealth-concentrationTry in Playground

Response fields

adjusted_concentration: number?aging_rcap: number?aging_supply_btc: number?block_height: number?btc_price: number?coinbase_btc: number?coinbase_usd: number?cum_f1_aging: number?cum_f2_lth_spending: number?cum_f3_lth_pnl: number?cum_f4_sth_pnl: number?cum_f5_issuance: number?date: string?delta_concentration: number?delta_supply_pct: number?f1_aging: number?f2_lth_spending: number?f3_lth_pnl: number?f4_sth_pnl: number?f5_issuance: number?formattedDate: string?lth_concentration: number?lth_concentration_change_negative: number?lth_concentration_change_positive: number?lth_cost_basis_usd: number?lth_pnl: number?lth_realized_cap: number?lth_spent_btc: number?lth_spent_rcap: number?lth_supply_btc: number?lth_supply_pct: number?lth_wealth_concentration_change: number?lth_wealth_concentration_pct: number?price: number?realized_cap: number?realized_cap_usd: number?residual: number?sf1_aging: number?sf2_lth_spending: number?sf3_issuance: number?sth_concentration: number?sth_pnl: number?sth_supply_pct: number?timestamp: integer?total_supply_btc: number?lth_wealth_concentration: number?ledger_index: number?top10_pct_share: 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.
market-cappro

Market Cap

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

Response fields

btc_price: number?date: string?formattedDate: string?ledger_index: number?market_cap: number?market_cap_usd: number?price: number?supply: number?timestamp: integer?block_height: number?block: 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.
market-cap-by-agepro

Market Cap By Age

On-Chain Metrics
GET /api/v1/onchain/market-cap-by-ageTry in Playground

Response fields

block_height: number?btc_price: number?date: string?formattedDate: string?mcap_10y_plus: number?mcap_1d_1w: number?mcap_1m_3m: number?mcap_1w_1m: number?mcap_1y_2y: number?mcap_24h: number?mcap_2y_3y: number?mcap_3m_6m: number?mcap_3y_5y: number?mcap_5y_7y: number?mcap_6m_12m: number?mcap_7y_10y: number?rcap_10y_plus: number?rcap_1d_1w: number?rcap_1m_3m: number?rcap_1w_1m: number?rcap_1y_2y: number?rcap_24h: number?rcap_2y_3y: number?rcap_3m_6m: number?rcap_3y_5y: number?rcap_5y_7y: number?rcap_6m_12m: number?rcap_7y_10y: 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?timestamp: integer?total_mcap: number?total_rcap: number?ledger_index: number?price: number?supply_6m_1y: number?mcap_10y_plus_usd: number?mcap_1d_1w_usd: number?mcap_1m_3m_usd: number?mcap_1w_1m_usd: number?mcap_1y_2y_usd: number?mcap_24h_usd: number?mcap_2y_3y_usd: number?mcap_3m_6m_usd: number?mcap_3y_5y_usd: number?mcap_5y_7y_usd: number?mcap_5y_plus: number?mcap_5y_plus_usd: number?mcap_6m_12m_usd: number?mcap_7y_10y_usd: number?mcap_lt_1d: number?mcap_lt_1d_usd: 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.
mctcpro

Mctc

On-Chain Metrics
GET /api/v1/onchain/mctcTry 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?date: string?formattedDate: string?investor_cap: number?liveliness: number?market_cap: number?mctc: number?mctc_ratio: number?mvrv_ratio: number?nupl: number?price: number?realized_cap: number?supply_in_loss_btc: number?supply_in_profit_btc: number?thermocap: number?thermoprice: number?thermoprice_16x: number?thermoprice_2x: number?thermoprice_32x: number?thermoprice_4x: number?thermoprice_64x: number?thermoprice_6x: number?thermoprice_8x: 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.
median-cost-basispro

Median Cost Basis

On-Chain Metrics
GET /api/v1/onchain/median-cost-basis?chain=hyperliquidTry in Playground

Response fields

btc_price: number?date: string?median_cost_basis_usd: 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.
median-cost-basis-by-agepro

Median Cost Basis By Age

On-Chain Metrics
GET /api/v1/onchain/median-cost-basis-by-ageTry in Playground

Response fields

block_height: number?btc_price: number?by_age: number?date: string?formattedDate: string?median_band_0: number?median_band_1: number?median_band_10: number?median_band_11: number?median_band_2: number?median_band_3: number?median_band_4: number?median_band_5: number?median_band_6: number?median_band_7: number?median_band_8: number?median_band_9: number?price: number?timestamp: integer?ledger_index: number?median_cost_basis_1d_1w: number?median_cost_basis_1m_3m: number?median_cost_basis_1w_1m: number?median_cost_basis_1y_2y: number?median_cost_basis_2y_3y: number?median_cost_basis_3m_6m: number?median_cost_basis_3y_5y: number?median_cost_basis_5y_plus: number?median_cost_basis_6m_12m: number?median_cost_basis_lt_1d: number?median_cost_basis_usd: 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.
median-mvrvpro

Median Mvrv

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

Response fields

block_height: number?btc_price: number?date: string?formattedDate: string?market_cap_usd: number?median_cost_basis: number?median_mvrv: number?median_realized_price: number?mvrv: number?mvrv_ratio: number?price: number?realized_cap_usd: number?realized_price: number?timestamp: integer?ledger_index: number?breakeven_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.
median-soprpro

Median Sopr

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

Response fields

btc_price: number?date: string?formattedDate: string?median_sopr: number?median_sopr_p05: number?median_sopr_p10: number?median_sopr_p25: number?median_sopr_p75: number?median_sopr_p90: number?median_sopr_p95: number?median_sopr_pct_in_profit: number?median_sopr_value_weighted: number?price: number?spent_outputs: number?timestamp: integer?ledger_index: number?block_height: number?adjusted_sopr: number?sopr_sma7: 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.
metricsprolegacy

Legacy V1 compatibility path. Production historically returned 'bitcoin-valuation-metrics' for this endpoint; use the canonical replacement for new integrations.

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

Canonical replacement: /api/v1/onchain/bitcoin-valuation-metrics

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.
miner-net-position-changepro

Miner Net Position Change

On-Chain Metrics
GET /api/v1/onchain/miner-net-position-changeTry in Playground

Response fields

btc_price: number?date: string?formattedDate: string?mined_btc: number?net_30d_mean_btc: number?net_position_change_btc: number?spent_btc: 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.
miner-unspent-supplypro

Miner Unspent Supply

On-Chain Metrics
GET /api/v1/onchain/miner-unspent-supplyTry in Playground

Response fields

btc_price: number?date: string?formattedDate: string?miner_unspent_btc: 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.
mining-difficultypro

Mining Difficulty

On-Chain Metrics
GET /api/v1/onchain/mining-difficultyTry in Playground

Response fields

avg_fees_per_block: number?block_height: number?blocks: number?btc_price: number?coinbase_rewards_btc: number?daily_issuance_btc: number?date: string?difficulty: number?formattedDate: string?hash_rate: number?last_height: number?price: number?timestamp: integer?total_fees_btc: number?utxos_created: number?utxos_spent: 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.
mvrvpro

Mvrv

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

Response fields

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?btc_price: number?date: string?formattedDate: string?lth_mvrv: number?market_cap_usd: number?mvrv: number?mvrv_0sigma_price: number?mvrv_minus_1sigma_price: number?mvrv_plus_1sigma_price: number?mvrv_ratio: number?price: number?realized_cap_usd: number?realized_price: number?sth_mvrv: number?timestamp: integer?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?ledger_index: number?block_height: 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.
mvrv-bandspro

Mvrv Bands

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

Response fields

block_height: number?btc_price: number?circulating_supply: number?date: string?formattedDate: string?market_cap: number?market_cap_usd: number?mvrv: number?mvrv_4year_average: number?mvrv_4year_minus_1_sigma: number?mvrv_4year_minus_2_sigma: number?mvrv_4year_plus_1_sigma: number?mvrv_4year_plus_2_sigma: number?mvrv_4year_plus_3_sigma: number?mvrv_lower_1sd: number?mvrv_lower_2sd: number?mvrv_mean: number?mvrv_minus_0_5_sigma: number?mvrv_minus_1_5_sigma: number?mvrv_minus_1_sigma: number?mvrv_minus_2_sigma: number?mvrv_plus_0_5_sigma: number?mvrv_plus_1_5_sigma: number?mvrv_plus_1_sigma: number?mvrv_plus_2_sigma: number?mvrv_ratio: number?mvrv_upper_1sd: number?mvrv_upper_2sd: number?price: number?price_at_mean: number?price_at_minus_1_sigma: number?price_at_minus_2_sigma: number?price_at_plus_1_sigma: number?price_at_plus_2_sigma: number?price_mean: number?price_minus_0_5_sigma: number?price_minus_1_5_sigma: number?price_minus_1_sigma: number?price_minus_2_sigma: number?price_plus_0_5_sigma: number?price_plus_1_5_sigma: number?price_plus_1_sigma: number?price_plus_2_sigma: number?realized_cap: number?realized_cap_usd: number?realized_price: number?timestamp: integer?z_score: number?mvrv_minus_half_sigma: number?mvrv_plus_half_sigma: number?ledger_index: number?mvrv_bands: number?mvrv_minus_1sigma: number?mvrv_plus_1sigma: number?mvrv_plus_2sigma: number?price_at_mvrv_mean: number?price_at_mvrv_minus_1sd: number?price_at_mvrv_minus_1sigma: number?price_at_mvrv_minus_2sd: number?price_at_mvrv_minus_half_sigma: number?price_at_mvrv_plus_1sd: number?price_at_mvrv_plus_1sigma: number?price_at_mvrv_plus_2sd: number?price_at_mvrv_plus_2sigma: number?price_at_mvrv_plus_half_sigma: number?price_lower_1sd: number?price_lower_2sd: number?price_mean_band: number?price_upper_1sd: number?price_upper_2sd: number?alltime_average: number?alltime_minus_1_sigma: number?alltime_minus_2_sigma: number?alltime_plus_1_sigma: number?alltime_plus_2_sigma: 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.
mvrv-dataprolegacy

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

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

Canonical replacement: /api/v1/onchain/mvrv

Response fields

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?btc_price: number?date: string?formattedDate: string?lth_mvrv: number?market_cap_usd: number?mvrv: number?mvrv_0sigma_price: number?mvrv_minus_1sigma_price: number?mvrv_plus_1sigma_price: number?mvrv_ratio: number?price: number?realized_cap_usd: number?realized_price: number?sth_mvrv: number?timestamp: integer?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?ledger_index: number?block_height: 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.
mvrv-momentumpro

Mvrv Momentum

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

Response fields

block_height: number?btc_price: number?date: string?formattedDate: string?market_cap_usd: number?mvrv: number?mvrv_momentum: number?mvrv_momentum_30d: number?mvrv_momentum_90d: number?mvrv_ratio: number?mvrv_sma_30: number?mvrv_sma_365: number?price: number?realized_cap_usd: number?timestamp: integer?z_score: 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.
mvrv-z-scorepro

Mvrv Z Score

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

Response fields

block_height: number?btc_price: number?date: string?formattedDate: string?market_cap_usd: number?mvrv: number?mvrv_ratio: number?mvrv_zscore: number?price: number?realized_cap_usd: number?timestamp: integer?z_score: number?mvrv_zscore_rolling: number?mvrv_zscore_smoothed: number?ledger_index: number?mvrv_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.
mvrv-zscoreprolegacy

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

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

Canonical replacement: /api/v1/onchain/mvrv

Response fields

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?btc_price: number?date: string?formattedDate: string?lth_mvrv: number?market_cap_usd: number?mvrv: number?mvrv_0sigma_price: number?mvrv_minus_1sigma_price: number?mvrv_plus_1sigma_price: number?mvrv_ratio: number?price: number?realized_cap_usd: number?realized_price: number?sth_mvrv: number?timestamp: integer?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?ledger_index: number?block_height: 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.
mweb-flowspro

Mweb Flows

On-Chain Metrics
GET /api/v1/onchain/mweb-flows?chain=litecoinTry in Playground

Response fields

block_height: number?btc_price: number?date: string?formattedDate: string?mweb_net_flow_ltc: number?mweb_pegins_ltc: number?mweb_pegouts_ltc: number?mweb_supply_ltc: number?mweb_utilization: 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.
mweb-supplypro

Mweb Supply

On-Chain Metrics
GET /api/v1/onchain/mweb-supply?chain=litecoinTry in Playground

Response fields

block_height: number?btc_price: number?circulating_supply_ltc: number?date: string?formattedDate: string?mweb_supply_ltc: number?mweb_supply_pct: 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.
net-issuancepro

Net Issuance

On-Chain Metrics
GET /api/v1/onchain/net-issuance?chain=ethereumTry in Playground

Response fields

cumulative_burned_eth: number?cumulative_issuance_eth: number?daily_burned_eth: number?daily_issuance_eth: number?inflation_rate_annualized: number?net_issuance_eth: number?btc_price: number?date: string?formattedDate: string?ledger_index: number?net_issuance: number?price: number?timestamp: integer?circulating_supply_btc: number?lth_supply_btc: number?sth_supply_btc: number?supply_hype: 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.
net-realized-plpro

Net Realized Pl

On-Chain Metrics
GET /api/v1/onchain/net-realized-plTry in Playground

Response fields

block_height: number?btc_price: number?daily_realized_loss_btc: number?daily_realized_loss_usd: number?daily_realized_profit_btc: number?daily_realized_profit_usd: number?date: string?formattedDate: string?net_realized_pl: number?net_realized_pl_usd: number?net_rpl: number?net_rpl_sma30: number?price: number?realized_loss_usd: number?realized_profit_usd: number?timestamp: integer?ledger_index: number?net_realized_pl_btc: 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.
net-realized-pnlpro

Net Realized Pnl

On-Chain Metrics
GET /api/v1/onchain/net-realized-pnl?chain=xrpTry in Playground

Response fields

btc_price: number?date: string?formattedDate: string?ledger_index: number?net_realized_pnl: 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.
net-realized-profit-lossprolegacy

Legacy V1 compatibility path. Production historically returned 'net-realized-pl' for this endpoint; use the canonical replacement for new integrations.

On-Chain Metrics
GET /api/v1/onchain/net-realized-profit-lossTry in Playground

Canonical replacement: /api/v1/onchain/net-realized-pl

Response fields

block_height: number?btc_price: number?daily_realized_loss_btc: number?daily_realized_loss_usd: number?daily_realized_profit_btc: number?daily_realized_profit_usd: number?date: string?formattedDate: string?net_realized_pl: number?net_realized_pl_usd: number?net_rpl: number?net_rpl_sma30: number?price: number?realized_loss_usd: number?realized_profit_usd: number?timestamp: integer?ledger_index: number?net_realized_pl_btc: 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.
network-estimated-exchange-flowspro

Network Estimated Exchange Flows

On-Chain Metrics
GET /api/v1/onchain/network-estimated-exchange-flowsTry in Playground

Response fields

btc_price: number?cross_grade_exchange_internal_btc: number?date: string?formattedDate: string?heuristic_cross_grade_exchange_internal_btc: number?heuristic_publishable_exchange_inflow_btc: number?heuristic_publishable_exchange_netflow_btc: number?heuristic_publishable_exchange_outflow_btc: number?heuristic_publishable_to_withheld_exchange_internal_btc: number?heuristic_total_labeled_exchange_inflow_btc: number?heuristic_total_labeled_exchange_netflow_btc: number?heuristic_total_labeled_exchange_outflow_btc: number?heuristic_withheld_exchange_inflow_btc: number?heuristic_withheld_exchange_netflow_btc: number?heuristic_withheld_exchange_outflow_btc: number?heuristic_withheld_to_publishable_exchange_internal_btc: number?price: number?publishable_exchange_inflow_btc: number?publishable_exchange_netflow_btc: number?publishable_exchange_outflow_btc: number?publishable_to_withheld_exchange_internal_btc: number?timestamp: integer?total_labeled_exchange_inflow_btc: number?total_labeled_exchange_netflow_btc: number?total_labeled_exchange_outflow_btc: number?withheld_exchange_inflow_btc: number?withheld_exchange_netflow_btc: number?withheld_exchange_outflow_btc: number?withheld_to_publishable_exchange_internal_btc: 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.
network-estimated-exchange-reservespro

Network Estimated Exchange Reserves

On-Chain Metrics
GET /api/v1/onchain/network-estimated-exchange-reservesTry in Playground

Response fields

btc_price: number?date: string?exact_publishable_exchange_reserve_btc: number?exact_total_labeled_exchange_reserve_btc: number?exact_withheld_exchange_reserve_btc: number?exchange_controller_bake_balance_btc: number?exchange_controller_bake_heuristic_balance_btc: number?exchange_controller_binance_balance_btc: number?exchange_controller_binance_exact_balance_btc: number?exchange_controller_binance_heuristic_balance_btc: number?exchange_controller_bitbank_balance_btc: number?exchange_controller_bitbank_heuristic_balance_btc: number?exchange_controller_bitfinex_balance_btc: number?exchange_controller_bitfinex_heuristic_balance_btc: number?exchange_controller_bitget_balance_btc: number?exchange_controller_bitget_heuristic_balance_btc: number?exchange_controller_bitmake_balance_btc: number?exchange_controller_bitmake_heuristic_balance_btc: number?exchange_controller_bitmex_balance_btc: number?exchange_controller_bitmex_exact_balance_btc: number?exchange_controller_bitmex_heuristic_balance_btc: number?exchange_controller_bitstamp_balance_btc: number?exchange_controller_bitstamp_exact_balance_btc: number?exchange_controller_bitstamp_heuristic_balance_btc: number?exchange_controller_bittrex_balance_btc: number?exchange_controller_bittrex_heuristic_balance_btc: number?exchange_controller_bitvenus_balance_btc: number?exchange_controller_bitvenus_heuristic_balance_btc: number?exchange_controller_btc_h_e_balance_btc: number?exchange_controller_btc_h_e_heuristic_balance_btc: number?exchange_controller_btse_balance_btc: number?exchange_controller_btse_heuristic_balance_btc: number?exchange_controller_bybit_balance_btc: number?exchange_controller_bybit_exact_balance_btc: number?exchange_controller_bybit_heuristic_balance_btc: number?exchange_controller_coinbase_balance_btc: number?exchange_controller_coinbase_exact_balance_btc: number?exchange_controller_coinbase_heuristic_balance_btc: number?exchange_controller_coincheck_balance_btc: number?exchange_controller_coincheck_heuristic_balance_btc: number?exchange_controller_coindcx_balance_btc: number?exchange_controller_coindcx_heuristic_balance_btc: number?exchange_controller_coinex_balance_btc: number?exchange_controller_coinex_exact_balance_btc: number?exchange_controller_coinex_heuristic_balance_btc: number?exchange_controller_coinsquare_balance_btc: number?exchange_controller_coinsquare_heuristic_balance_btc: number?exchange_controller_coinw_balance_btc: number?exchange_controller_coinw_heuristic_balance_btc: number?exchange_controller_crypto_h_com_balance_btc: number?exchange_controller_crypto_h_com_heuristic_balance_btc: number?exchange_controller_cryptsy_balance_btc: number?exchange_controller_cryptsy_heuristic_balance_btc: number?exchange_controller_derebit_balance_btc: number?exchange_controller_derebit_heuristic_balance_btc: number?exchange_controller_firi_balance_btc: number?exchange_controller_firi_heuristic_balance_btc: number?exchange_controller_ftx_h_alameda_balance_btc: number?exchange_controller_ftx_h_alameda_heuristic_balance_btc: number?exchange_controller_gate_h_io_balance_btc: number?exchange_controller_gate_h_io_heuristic_balance_btc: number?exchange_controller_gemini_balance_btc: number?exchange_controller_gemini_heuristic_balance_btc: number?exchange_controller_hashkey_h_exchange_balance_btc: number?exchange_controller_hashkey_h_exchange_heuristic_balance_btc: number?exchange_controller_htx_balance_btc: number?exchange_controller_htx_exact_balance_btc: number?exchange_controller_htx_heuristic_balance_btc: number?exchange_controller_klever_balance_btc: number?exchange_controller_klever_heuristic_balance_btc: number?exchange_controller_korbit_balance_btc: number?exchange_controller_korbit_heuristic_balance_btc: number?exchange_controller_kraken_balance_btc: number?exchange_controller_kraken_heuristic_balance_btc: number?exchange_controller_kucoin_balance_btc: number?exchange_controller_kucoin_heuristic_balance_btc: number?exchange_controller_latoken_balance_btc: number?exchange_controller_latoken_heuristic_balance_btc: number?exchange_controller_maskex_balance_btc: number?exchange_controller_maskex_heuristic_balance_btc: number?exchange_controller_mexc_balance_btc: number?exchange_controller_mexc_exact_balance_btc: number?exchange_controller_mexc_heuristic_balance_btc: number?exchange_controller_mt_h_gox_balance_btc: number?exchange_controller_mt_h_gox_heuristic_balance_btc: number?exchange_controller_nbx_balance_btc: number?exchange_controller_nbx_heuristic_balance_btc: number?exchange_controller_okx_balance_btc: number?exchange_controller_okx_exact_balance_btc: number?exchange_controller_okx_heuristic_balance_btc: number?exchange_controller_paybis_balance_btc: number?exchange_controller_paybis_heuristic_balance_btc: number?exchange_controller_phemex_balance_btc: number?exchange_controller_phemex_heuristic_balance_btc: number?exchange_controller_poloniex_balance_btc: number?exchange_controller_poloniex_heuristic_balance_btc: number?exchange_controller_river_balance_btc: number?exchange_controller_river_heuristic_balance_btc: number?exchange_controller_robinhood_balance_btc: number?exchange_controller_robinhood_heuristic_balance_btc: number?exchange_controller_swissborg_balance_btc: number?exchange_controller_swissborg_heuristic_balance_btc: number?exchange_controller_unnamed_h_cold_h_holder_h_a_balance_btc: number?exchange_controller_unnamed_h_cold_h_holder_h_a_heuristic_balance_btc: number?exchange_controller_unnamed_h_exchange_h_a_balance_btc: number?exchange_controller_unnamed_h_exchange_h_a_heuristic_balance_btc: number?exchange_controller_upbit_balance_btc: number?exchange_controller_upbit_heuristic_balance_btc: number?exchange_controller_vircurex_balance_btc: number?exchange_controller_vircurex_heuristic_balance_btc: number?exchange_controller_woo_h_x_balance_btc: number?exchange_controller_woo_h_x_heuristic_balance_btc: number?exchange_controller_xt_h_com_balance_btc: number?exchange_controller_xt_h_com_heuristic_balance_btc: number?formattedDate: string?funded_exchange_controllers: number?funded_publishable_exchange_controllers: number?funded_withheld_exchange_controllers: number?heuristic_publishable_exchange_reserve_btc: number?heuristic_total_labeled_exchange_reserve_btc: number?heuristic_withheld_exchange_reserve_btc: number?price: number?publishable_exchange_reserve_btc: number?timestamp: integer?total_labeled_exchange_reserve_btc: number?withheld_exchange_reserve_btc: 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.
network-healthpro

Network Health

On-Chain Metrics
GET /api/v1/onchain/network-healthTry in Playground

Response fields

active_addresses: number?avg_fees_per_block: number?block_height: number?blocks: number?btc_price: number?coinbase_rewards_btc: number?daily_issuance_btc: number?date: string?difficulty: number?formattedDate: string?hash_rate: number?last_height: number?nvt: number?nvt_30_ma: number?price: number?receiving_addresses: number?sending_addresses: number?spent_outputs: number?timestamp: integer?total_fees_btc: number?tx_count: number?utxos_created: number?utxos_spent: number?block_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.
network-statspro

Network Stats

On-Chain Metrics
GET /api/v1/onchain/network-statsTry in Playground

Response fields

block_count: number?btc_price: number?circulating_supply_btc: number?date: string?difficulty: number?fees_btc: number?formattedDate: string?price: number?spent_output_count: number?subsidy_btc: number?timestamp: integer?transfer_volume_btc: number?tx_count: number?utxo_count: 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.
never-moved-supplypro

Never Moved Supply

On-Chain Metrics
GET /api/v1/onchain/never-moved-supplyTry in Playground

Response fields

btc_price: number?date: string?formattedDate: string?never_moved_btc: number?never_moved_first_era_btc: number?never_moved_since_btc: 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.
new-addressespro

New Addresses

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

Response fields

date: string?formattedDate: string?new_addresses: 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.
new-addresses-by-typepro

New Addresses By Type

On-Chain Metrics
GET /api/v1/onchain/new-addresses-by-typeTry in Playground

Response fields

date: string?formattedDate: string?p2pkh_new_addresses: number?p2sh_new_addresses: number?p2tr_new_addresses: number?p2wpkh_new_addresses: number?p2wsh_new_addresses: 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.
non-exchange-supplypro

Non Exchange Supply

On-Chain Metrics
GET /api/v1/onchain/non-exchange-supply?chain=dogecoinTry in Playground

Response fields

btc_price: number?exchange_reserve_doge: number?formattedDate: string?non_exchange_mvrv: number?non_exchange_realized_cap: number?non_exchange_supply_doge: 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.
non-zero-balance-addressespro

Non Zero Balance Addresses

On-Chain Metrics
GET /api/v1/onchain/non-zero-balance-addressesTry in Playground

Response fields

date: string?formattedDate: string?non_zero_addresses: 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.
nuplpro

Nupl

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

Response fields

btc_price: number?date: string?formattedDate: string?lth_nupl: number?market_cap: number?market_cap_btc: number?market_cap_usd: number?market_phase: number?mvrv_ratio: number?nupl: number?price: number?realized_cap: number?realized_cap_btc: number?realized_cap_created: number?realized_cap_created_btc: number?realized_cap_destroyed: number?realized_cap_destroyed_btc: number?realized_cap_net: number?realized_cap_net_btc: number?realized_cap_usd: number?sth_nupl: number?supply_in_loss_btc: number?supply_in_profit_btc: number?timestamp: integer?unrealized_loss_usd: number?unrealized_profit_usd: number?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.
nupl-bandspro

Nupl Bands

On-Chain Metrics
GET /api/v1/onchain/nupl-bands?chain=hyperliquidTry in Playground

Response fields

btc_price: number?date: string?market_cap_usd: number?nupl: number?price: number?realized_cap_usd: 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.
nupl-momentumpro

Nupl Momentum

On-Chain Metrics
GET /api/v1/onchain/nupl-momentum?chain=hyperliquidTry in Playground

Response fields

btc_price: number?date: string?momentum: number?nupl: number?nupl_momentum: number?nupl_momentum_30d: number?nupl_momentum_90d: number?nupl_sma_30: number?nupl_sma_365: number?price: number?timestamp: integer?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.
nupl-z-scoreprolegacy

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

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

Canonical replacement: /api/v1/onchain/nupl

Response fields

btc_price: number?date: string?formattedDate: string?lth_nupl: number?market_cap: number?market_cap_btc: number?market_cap_usd: number?market_phase: number?mvrv_ratio: number?nupl: number?price: number?realized_cap: number?realized_cap_btc: number?realized_cap_created: number?realized_cap_created_btc: number?realized_cap_destroyed: number?realized_cap_destroyed_btc: number?realized_cap_net: number?realized_cap_net_btc: number?realized_cap_usd: number?sth_nupl: number?supply_in_loss_btc: number?supply_in_profit_btc: number?timestamp: integer?unrealized_loss_usd: number?unrealized_profit_usd: number?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.
nvtpro

Nvt

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

Response fields

btc_price: number?date: string?nvt: number?nvt_ratio: 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.
og-whale-spendingprolegacy

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

On-Chain Metrics
GET /api/v1/onchain/og-whale-spendingTry in Playground

Canonical replacement: /api/v1/onchain/sopr-by-age

Response fields

adjusted_sopr: number?block_height: number?btc_price: number?date: string?formattedDate: string?lth_sopr: number?sopr: number?sopr_age_10y_plus: number?sopr_age_10y_plus_created_usd: number?sopr_age_10y_plus_outputs: number?sopr_age_10y_plus_spent_usd: number?sopr_age_1d_1w: number?sopr_age_1d_1w_created_usd: number?sopr_age_1d_1w_outputs: number?sopr_age_1d_1w_spent_usd: number?sopr_age_1m_3m: number?sopr_age_1m_3m_created_usd: number?sopr_age_1m_3m_outputs: number?sopr_age_1m_3m_spent_usd: number?sopr_age_1w_1m: number?sopr_age_1w_1m_created_usd: number?sopr_age_1w_1m_outputs: number?sopr_age_1w_1m_spent_usd: number?sopr_age_1y_2y: number?sopr_age_1y_2y_created_usd: number?sopr_age_1y_2y_outputs: number?sopr_age_1y_2y_spent_usd: number?sopr_age_24h: number?sopr_age_24h_created_usd: number?sopr_age_24h_outputs: number?sopr_age_24h_spent_usd: number?sopr_age_2y_3y: number?sopr_age_2y_3y_created_usd: number?sopr_age_2y_3y_outputs: number?sopr_age_2y_3y_spent_usd: number?sopr_age_3m_6m: number?sopr_age_3m_6m_created_usd: number?sopr_age_3m_6m_outputs: number?sopr_age_3m_6m_spent_usd: number?sopr_age_3y_5y: number?sopr_age_3y_5y_created_usd: number?sopr_age_3y_5y_outputs: number?sopr_age_3y_5y_spent_usd: number?sopr_age_5y_7y: number?sopr_age_5y_7y_created_usd: number?sopr_age_5y_7y_outputs: number?sopr_age_5y_7y_spent_usd: number?sopr_age_6m_1y: number?sopr_age_6m_1y_created_usd: number?sopr_age_6m_1y_outputs: number?sopr_age_6m_1y_spent_usd: number?sopr_age_7y_10y: number?sopr_age_7y_10y_created_usd: number?sopr_age_7y_10y_outputs: number?sopr_age_7y_10y_spent_usd: number?sth_sopr: number?timestamp: integer?sopr_age_5y_plus: number?sopr_age_5y_plus_created_usd: number?sopr_age_5y_plus_outputs: number?sopr_age_5y_plus_spent_usd: number?ledger_index: number?price: number?sopr_age_6m_12m: number?asopr: number?sopr_age_6m_12m_created_usd: number?sopr_age_6m_12m_outputs: number?sopr_age_6m_12m_spent_usd: number?sopr_age_lt_1d: number?sopr_age_lt_1d_created_usd: number?sopr_age_lt_1d_outputs: number?sopr_age_lt_1d_spent_usd: 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.
onchain-price-levelspro

Onchain Price Levels

On-Chain Metrics
GET /api/v1/onchain/onchain-price-levelsTry in Playground

Response fields

active_realized_price: number?balanced_price: number?block_height: number?btc_price: number?cvdd: number?date: string?formattedDate: string?investor_price: number?lth_cost_basis: number?lth_upd_plus_2sigma_price: number?mvrv_avg_price: number?mvrv_ratio: number?nupl: number?price: number?realized_price: number?sth_3m_6m_realized_price: number?sth_cost_basis: number?thermoprice_32x: number?timestamp: integer?transferred_price: number?true_market_mean_price: number?vaulted_price: number?ledger_index: number?realized_price_usd: number?spot_price_usd: number?true_market_mean: number?true_market_mean_usd: 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.
onchain-riskpro

Percentile-normalized Bitcoin on-chain risk composite and component readings.

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

Response fields

date: string?timestamp: integer?btc_price: number?onchain_risk: number?risk_zone: number?components: 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.
onchain-risk-compositepro

Onchain Risk Composite

On-Chain Metrics
GET /api/v1/onchain/onchain-risk-compositeTry in Playground

Response fields

active_mvrv_pct: number?block_height: number?btc_price: number?date: string?formattedDate: string?mctc_pct: number?mvrv_pct: number?mvrv_zscore_pct: number?nupl_pct: number?pl_ratio_pct: number?price: number?puell_pct: number?pvr_pct: number?risk: number?rpl_ratio_pct: number?supply_pl_pct: number?timestamp: integer?ledger_index: number?onchain_risk_composite: 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.
op-returnpro

Op Return

On-Chain Metrics
GET /api/v1/onchain/op-returnTry in Playground

Response fields

date: string?formattedDate: string?op_return_fees_24h: number?op_return_fees_cumulative: 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.
op-return-data-volumepro

Op Return Data Volume

On-Chain Metrics
GET /api/v1/onchain/op-return-data-volumeTry in Playground

Response fields

date: string?formattedDate: string?omni_bytes: number?price: number?runes_bytes: number?text_bytes: number?timestamp: integer?total_bytes: number?unknown_bytes: 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.
op-return-protocolspro

Op Return Protocols

On-Chain Metrics
GET /api/v1/onchain/op-return-protocolsTry in Playground

Response fields

date: string?formattedDate: string?omni_tx_count_24h: number?price: number?runes_tx_count_24h: number?stacks_tx_count_24h: number?text_tx_count_24h: number?timestamp: integer?unknown_tx_count_24h: 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.
output-type-activitypro

Output Type Activity

On-Chain Metrics
GET /api/v1/onchain/output-type-activityTry in Playground

Response fields

date: string?formattedDate: string?p2pkh_output_share_24h: number?p2sh_output_share_24h: number?p2tr_output_share_24h: number?p2wpkh_output_share_24h: number?p2wsh_output_share_24h: 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.
pricepro

Price

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

Response fields

block_height: number?btc_price: number?date: string?formattedDate: string?timestamp: integer?bucket_end: number?bucket_start: number?close: number?high: number?ledger_index: number?low: number?open: number?source: number?volume: number?xrp_price: number?link_price: number?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.
production-costpro

Production Cost

On-Chain Metrics
GET /api/v1/onchain/production-costTry in Playground

Response fields

btc_price: number?date: string?efficiency_jth: number?electricity_cost: number?energy_per_btc_kwh: number?energy_value: number?formattedDate: string?marginal_cost: number?price: number?ratio_electricity: number?ratio_energy_value: number?ratio_marginal: number?ratio_regression: number?ratio_thermocap: number?ratio_total: number?regression_price: number?thermocap_price: number?timestamp: integer?total_cost: 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.
profit-losspro

Profit Loss

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

Response fields

block_height: number?btc_in_loss: number?btc_in_profit: number?btc_price: number?current_supply: 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_pct: number?supply_in_loss_percent: number?supply_in_profit_btc: number?supply_in_profit_pct: number?supply_in_profit_percent: number?timestamp: integer?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.