Get Metagraph History
Endpoint
Section titled “Endpoint”GET /api/metagraph/history/v1Parameters
Section titled “Parameters”| Name | In | Type | Required | Description |
|---|---|---|---|---|
netuid | query | integer | Subnet ID | |
uid | query | integer | Neuron ID | |
hotkey | query | string | SS58 or hex format | |
coldkey | query | string | SS58 or hex format | |
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
Section titled “Responses”200 — Metagraph history retrieved successfully
Section titled “200 — Metagraph history retrieved successfully”Media: application/json
Schema
{ "type": "object", "required": [ "pagination", "data" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "hotkey", "coldkey", "netuid", "uid", "block_number", "timestamp", "stake", "trust", "validator_trust", "consensus", "incentive", "mech_incentive", "dividends", "emission", "active", "validator_permit", "updated", "mech_updated", "daily_reward", "registered_at_block", "is_immunity_period", "rank", "is_child_key", "root_weight", "alpha_stake", "root_stake", "root_stake_as_alpha", "total_alpha_stake" ], "properties": { "active": { "type": "boolean" }, "alpha_stake": { "type": "string" }, "axon": { "nullable": true }, "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" } } }, "consensus": { "type": "string" }, "daily_burned_alpha": { "type": "string", "description": "mining emission burned by owner hotkey", "nullable": true }, "daily_burned_alpha_as_tao": { "type": "string", "description": "mining emission burned by owner hotkey denominated in tao", "nullable": true }, "daily_mining_alpha": { "type": "string", "description": "post dtao mining alpha", "nullable": true }, "daily_mining_alpha_as_tao": { "type": "string", "description": "post dtao mining alpha denominated in tao", "nullable": true }, "daily_mining_tao": { "type": "string", "description": "pre dtao mining emission", "nullable": true }, "daily_owner_alpha": { "type": "string", "description": "owner cut of alpha emission", "nullable": true }, "daily_owner_alpha_as_tao": { "type": "string", "description": "owner cut of alpha emission denominated in tao", "nullable": true }, "daily_reward": { "type": "string", "description": "deprecated" }, "daily_total_rewards_as_tao": { "type": "string", "description": "total rewards denominated in tao", "nullable": true }, "daily_validating_alpha": { "type": "string", "description": "validating alpha emission", "nullable": true }, "daily_validating_alpha_as_tao": { "type": "string", "description": "validating alpha emission denominated in tao", "nullable": true }, "daily_validating_tao": { "type": "string", "description": "validating tao emission (post dtao this is root dividends, pre dtao this is all dividends)", "nullable": true }, "dividends": { "type": "string" }, "emission": { "type": "string" }, "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" } } }, "incentive": { "type": "string" }, "is_child_key": { "type": "boolean" }, "is_immunity_period": { "type": "boolean" }, "is_owner_hotkey": { "type": "boolean", "nullable": true }, "mech_incentive": { "type": "array", "items": { "type": "string" } }, "mech_updated": { "type": "array", "items": { "type": "integer", "format": "int32" } }, "netuid": { "type": "integer", "format": "int32" }, "rank": { "type": "integer", "format": "int32" }, "registered_at_block": { "type": "integer", "format": "int32" }, "root_stake": { "type": "string" }, "root_stake_as_alpha": { "type": "string" }, "root_weight": { "type": "string" }, "stake": { "type": "string" }, "timestamp": { "type": "string", "format": "date-time" }, "total_alpha_stake": { "type": "string" }, "trust": { "type": "string" }, "uid": { "type": "integer", "format": "int32" }, "updated": { "type": "integer", "format": "int32" }, "validator_permit": { "type": "boolean" }, "validator_trust": { "type": "string" } } } }, "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\": 2,\n \"total_items\": 5205444,\n \"total_pages\": 2602722,\n \"next_page\": 2,\n \"prev_page\": null\n },\n \"data\": [\n {\n \"hotkey\": {\n \"ss58\": \"5FP5ADUSBNpmtRiQd2rtjVcQs3Emc5b1rMbiatxRYJ7gWJHn\",\n \"hex\": \"0x92b6d40fe7134903eef7f9b3f5ab06fe24008326cb189c30e0c17b3150116c45\"\n },\n \"coldkey\": {\n \"ss58\": \"5F1wvhbYNdq7E7tMsaUdHRXy462nbUNnMurihtNrZ8zMSoF3\",\n \"hex\": \"0x829a538c77776782639b69c9b6e97c326295e6285bd94fa6e5a03f61fcadb733\"\n },\n \"netuid\": 10,\n \"uid\": 145,\n \"block_number\": 4207460,\n \"timestamp\": \"2024-11-06T15:33:24.001Z\",\n \"stake\": \"497653819\",\n \"trust\": \"0.98957808804455634394\",\n \"validator_trust\": \"0\",\n \"consensus\": \"0.00419623102159151598\",\n \"incentive\": \"0.00422674906538490883\",\n \"dividends\": \"0\",\n \"emission\": \"12306971\",\n \"active\": false,\n \"validator_permit\": false,\n \"updated\": 1320571,\n \"daily_reward\": \"246139420\",\n \"registered_at_block\": 4144278,\n \"is_immunity_period\": false,\n \"rank\": 110,\n \"is_child_key\": false,\n \"axon\": {\n \"block\": 3854601,\n \"ip\": \"13.248.142.17\",\n \"ipType\": 4,\n \"placeholder1\": 0,\n \"placeholder2\": 0,\n \"port\": 8097,\n \"protocol\": 4,\n \"version\": 711\n }\n },\n {\n \"hotkey\": {\n \"ss58\": \"5HpzgWFbyJX7DnauCnSzrRroPxmYiv8azwXGWwZMiRUwHsBP\",\n \"hex\": \"0xfef49a2e2487dccef370fb090a7723f5a0673ee4e30cc568c7a8f4701583711d\"\n },\n \"coldkey\": {\n \"ss58\": \"5CXDTb3cSxSvhfdB7Xk7hzxRkwKdCi2AZhvKFejtJvD5EwxS\",\n \"hex\": \"0x143807a7dcfb4a7c4883110d7aa060d09de5dddd40a53be80c380842d63b374b\"\n },\n \"netuid\": 15,\n \"uid\": 123,\n \"block_number\": 4207460,\n \"timestamp\": \"2024-11-06T15:33:24.001Z\",\n \"stake\": \"0\",\n \"trust\": \"0.97795071335927367056\",\n \"validator_trust\": \"0\",\n \"consensus\": \"0.00425726710917830167\",\n \"incentive\": \"0.00421149004348821241\",\n \"dividends\": \"0\",\n \"emission\": \"1650041\",\n \"active\": false,\n \"validator_permit\": false,\n \"updated\": 467707,\n \"daily_reward\": \"33000820\",\n \"registered_at_block\": 4157209,\n \"is_immunity_period\": false,\n \"rank\": 0,\n \"is_child_key\": false,\n \"axon\": {\n \"block\": 4157211,\n \"ip\": \"103.252.0.169\",\n \"ipType\": 4,\n \"placeholder1\": 0,\n \"placeholder2\": 0,\n \"port\": 15107,\n \"protocol\": 4,\n \"version\": 7003001\n }\n }\n ]\n}" }}400 — Bad request
Section titled “400 — Bad request”404 — Metagraph history not found
Section titled “404 — Metagraph history not found”500 — Internal server error
Section titled “500 — Internal server error”Try it
Section titled “Try it”Interactive request console coming soon. In the meantime you can use the OpenAPI spec with any client (Insomnia, Bruno, Scalar, curl).
Authentication
Section titled “Authentication”All Taostats API requests require an Authorization header containing your API key. See Getting Started.