BitcoinPlanned coverage

Daily network metrics

onchain.bitcoin.daily.metrics

Daily Bitcoin network statistics with explicit methods and provenance.

Planned plan access: Core, Research, Professional
Schema version: 2.0.0
Record key: chain_id, utc_date, available_at, revision

How to request it

When this dataset appears in your account’s catalog, select its version, supported fields and exact entity identifiers. Set a short date range and an as_of time, then request a small page. The record key identifies a row; it is not necessarily the identifier accepted by the query filter.

HTTP request template

This is a template, not a currently available request. Fill each variable from the authenticated catalog and your intended query. The Explorer can generate a complete request for an available dataset.

GET /v1/data/onchain.bitcoin.daily.metricsHTTP

curl --fail-with-body --get "$ORIGINFOLD_API_URL/v1/data/onchain.bitcoin.daily.metrics" \
  --header "Authorization: Bearer $ORIGINFOLD_API_KEY" \
  --data-urlencode "dataset_version=$DATASET_VERSION" \
  --data-urlencode "fields=$FIELDS" \
  --data-urlencode "entity_id=$ENTITY_ID" \
  --data-urlencode "start=$START_DATE" \
  --data-urlencode "end=$END_DATE" \
  --data-urlencode "as_of=$AS_OF" \
  --data-urlencode "limit=25"

See a complete illustrative HTTP and Python example, including what each request parameter means.

Field dictionary

nullable fields may be empty. An empty value is not zero. Types and definitions below come from the dataset schema; the released API may expose only a qualified subset.

Field	Type	Meaning
`dataset_id`	string	Logical dataset identifier.
`version_id`	uuidv7	Immutable origin candidate version for this row; incremental manifests may copy forward exact objects whose rows retain earlier origin versions.
`schema_version`	semver	Row schema version.
`chain_id`	string	Approved network identity; fixture work permits only bitcoin-mainnet.
`utc_date`	date	UTC aggregation period assigned by the method; never knowledge time.
`start_height`	int64	First canonical height in the complete UTC day.
`end_height`	int64	Last canonical height in the complete UTC day.
`start_block_hash`	hex32	Canonical first-block identity.
`end_block_hash`	hex32	Canonical last-block identity.
`block_count`	int64	Canonical blocks assigned to the day.
`block_interval_mean_seconds`	decimal128(38,12) May be empty	Arithmetic mean of signed canonical header-time deltas in seconds, including the first block against the canonical predecessor; null only when no predecessor exists.
`block_interval_median_seconds`	decimal128(38,12) May be empty	Median of signed canonical header-time deltas in seconds, including the first block against the canonical predecessor; null only when no predecessor exists.
`empty_block_count`	int64	Canonical blocks containing only their required coinbase transaction.
`transaction_count`	int64	Transactions in canonical blocks.
`segwit_transaction_count`	int64 May be empty	Non-coinbase witness-bearing transactions from exact per-block swtxs statistics; null when complete statistic coverage is unavailable.
`input_count`	int64 May be empty	Transaction inputs when supported by the approved method.
`output_count`	int64 May be empty	Transaction outputs when supported by the approved method.
`block_bytes`	int64 May be empty	Serialized block bytes.
`block_weight`	int64 May be empty	Consensus block weight units.
`transfer_volume_btc`	decimal128(38,8) May be empty	Raw non-coinbase output value; not economic or entity-adjusted volume.
`fees_btc`	decimal128(38,8)	Non-coinbase input value less non-coinbase output value.
`fee_rate_p10_sat_vb`	decimal128(38,12) May be empty	Nearest-rank p10 of the complete daily non-coinbase transaction fee/vsize distribution in sat/vB; null when the distribution is empty or incomplete.
`fee_rate_p25_sat_vb`	decimal128(38,12) May be empty	Nearest-rank p25 of the complete daily non-coinbase transaction fee/vsize distribution in sat/vB; null when the distribution is empty or incomplete.
`fee_rate_p50_sat_vb`	decimal128(38,12) May be empty	Nearest-rank p50 of the complete daily non-coinbase transaction fee/vsize distribution in sat/vB; null when the distribution is empty or incomplete.
`fee_rate_p75_sat_vb`	decimal128(38,12) May be empty	Nearest-rank p75 of the complete daily non-coinbase transaction fee/vsize distribution in sat/vB; null when the distribution is empty or incomplete.
`fee_rate_p90_sat_vb`	decimal128(38,12) May be empty	Nearest-rank p90 of the complete daily non-coinbase transaction fee/vsize distribution in sat/vB; null when the distribution is empty or incomplete.
`issuance_btc`	decimal128(38,8)	Actual coinbase subsidy, bounded by the protocol schedule.
`supply_btc`	decimal128(38,8)	Prior accepted supply plus daily issuance.
`difficulty`	decimal128(38,15)	Source-faithful Bitcoin Core difficulty at the last canonical block of the day; scale 15 preserves the maximum observed historical RPC precision without rounding.
`hashrate_estimate`	decimal128(38,12) May be empty	Always null until a typed, hash-bound calculation window is registered.
`utxo_count`	int64 May be empty	End-of-day UTXO count from predecessor-bound state.
`utxo_value_btc`	decimal128(38,8) May be empty	End-of-day UTXO value from predecessor-bound state.
`utxo_created_count`	int64 May be empty	Spendable outputs created during the complete day under the predecessor-bound UTXO policy; null outside approved historical state coverage.
`utxo_spent_count`	int64 May be empty	Previously unspent outputs consumed during the complete day under the predecessor-bound UTXO policy; null outside approved historical state coverage.
`utxo_created_value_btc`	decimal128(38,8) May be empty	Value of spendable outputs created during the complete day; null outside approved historical state coverage.
`utxo_spent_value_btc`	decimal128(38,8) May be empty	Value of previously unspent outputs consumed during the complete day; null outside approved historical state coverage.
`active_addresses`	int64 May be empty	Script/address heuristic count; never an entity count.
`new_addresses`	int64 May be empty	Method-versioned first-seen script/address heuristic.
`coin_days_destroyed`	decimal128(38,12) May be empty	Supported spent-output age measure.
`age_band_values`	json May be empty	Method-versioned end-of-day value by approved UTXO age band; null outside supported state history.
`method_version`	semver	Pinned daily metric method version.
`canonical_range_sha256`	sha256	Deterministic complete-day coverage, boundaries, method, and policy identity.
`policy_sha256`	sha256	Content digest of the exact period, finality, and reorg policy bundle.
`source_record_id`	string	Chain-specific bounded source record identity.
`source_id`	string May be empty	Approved source identity; null for source-free fixtures.
`source_ref`	uri May be empty	Official provider reference URL; never a mirrored source document.
`source_published_at`	timestamp_utc May be empty	Actually observed source or finality dissemination timestamp.
`availability_basis`	string	Evidence basis used for available_at.
`available_at`	timestamp_utc	Earliest time allowed by the documented availability evidence; never block time.
`finality_observed_at`	timestamp_utc May be empty	Actual observed confirmation evidence time, not reconstructed block time.
`finality_reference`	string May be empty	Confirmation policy and observed tip reference.
`ingested_at`	timestamp_utc	Successful bounded acquisition time.
`published_at`	timestamp_utc May be empty	Candidate activation time; null before publication.
`revision`	int32	Immutable reorg/correction supersession revision.
`quality_flags`	list[string]	Method, coverage, or quality caveats.

Understand observation time, availability and revisions · Limits and errors