Latest aggregated neuron stats (per subnet)

Description

Returns the latest per-subnet aggregated neuron statistics — one row per netuid at the latest indexed block. Each row summarises the metagraph without pulling every UID: immune_count, incentive bands (max_incentive, max_immune_incentive, min_non_immune_incentive, max_danger_incentive), pruning-score bands (max_pruning_score, max_immune_pruning_score, max_mining_pruning_score, min_non_immune_pruning_score, max_danger_pruning_score) and the incentive and pruning score of the most recently deregistered neuron (last_dereg_incentive, last_dereg_pruning_score).

Use this to monitor registration pressure and immunity thresholds on a subnet without paging through the full metagraph. See /api/neuron/aggregated/history/v1 for the same fields over time.

Endpoint

GET /api/neuron/aggregated/latest/v1

Parameters

Name	In	Type	Required	Description
netuid	query	integer		Subnet ID
page	query	integer
limit	query	integer
order	query	—

Responses

200 — Neuron retrieved successfully

Media: application/json

Schema

{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "block_number",
          "timestamp",
          "netuid",
          "immune_count",
          "max_immune_incentive",
          "max_incentive",
          "min_non_immune_incentive",
          "max_danger_incentive",
          "max_immune_pruning_score",
          "max_mining_pruning_score",
          "max_pruning_score",
          "min_non_immune_pruning_score",
          "max_danger_pruning_score",
          "last_dereg_incentive",
          "last_dereg_pruning_score"
        ],
        "properties": {
          "block_number": {
            "type": "integer",
            "format": "int32"
          },
          "immune_count": {
            "type": "integer",
            "format": "int32"
          },
          "last_dereg_incentive": {
            "type": "string"
          },
          "last_dereg_pruning_score": {
            "type": "string"
          },
          "max_danger_incentive": {
            "type": "string"
          },
          "max_danger_pruning_score": {
            "type": "string"
          },
          "max_immune_incentive": {
            "type": "string"
          },
          "max_immune_pruning_score": {
            "type": "string"
          },
          "max_incentive": {
            "type": "string"
          },
          "max_mining_pruning_score": {
            "type": "string"
          },
          "max_pruning_score": {
            "type": "string"
          },
          "min_non_immune_incentive": {
            "type": "string"
          },
          "min_non_immune_pruning_score": {
            "type": "string"
          },
          "netuid": {
            "type": "integer",
            "format": "int32"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      }
    },
    "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"
        }
      }
    }
  }
}

400 — Bad request

404 — Neuron 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.