Skip to content

Get Subnet Miner Incentive Distribution

Endpoint

GET /api/subnet/distribution/incentive/v1

Parameters

Name	In	Type	Required	Description
`netuid`	query	`integer`	✅	Subnet

Responses

`200` — Subnet incentive distribution retrieved successfully

Media: application/json

Schema

{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "block_number",
          "incentive",
          "is_immunity_period"
        ],
        "properties": {
          "block_number": {
            "type": "integer",
            "format": "int32"
          },
          "incentive": {
            "type": "string"
          },
          "is_immunity_period": {
            "type": "boolean"
          }
        }
      }
    },
    "pagination": {
      "type": "object",
      "required": [
        "current_page",
        "per_page",
        "total_items",
        "total_pages"
      ],
      "properties": {
        "current_page": {
          "type": "integer",
          "format": "int32"
        },
        "next_page": {
          "type": "integer",
          "format": "int32",
          "nullable": true
        },
        "per_page": {
          "type": "integer",
          "format": "int32"
        },
        "prev_page": {
          "type": "integer",
          "format": "int32",
          "nullable": true
        },
        "total_items": {
          "type": "integer",
          "format": "int32"
        },
        "total_pages": {
          "type": "integer",
          "format": "int32"
        }
      }
    }
  }
}

Examples

{
  "Result": {
    "value": "{\n  \"pagination\": {\n    \"current_page\": 1,\n    \"per_page\": 98,\n    \"total_items\": 98,\n    \"total_pages\": 1,\n    \"next_page\": null,\n    \"prev_page\": null\n  },\n  \"data\": [\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.19053940642404821851\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.16380560006103608759\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.16131837949187457084\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.13025101091020065614\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.10283054856183718624\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.04675364309147783627\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.0421454184786755169\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.03018234531166552224\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.02853437094682230869\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.0218814373998626688\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.02006561379415579461\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00912489509422446021\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00823987182421606775\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00738536659800106813\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00683604180971999695\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00666819256885633631\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00488288700694285496\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00431830319676508736\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00248722056916151675\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00221255817502098116\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00151064316777294575\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00120546272983901732\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00111390859845883879\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00096131837949187457\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00064087891966124971\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00054932478828107118\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00051880674448767834\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00051880674448767834\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00041199359121080339\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00036621652552071412\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00032043945983062486\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00025940337224383917\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00019836728465705348\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00019836728465705348\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00010681315327687495\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00009155413138017853\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00007629510948348211\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00003051804379339284\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00003051804379339284\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00001525902189669642\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00001525902189669642\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00001525902189669642\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0.00001525902189669642\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": true\n    },\n    {\n      \"block_number\": 4107396,\n      \"incentive\": \"0\",\n      \"is_immunity_period\": false\n    }\n  ]\n}"
  }
}

`400` — Bad request

`404` — Subnet incentive distribution not found

`500` — Internal server error

Try it

Interactive request console coming soon. In the meantime you can use the OpenAPI spec with any client (Insomnia, Bruno, Scalar, curl).

Authentication

All Taostats API requests require an Authorization header containing your API key. See Getting Started.