Subnet Revenue
Last updated
Fetch one subnet's external revenue against the TAO the network emits to it: the measured tao_total denominator with its alternates, the observed revenue, and the two ratios. coverage_ratio and subsidy_multiple are NULL whenever revenue is not observed -- the normal case for 126 of 128 subnets -- and a client must render null as 'not observed', never as 0%. Only chain-verified and probe-derived contribute to the headline; every declared surface is listed in sources with its own provenance. verification.verified false means the response is not defensible.
Path Parameters
The subnet's numeric id on the Bittensor network, as used by the chain itself.
0 <= value <= 65535Query Parameters
Trailing lookback window the response is computed over, ending at the most recent data point rather than at today. Accepts 1d, 7d, 30d. A longer window is not a superset of a shorter one -- rankings and rates are recomputed over the whole window, not summed.
"1d"Value in
- "1d"
- "7d"
- "30d"
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/subnets/1/revenue"{ "data": { "contract_version": "2026-06-29.1", "field_sources": { "example": { "kind": "measured", "storage": "example" } }, "generated_at": "2026-06-01T00:00:00.000Z", "netuid": 7, "notes": "Example description.", "revenue": { "coverage_ratio": 0.9966, "emission": { "alternates": { "alpha_out_priced": { "tao": 0.5, "usd": 0.5 }, "owner_take": { "tao": 0.5, "usd": 0.5 } }, "basis": "tao_total", "tao": 0.5, "usd": 0.5 }, "netuid": 7, "provenance": "chain-verified", "revenue_usd": 0.5, "searched_at": "2026-06-01T00:00:00.000Z", "sources": [ { "amount_usd": 0.5, "contributes": false, "currency": "example", "excluded_reason": "example", "grain": "example", "provenance": "chain-verified", "surface_id": "example" } ], "subsidy_multiple": 0.5, "verification": { "checks": [ { "detail": "example", "name": "Example Subnet", "ok": true } ], "verified": false }, "window_days": 1 }, "schema_version": 1 }, "meta": { "artifact_path": "example", "cache": "short", "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, "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}