Response Field Glossary
Interpret common ChartInspect dates, prices, valuation, supply, profit, and network fields without assuming one universal row schema.
ChartInspect combines independent data sources and chart contracts. Not every response is daily, not every endpoint returns an array, and legacy timestamp or price fields are not globally uniform. Use this glossary for meaning, then use metric discovery or the Full Endpoint Reference for the fields actually returned by one endpoint.
#Dates and Time
| Field | Meaning |
|---|---|
date, formattedDate | Usually an ISO calendar date or date-time |
timestamp, timeunix | Unix time; 10 digits normally means seconds and 13 digits means milliseconds |
block_height | UTXO-chain block height at the sample |
ledger_index | XRP Ledger sequence number |
Do not assume UTC midnight for sub-day, block-level, event, or snapshot data.
#Prices and Units
| Pattern | Meaning |
|---|---|
price, close, asset-specific *_price | USD price field selected by that source or contract |
btc_price | Legacy Bitcoin USD price name, especially on Bitcoin-oriented metrics |
*_usd | US-dollar denomination |
*_btc, *_eth, or another asset suffix | Native-asset denomination |
The generic on-chain route can expose an asset-specific price name for non-Bitcoin assets. Read the discovery field list instead of hardcoding btc_price across every chain.
#Valuation
| Field | Meaning |
|---|---|
market_cap, market_cap_usd | Circulating supply multiplied by current price |
realized_cap, realized_cap_usd | Aggregate value at the price each unit last moved |
mvrv, mvrv_ratio | Market value divided by realized value |
nupl | Net unrealized profit minus loss as a share of market value |
realized_price, cost_basis | Aggregate acquisition-price estimate |
thermocap | Cumulative USD value of issued block rewards |
#Supply and Cohorts
| Field pattern | Meaning |
|---|---|
circulating_supply* | Units available in the circulating supply definition |
supply_in_profit*, supply_in_loss* | Supply above or below its acquisition price |
sth_*, lth_* | Short-term-holder and long-term-holder cohorts |
active_*, vaulted_* | Active and dormant supply lenses |
liveliness, vaultedness | Coin-time activity and dormancy ratios |
Cohort thresholds and attribution methods belong to the metric contract. Do not assume every chain uses Bitcoin's exact age model.
#Profit, Loss, and Spending
| Field | Meaning |
|---|---|
sopr, asopr | Spent output profit ratio, optionally adjusted |
realized_profit*, realized_loss* | Profit or loss crystallized by moved supply |
unrealized_profit*, unrealized_loss* | Mark-to-market holder profit or loss |
cdd, coinblocks_destroyed | Age-weighted spending activity |
#Network and Mining
| Field | Meaning |
|---|---|
hash_rate, difficulty | Proof-of-work security and mining difficulty |
fees*, total_fees* | Transaction fees in the field's stated denomination |
active_addresses, new_addresses | Source-defined address activity counts |
transaction_count, transfer_volume* | Network activity and transferred value |
Proof-of-stake and token assets do not expose proof-of-work fields merely because Bitcoin does.
#Distributions and Derived Fields
Snapshot endpoints such as URPD can return nested buckets or blocks rather than a scalar time series. Suffixes such as _sma, _ema, _smoothed, _positive, and _negative usually represent chart-ready derived fields. Use the base value for independent analysis unless you intentionally want ChartInspect's displayed transform.