Get Subnet Coldkey Distribution

Endpoint

GET /api/subnet/distribution/coldkey/v1

Parameters

Name	In	Type	Required	Description
netuid	query	integer	✅	Subnet

Responses

200 — Subnet coldkey distribution retrieved successfully

Media: application/json

Schema

{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "coldkey",
          "count"
        ],
        "properties": {
          "coldkey": {
            "type": "string"
          },
          "count": {
            "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\": 42,\n    \"total_items\": 42,\n    \"total_pages\": 1,\n    \"next_page\": null,\n    \"prev_page\": null\n  },\n  \"data\": [\n    {\n      \"coldkey\": \"5GcCZ2BPXBjgG88tXJCEtkbdg2hNrPbL4EFfbiVRvBZdSQDC\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5GZSAgaVGQqegjhEkxpJjpSVLVmNnE2vx2PFLzr7kBBMKpGQ\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5EJAqczgzCMvWcmXhKMZH4vMS5gPy8BjeuHjz5o5yN6RYzX2\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5DSsZGwBuYHRDA7HzdZUVBhKKpZpJKcf7rTd9y5Gz1SQyo9V\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5CeyfrsRXb8VPEhncMWn5kvSfdnjYT5b5DVbYhPH1iSbh7PF\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5E57Cwmz3i22Ur3bPE85GEu1TAc7kqVNMSH1TSmbdqhYAtAJ\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5FyQ3Uk6XZ1ZqDABxgj2MDwWeGvdqGBzEjG8FwLRPZZB944x\",\n      \"count\": 18\n    },\n    {\n      \"coldkey\": \"5H9DUeD9dXJ1gR9n5sALzioXyiQFv5Du2WAtTk75D7XrhJc4\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5DGC317Gcgk5CssSDRWuQnLM5Y9jMXD9qCvtqkzTAj9EMeEs\",\n      \"count\": 10\n    },\n    {\n      \"coldkey\": \"5CkQfj6TELnZ1hEJ9n2qhgz4ZL1dKLQgY2TLT49eUSFvaGbj\",\n      \"count\": 4\n    },\n    {\n      \"coldkey\": \"5DvE2p4dphf6957yNbG6D7PLf3DyD1x13GG2f2sw1G684MFA\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5HJzxg1twojgGzbrVUsazTLaQpBd4UXJBzDYm2TM5Vbx7NX4\",\n      \"count\": 9\n    },\n    {\n      \"coldkey\": \"5CJE8MMc5wKZQiSg4e6u5T8JGYxRJJtBfPBndvkwEk3456TT\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5Gb9JY6yRMyLfpDJrE8xThcy1u9k1Tw87qVro26gewykFfAg\",\n      \"count\": 3\n    },\n    {\n      \"coldkey\": \"5Ev2TtHz4NYmRrnCtzhAWpNevLfWPNzCGo2ts3X1Ew25jBqY\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5CBDdgmENSXxy1p5wbeudxe6MWhYvK5TxjkU9SAuszBf4itp\",\n      \"count\": 2\n    },\n    {\n      \"coldkey\": \"5GnSzwEo1sdSHN1tZiGnuQiV19VVa65FxDawvmcMzCfwJLxt\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5HbjiAxifRtcSwBHkBjLXJQ8MDmfjnuZ1n431fjNEBaQot8h\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5CrAR5JVZFmGNCUDGxiupHdXLChUMHA3rodZ9qGeKmAazQU7\",\n      \"count\": 5\n    },\n    {\n      \"coldkey\": \"5DoCMNbwezNT5sB5pPRJe3ep9fVjiDXvvkCeLAWEnqVEZjWu\",\n      \"count\": 7\n    },\n    {\n      \"coldkey\": \"5F9GU8fHDLCybz8tBXt31nto1iUEmChLagT3DWnGF6tP464T\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5Gp5aEVNooUDPrQDQ9DrgwHTxZkqukMJX3Fz2yXu18MPfJyf\",\n      \"count\": 9\n    },\n    {\n      \"coldkey\": \"5CcEzF1bbiqv2DHUVsZx2jc2ChLG2fPAHsCDF71YCjaZz3WV\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5HMqpSzZ8uB1QrAydXSGZJF9PztyCpq77y5S8vxj1cXAtg9d\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5E5KhUtmYVt7XSC3MwYUQDtMhRwu3bWzifRV2sLdSoRnReLq\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5Gzj23kovxJd64djc7sf4TJsc315DNfzcnKAtzb8iRc9hhv5\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5ER7beBE3mGArynZ98URK9AnB1V7ebvey1WPPWoMTsJfMzUq\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5Cth3nzMqLUJH3H19uBsBzJUvDFWQZyTfwaoH8Q3fcGZXtqH\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5DWrTjXo3nvbPsnPkT3bu4SbdfL4qggH4JFbQiPYEbMUiRNs\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5Dk7NP2jNE7KKEpFGmzZZdEJCv2xaSChqDezXj18QCBgmjwh\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5HYjMt6MQDyFztZasQGyqvJPYL2NXXp1p8i3xTsg9cNjZhyw\",\n      \"count\": 2\n    },\n    {\n      \"coldkey\": \"5HgHZnHjENhPcMQ773FeTXuK1CuBkgk3eUdhCxLRomjNhAt1\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5Hmq8DPz3Hs6LASEWGFSfcfzGAA4YMoq189eqkEUScseukgp\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5Ct1UtYKogEYtEqA9bEP5gT13RtNDCMdaWLzwWXT2mRn9m1d\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5H8XgeEHysDRH1zUsYiA2SFRV2jUUMPFp14QxYmuEXSMmDsd\",\n      \"count\": 3\n    },\n    {\n      \"coldkey\": \"5HgYnzr7BXLXfYzA6i5XNX6S2skFbS6HhKYQeFmu3eQTTfAj\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5GVvvoD366ZNik8A6JNxV4WrT1zftmJbQ45EjBrZUCnNpq3a\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5HeYjWJmEZzGoew8WNTR74Hy6Yq4DrRMu65ZHSUbCgbgzwJg\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5FjxZNzDmvw2aoBEUXUEiLCdR9aoYxfattuodmpi4Z44W6A2\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5EHGTkF6jgQAyqiSudswrioLzZmVYSaVtZG4V9cEFqQ3QHL9\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5F9kCsmo5NfFJqh1vxLENdLH5SYFCSaPCJPwbYRhgTnLXhVa\",\n      \"count\": 1\n    },\n    {\n      \"coldkey\": \"5CVF8oDaEcpYn4XCB1fSt7ph33scaUsRVzRsuZzbtik1nx2t\",\n      \"count\": 1\n    }\n  ]\n}"
  }
}

400 — Bad request

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