API referenceSubnets
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
netuid*integer
Range
0 <= value <= 65535Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/subnets/0/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", "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}