API referenceSubnets
Economics Trends
Last updated
Last updated
Fetch the network-wide economics time series (#1307): per UTC day across all subnets — total stake, stake-weighted + median alpha price, total validator/miner counts, and mean emission share — aggregated live from the daily subnet_snapshots rollup. mean_emission_share averages the legacy snapshot values. Artifact-normalized moving-price share: alpha_price_tao divided by the sum of reported alpha prices, including Root when Root reports a price. Legacy snapshot rows do not retain the historical runtime eligibility inputs needed to certify v440 Stage 1. This is neither a verified runtime Stage-1 share nor final TAO emission. For the separately reconstructed, pinned live pipeline, use /api/v1/chain/emission-pipeline and inspect verification.verified. The rollup is the same source the per-subnet /trajectory reads. ?window=7d|30d|90d|1y|all (default 30d). Pass ?format=csv to download the per-day series as CSV. Served live (no static file); day_count:0 / days:[] when the rollup is cold.
Trailing lookback window the response is computed over, ending at the most recent data point rather than at today. Accepts 7d, 30d, 90d, 1y, all. A longer window is not a superset of a shorter one -- rankings and rates are recomputed over the whole window, not summed.
"30d"Value in
Response format override. Use csv to download the route rows as text/csv; json keeps the default response envelope.
"json"Value in
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/economics/trends"{ "data": { "day_count": 1, "days": [ { "snapshot_date": "example", "subnet_count": 1 } ], "field_sources_usd": { "kind": "reconstructed", "storage": null }, "priced_day_count": 1, "schema_version": 1, "usd_available_from": "example", "usd_unavailable": "no_index_reading", "window": "30d" }, "meta": { "artifact_path": "example", "cache": "short", "catalog_paging": { "reason": "catalog_changed" }, "contract_version": "2026-06-29.1", "generated_at": "2026-06-01T00:00:00.000Z", "observed_through": "2026-06-01T00:00:00.000Z", "pagination": { "collection": "example", "cursor": 1, "limit": 1, "next_cursor": 1, "order": "asc", "returned": 1, "snapshot": "v1.a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1a3f1", "sort": "example", "total": 1 }, "published_at": "2026-06-01T00:00:00.000Z", "source": "live-cron-prober", "stale_contract": { "built_under": "example", "live": "example" } }, "ok": true, "schema_version": 1}