On-Chain API

All On-Chain Metrics

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

477 endpoints, catalog 927ed17c749a5e0cPage 10 of 10

tx-countpro

Tx Count

On-Chain Metrics

GET /api/v1/onchain/tx-count?chain=xrpTry in Playground

Response fields

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

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

txs-todaypro

Txs Today

On-Chain Metrics

GET /api/v1/onchain/txs-today?chain=hyperliquidTry in Playground

Response fields

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

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

unrealized-losspro

Unrealized Loss

On-Chain Metrics

GET /api/v1/onchain/unrealized-loss?chain=xrpTry in Playground

Response fields

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

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

unrealized-pl-heatmappro

Unrealized Pl Heatmap

On-Chain Metrics

GET /api/v1/onchain/unrealized-pl-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

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

unrealized-pl-heatmap-by-agepro

Unrealized Pl Heatmap By Age

On-Chain Metrics

GET /api/v1/onchain/unrealized-pl-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

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

unrealized-pl-heatmap-lthpro

Unrealized Pl Heatmap Lth

On-Chain Metrics

GET /api/v1/onchain/unrealized-pl-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

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

unrealized-pl-heatmap-sthpro

Unrealized Pl Heatmap Sth

On-Chain Metrics

GET /api/v1/onchain/unrealized-pl-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

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

unrealized-profitpro

Unrealized Profit

On-Chain Metrics

GET /api/v1/onchain/unrealized-profit?chain=xrpTry in Playground

Response fields

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

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

urpdpro

Urpd

On-Chain Metrics

GET /api/v1/onchain/urpdTry in Playground

Response fields

avg_age_days: number?btc_amount: number?bucket_max: number?bucket_min: number?cumulative_pct: number?in_profit: number?percentage: number?price_bucket: number?utxo_count: number?formattedDate: string?block_height: number?btc_price: number?date: string?timestamp: integer?ath_price: number?bucket_count: number?bucket_mode: number?current_price: number?distribution: number?total_supply_btc: number?unrealized_pl: number?

Query parameters

Name	Type	Description
`chain`	string	Chain or asset identifier.

urpd_by_cohortpro

Urpd_by_cohort

On-Chain Metrics

GET /api/v1/onchain/urpd_by_cohortTry in Playground

Response fields

bucket_max: number?bucket_min: number?cohorts: number?in_profit: number?price_bucket: number?total_btc: number?total_utxos: number?ath_price: number?bucket_count: number?bucket_mode: number?cohort_count: number?cohort_names: number?cohort_summaries: number?current_price: number?distribution: number?total_supply_btc: number?

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.

urpd-by-cohortpro

Point-in-time UTXO realized price distribution broken down by holder age cohort.

On-Chain Metrics

GET /api/v1/onchain/urpd-by-cohortTry in Playground

Response fields

distribution: number?ath_price: number?current_price: number?bucket_count: number?bucket_mode: number?cohort_count: number?cohort_names: number?cohort_summaries: number?total_supply_btc: number?

Query parameters

No query parameters.

urpd-historypro

Urpd History

On-Chain Metrics

GET /api/v1/onchain/urpd-historyTry in Playground

Response fields

btc_price: number?buckets: number?date: string?formattedDate: string?timestamp: integer?total_supply: number?

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

utxo-set-growthpro

Utxo Set Growth

On-Chain Metrics

GET /api/v1/onchain/utxo-set-growthTry in Playground

Response fields

date: string?formattedDate: string?price: number?timestamp: integer?utxo_net_change: number?block_height: number?

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

utxos-createdpro

Utxos Created

On-Chain Metrics

GET /api/v1/onchain/utxos-createdTry 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

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

utxos-spentpro

Utxos Spent

On-Chain Metrics

GET /api/v1/onchain/utxos-spentTry in Playground

Response fields

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

valuation-metricspro

Valuation Metrics

On-Chain Metrics

GET /api/v1/onchain/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?ledger_index: number?

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

value-days-destroyedpro

Value Days Destroyed

On-Chain Metrics

GET /api/v1/onchain/value-days-destroyed?chain=hyperliquidTry in Playground

Response fields

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

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

vault-normpro

Vault Norm

On-Chain Metrics

GET /api/v1/onchain/vault-norm?chain=hyperliquidTry in Playground

Response fields

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

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

vaulted-supplypro

Vaulted Supply

On-Chain Metrics

GET /api/v1/onchain/vaulted-supply?chain=xrpTry in Playground

Response fields

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

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

vaulted-supply-profit-losspro

Vaulted Supply Profit Loss

On-Chain Metrics

GET /api/v1/onchain/vaulted-supply-profit-lossTry in Playground

Response fields

block_height: number?btc_in_loss: number?btc_in_profit: number?btc_price: number?date: string?formattedDate: string?pct_vaulted_in_loss: number?pct_vaulted_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?vaulted_supply: number?vaulted_supply_btc: number?vaulted_supply_in_loss: number?vaulted_supply_in_profit: number?ledger_index: number?vaulted_supply_profit_loss: number?abs_loss: number?abs_profit: number?

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

