Get Neuron Registrations

Endpoint

GET /api/subnet/neuron/registration/v1

Parameters

Name	In	Type	Required	Description
netuid	query	integer		Subnet
uid	query	integer		Neuron ID
hotkey	query	string		SS58 or hex format
coldkey	query	string		SS58 or hex format
block_number	query	integer		The exact block number
block_start	query	integer		Start of block range (inclusive)
block_end	query	integer		End of block range (inclusive)
timestamp_start	query	integer		Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive)
timestamp_end	query	integer		End of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive)
page	query	integer		The page number of the response.
limit	query	integer		The number of responses. max is 200,
order	query	—

Responses

200 — Subnet neuron registrations retrieved successfully

Media: application/json

Schema

{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "block_number",
          "timestamp",
          "netuid",
          "uid",
          "hotkey",
          "coldkey",
          "registration_cost"
        ],
        "properties": {
          "block_number": {
            "type": "integer",
            "format": "int32"
          },
          "coldkey": {
            "type": "object",
            "required": [
              "ss58",
              "hex"
            ],
            "properties": {
              "hex": {
                "type": "string",
                "description": "The hex format of the hot key"
              },
              "ss58": {
                "type": "string",
                "description": "The SS58 format of the hot key"
              }
            }
          },
          "hotkey": {
            "type": "object",
            "required": [
              "ss58",
              "hex"
            ],
            "properties": {
              "hex": {
                "type": "string",
                "description": "The hex format of the hot key"
              },
              "ss58": {
                "type": "string",
                "description": "The SS58 format of the hot key"
              }
            }
          },
          "netuid": {
            "type": "integer",
            "format": "int32"
          },
          "registration_cost": {
            "type": "string"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          },
          "uid": {
            "type": "integer",
            "format": "int32"
          }
        }
      }
    },
    "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\": 10,\n    \"total_items\": 6794,\n    \"total_pages\": 680,\n    \"next_page\": 2,\n    \"prev_page\": null\n  },\n  \"data\": [\n    {\n      \"block_number\": 4104101,\n      \"timestamp\": \"2024-10-23T06:05:36.001Z\",\n      \"netuid\": 19,\n      \"uid\": 251,\n      \"hotkey\": {\n        \"ss58\": \"5Cg4BHi4yvZWA6YPKgU48za4dpiiApSEoTsFuzmsYKRAzkpa\",\n        \"hex\": \"0x1af5fef0b561f372ed9c169623760312f048711359782e16a754835a8bd3174b\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5Fq3fe6XGeAoxV5tsRApee1YEvnKgBdxxvY6wHEPAvibsguY\",\n        \"hex\": \"0xa6862f1f35e4b636deb0cc9151c65305556cbc6f15ae046aa77e1999d666eb77\"\n      },\n      \"registration_cost\": \"277988201\"\n    },\n    {\n      \"block_number\": 4104100,\n      \"timestamp\": \"2024-10-23T06:05:24Z\",\n      \"netuid\": 19,\n      \"uid\": 5,\n      \"hotkey\": {\n        \"ss58\": \"5Dq8FeBwuRaANWuroMdzeBX6bmV17Fw77TBP8v3nodQjLT19\",\n        \"hex\": \"0x4e1d27e2eaf252e681eedc2518dd97a24a560e400ddfcf1e441a5afd57020659\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5Fq3fe6XGeAoxV5tsRApee1YEvnKgBdxxvY6wHEPAvibsguY\",\n        \"hex\": \"0xa6862f1f35e4b636deb0cc9151c65305556cbc6f15ae046aa77e1999d666eb77\"\n      },\n      \"registration_cost\": \"277988201\"\n    },\n    {\n      \"block_number\": 4104099,\n      \"timestamp\": \"2024-10-23T06:05:12.001Z\",\n      \"netuid\": 19,\n      \"uid\": 213,\n      \"hotkey\": {\n        \"ss58\": \"5EU6pWFyZ4diFUZmhSnYmpEKHuXMNByiW37qwCnfscENNHqp\",\n        \"hex\": \"0x6a506919291c4f62d1e41bbe914858fa932988ffa6660659490450e318472112\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5Fq3fe6XGeAoxV5tsRApee1YEvnKgBdxxvY6wHEPAvibsguY\",\n        \"hex\": \"0xa6862f1f35e4b636deb0cc9151c65305556cbc6f15ae046aa77e1999d666eb77\"\n      },\n      \"registration_cost\": \"277988201\"\n    },\n    {\n      \"block_number\": 4103853,\n      \"timestamp\": \"2024-10-23T05:16:00.004Z\",\n      \"netuid\": 19,\n      \"uid\": 14,\n      \"hotkey\": {\n        \"ss58\": \"5FZoCAxuRuwaFf7GztzY3Mh8EmwhQ5YUgyzGWWyn9gJgbdSo\",\n        \"hex\": \"0x9ae4c7d447b4aef6f702be14ed20127e6e35c38b540f0e80edb64dfc0b5e3c4a\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5FdzPyHbb3VpdUDayqAqKPJmeo2d6RgHrschpGVrsEc5fS9d\",\n        \"hex\": \"0x9e1779ee3aa2e08987a6abd286397d34e3ebc1a46529659db65a6af004b54c70\"\n      },\n      \"registration_cost\": \"231656687\"\n    },\n    {\n      \"block_number\": 4103848,\n      \"timestamp\": \"2024-10-23T05:15:00Z\",\n      \"netuid\": 19,\n      \"uid\": 79,\n      \"hotkey\": {\n        \"ss58\": \"5DAsAESAYVQUZPZdgn8Nsd5h9TBaXR3S9iLq2Sx8nbbvTrNb\",\n        \"hex\": \"0x30ef059fd31605759e882e4f831259f359d51cca54a52f505be38f3f46dfde41\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5FdzPyHbb3VpdUDayqAqKPJmeo2d6RgHrschpGVrsEc5fS9d\",\n        \"hex\": \"0x9e1779ee3aa2e08987a6abd286397d34e3ebc1a46529659db65a6af004b54c70\"\n      },\n      \"registration_cost\": \"231656687\"\n    },\n    {\n      \"block_number\": 4103841,\n      \"timestamp\": \"2024-10-23T05:13:36.001Z\",\n      \"netuid\": 19,\n      \"uid\": 249,\n      \"hotkey\": {\n        \"ss58\": \"5EkAkrKaZqg1xrrJre3wfvGsThsEp6sZCHsqmRNpXDVqGem2\",\n        \"hex\": \"0x76919712983bb969864739c36218dd4f03206efd988f06ea9a7b9db9facb7216\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5FdzPyHbb3VpdUDayqAqKPJmeo2d6RgHrschpGVrsEc5fS9d\",\n        \"hex\": \"0x9e1779ee3aa2e08987a6abd286397d34e3ebc1a46529659db65a6af004b54c70\"\n      },\n      \"registration_cost\": \"231656687\"\n    },\n    {\n      \"block_number\": 4102734,\n      \"timestamp\": \"2024-10-23T01:32:00.002Z\",\n      \"netuid\": 19,\n      \"uid\": 203,\n      \"hotkey\": {\n        \"ss58\": \"5G13PNXWYJKTe8FodZ9m3WUbo5sAPLkAk2MxsvQewcfhXqqj\",\n        \"hex\": \"0xae25b1a361f27c6c8e6d2fa09e51bc1eb25df6fc59dc9261417d2cf8aa4f5d08\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5FWMkqaRv5Yao8FT499g6kPBr4VT2tfGvmVXC6EKzP6xWLZn\",\n        \"hex\": \"0x98456a9e27dea72e9b97ca4406f4248c79e7bfc545092438ba41193a0dc80d58\"\n      },\n      \"registration_cost\": \"259996414\"\n    },\n    {\n      \"block_number\": 4102724,\n      \"timestamp\": \"2024-10-23T01:30:00.002Z\",\n      \"netuid\": 19,\n      \"uid\": 34,\n      \"hotkey\": {\n        \"ss58\": \"5Gixd55rgmZH58VSGaka8c4SRX4TKejpsjh7se3C7dFSTdj4\",\n        \"hex\": \"0xce1df6e85cb2db1c80322a370e2750864ba4e1360429581f5af863b9a8ade16e\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5FWMkqaRv5Yao8FT499g6kPBr4VT2tfGvmVXC6EKzP6xWLZn\",\n        \"hex\": \"0x98456a9e27dea72e9b97ca4406f4248c79e7bfc545092438ba41193a0dc80d58\"\n      },\n      \"registration_cost\": \"259996414\"\n    },\n    {\n      \"block_number\": 4101671,\n      \"timestamp\": \"2024-10-22T21:59:24.001Z\",\n      \"netuid\": 19,\n      \"uid\": 46,\n      \"hotkey\": {\n        \"ss58\": \"5FmvgW8HJ6k6wGNZ4DmSYofLAZsetbrMKiDzLA9f2m7JWe9T\",\n        \"hex\": \"0xa424ef0ee318c189377b44d9d5234cd55f600be995096adeeb5fc27d27f06903\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5Fq3fe6XGeAoxV5tsRApee1YEvnKgBdxxvY6wHEPAvibsguY\",\n        \"hex\": \"0xa6862f1f35e4b636deb0cc9151c65305556cbc6f15ae046aa77e1999d666eb77\"\n      },\n      \"registration_cost\": \"267486081\"\n    },\n    {\n      \"block_number\": 4101670,\n      \"timestamp\": \"2024-10-22T21:59:12Z\",\n      \"netuid\": 19,\n      \"uid\": 64,\n      \"hotkey\": {\n        \"ss58\": \"5CfJ5wke5jHEo5C8mYo2yY9KcTaVSsQPw72kRg92r6oaiR4h\",\n        \"hex\": \"0x1a61918887420706bba6125c9e0ee8dda6e7d75bdd16f2c38256036e44f40156\"\n      },\n      \"coldkey\": {\n        \"ss58\": \"5Fq3fe6XGeAoxV5tsRApee1YEvnKgBdxxvY6wHEPAvibsguY\",\n        \"hex\": \"0xa6862f1f35e4b636deb0cc9151c65305556cbc6f15ae046aa77e1999d666eb77\"\n      },\n      \"registration_cost\": \"267486081\"\n    }\n  ]\n}"
  }
}

400 — Bad request

404 — Subnet neuron registrations 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.