Skip to main content
API referenceChain

Chain Revenue Coverage

Last updated

GET
/api/v1/chain/revenue-coverage

Fetch every subnet's revenue coverage in one response. observed_count against subnet_count states how much of the network has a readable revenue figure at all. Subnets with no observed revenue are included with null ratios rather than dropped.

Query Parameters

window?string

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.

Default"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/chain/revenue-coverage"
{  "data": {    "contract_version": "2026-06-29.1",    "generated_at": "2026-06-01T00:00:00.000Z",    "notes": "Example description.",    "observed_count": 1,    "schema_version": 1,    "subnet_count": 1,    "subnets": [      {        "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,        "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      }    ],    "window_days": 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}