vaultednesspro

Vaultedness

On-Chain Metrics

GET /api/v1/onchain/vaultednessTry in Playground

Response fields

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?

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

vaultedness-active-mvrv-divergencepro

Vaultedness Active Mvrv Divergence

On-Chain Metrics

GET /api/v1/onchain/vaultedness-active-mvrv-divergenceTry in Playground

Response fields

active_mvrv: number?active_mvrv_norm: number?amvrv_norm: number?block_height: number?btc_price: number?date: string?divergence: number?formattedDate: string?price: number?timestamp: integer?vault_norm: number?vaultedness: number?vaultedness_divergence: number?ledger_index: number?

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.

vaultedness-divergencepro

Vaultedness Divergence

On-Chain Metrics

GET /api/v1/onchain/vaultedness-divergence?chain=hyperliquidTry in Playground

Response fields

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

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

vdd-multiplepro

Vdd Multiple

On-Chain Metrics

GET /api/v1/onchain/vdd-multipleTry in Playground

Response fields

activity_level: number?block_height: number?btc_price: number?circulating_supply_btc: number?coin_days_destroyed: number?cumulative_value_days_destroyed: number?date: string?formattedDate: string?price: number?timestamp: integer?value_days_destroyed: number?value_days_destroyed_usd: number?vdd: number?vdd_30d_ma: number?vdd_365d_ma: number?vdd_multiple: number?ledger_index: number?cdd: number?cumulative_vdd: number?vdd_usd: number?cum_cdd: number?vdd_calculated: number?vdd_multiple_cold: number?vdd_multiple_extreme: number?vdd_multiple_hot: number?vdd_multiple_moderate: number?

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

wikipedia_pageviewspro

Wikipedia_pageviews

On-Chain Metrics

GET /api/v1/onchain/wikipedia_pageviewsTry in Playground

Response fields

btc_price: number?date: string?formattedDate: string?timestamp: integer?wiki_binance: number?wiki_bitcoin: number?wiki_blockchain: number?wiki_cardano: number?wiki_coinbase: number?wiki_crypto_bubble: number?wiki_cryptocurrency: number?wiki_defi: number?wiki_dogecoin: number?wiki_ethereum: number?wiki_ico: number?wiki_memecoin: number?wiki_metamask: number?wiki_nft: number?wiki_satoshi_nakamoto: number?wiki_solana: number?wiki_stablecoin: number?wiki_xrp: number?

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.

yearly-absorption-ratepro

Yearly Absorption Rate

On-Chain Metrics

GET /api/v1/onchain/yearly-absorption-rateTry in Playground

Response fields

absorption_0_001to0_01btc: number?absorption_0_01to0_1btc: number?absorption_0_1to1btc: number?absorption_100to1kbtc: number?absorption_10kto100kbtc: number?absorption_10to100btc: number?absorption_1kto10kbtc: number?absorption_1to10btc: number?absorption_above100kbtc: number?absorption_crab: number?absorption_fish: number?absorption_humpback: number?absorption_plankton: number?absorption_shark: number?absorption_shrimp: number?absorption_shrimp_large: number?absorption_shrimp_small: number?absorption_sub0_001btc: number?absorption_whale: number?absorption_whale_small: number?block_height: number?btc_price: number?change_0_001to0_01btc: number?change_0_01to0_1btc: number?change_0_1to1btc: number?change_100to1kbtc: number?change_10kto100kbtc: number?change_10to100btc: number?change_1kto10kbtc: number?change_1to10btc: number?change_above100kbtc: number?change_sub0_001btc: number?date: string?formattedDate: string?price: number?timestamp: integer?yearly_issuance_btc: number?a2vr: number?active_cap: number?active_mvrv: number?active_realized_price: number?active_supply_btc: number?aviv_nupl: number?aviv_ratio: 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?cointime_price: 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: 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_flow_365d: 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: 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?yearly_absorption_rate: number?z_score: number?zero_line: number?

Query parameters

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.

z-scoreprolegacy

Legacy V1 compatibility path. Production historically returned 'aviv-z-score' for this endpoint; use the canonical replacement for new integrations.

On-Chain Metrics

GET /api/v1/onchain/z-scoreTry in Playground

Canonical replacement: /api/v1/onchain/aviv-z-score

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

Name	Type	Description
`days`	integer	Number of recent calendar days to return.
`limit`	integer	Maximum number of rows to return.
`chain`	string	Chain or asset identifier.
`startDate`	date	Inclusive start date in YYYY-MM-DD format.
`endDate`	date	Inclusive end date in YYYY-MM-DD format.
`format`	string	Response serialization format.
`fields`	string	Comma-separated response fields to project from each row.
`dataResolution`	string	Requested 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.