Skip to main content
API referenceSubnets

Subnet Owner Cut

Last updated

GET
/api/v1/subnets/{netuid}/owner-cut

Fetch one subnet's owner-cut accrual and its disposition. The share is 18% (SubnetOwnerCut is 11796/65535, not one sixth) and is echoed on the response so nobody has to assume it. READ disposition.buckets.unresolved AND disposition.reconciles BEFORE citing any of this: the cut is paid as stake rather than as a liquid balance, so where it went is frequently not determinable from what we index, and unresolved is a first-class answer rather than a failure. The buckets are not balanced to tie -- residual_alpha reports what is unaccounted for, and a negative residual means the parts exceed the whole. Never 404s.

Path Parameters

netuid*integer
Range0 <= value <= 65535

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/subnets/0/owner-cut"
{  "data": {    "accrual": {      "accrues": false,      "alpha": 0.5,      "owner_cut": 0.5,      "reason": "example",      "tao": 0.5,      "usd": 0.5    },    "contract_version": "2026-06-29.1",    "disposition": {      "accrued_alpha": 0.5,      "buckets": {        "burned": 0.5,        "held-as-stake": 0.5,        "transferred-out": 0.5,        "unresolved": 0.5,        "unstaked": 0.5      },      "notes": [        "Example description."      ],      "reconciles": false,      "residual_alpha": 0.5    },    "field_sources": {      "example": {        "kind": "measured",        "storage": "example"      }    },    "generated_at": "2026-06-01T00:00:00.000Z",    "netuid": 7,    "notes": "Example description.",    "owner_coldkey": "example",    "owner_hotkey": "example",    "schema_version": 1,    "window_days": 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}