Get Staking/Delegation Events

Endpoint

GET /api/delegation/v1

Try it

Fills the fields below — runs automatically if your API key is saved.

API key

👁

Remember on this browser Get a free API key →

cURLTypeScriptPythonSDK

Run

nominatorSS58 or hex formatdelegateSS58 or hex formatis_transferIs this a transfer?transfer_addressSS58 or hex formatextrinsic_idID of extrinsicamount_minMinimum amount (inclusive)amount_maxMaximum amount (inclusive)netuidSubnetblock_numberThe exact block numberblock_startStart of block range (inclusive)block_endEnd of block range (inclusive)timestamp_startStart of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive)timestamp_endEnd of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive)pageThe page number of the response.limitThe number of responses. max is 200,

curlCopy

Parameters

Name	In	Type	Required	Description
nominator	query	string		SS58 or hex format
delegate	query	string		SS58 or hex format
action	query	—		Delegation or undelegation (or both)?
is_transfer	query	boolean		Is this a transfer?
transfer_address	query	string		SS58 or hex format
extrinsic_id	query	string		ID of extrinsic
amount_min	query	string		Minimum amount (inclusive)
amount_max	query	string		Maximum amount (inclusive)
netuid	query	integer		Subnet
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 — Delegations retrieved successfully

Media: application/json

Schema

{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "block_number",
          "timestamp",
          "action",
          "nominator",
          "delegate",
          "amount"
        ],
        "properties": {
          "action": {
            "type": "string"
          },
          "alpha": {
            "type": "string",
            "nullable": true
          },
          "alpha_price_in_tao": {
            "type": "string",
            "nullable": true
          },
          "alpha_price_in_usd": {
            "type": "string",
            "nullable": true
          },
          "amount": {
            "type": "string"
          },
          "block_number": {
            "type": "integer",
            "format": "int32"
          },
          "delegate": {
            "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"
              }
            }
          },
          "delegate_name": {
            "type": "string",
            "nullable": true
          },
          "extrinsic_id": {
            "type": "string",
            "nullable": true
          },
          "fee": {
            "type": "string",
            "nullable": true
          },
          "id": {
            "type": "string"
          },
          "is_transfer": {
            "type": "boolean",
            "nullable": true
          },
          "netuid": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "nominator": {
            "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"
              }
            }
          },
          "slippage": {
            "type": "string",
            "nullable": true
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          },
          "transfer_address": {
            "allOf": [
              {
                "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"
                  }
                }
              }
            ],
            "nullable": true
          },
          "usd": {
            "type": "string",
            "nullable": true
          }
        }
      }
    },
    "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\": 5,\n    \"total_items\": 26986,\n    \"total_pages\": 5398,\n    \"next_page\": 2,\n    \"prev_page\": null\n  },\n  \"data\": [\n    {\n      \"nominator\": {\n        \"ss58\": \"5C59JBL8eYacZPeDA5LYCjTd7BKNHE44hG8hsE9DmkFwefMR\",\n        \"hex\": \"0x0055a35aba61dfc8dd56c131302e98230bfdc2191c67bd300e651adaf44b4e20\"\n      },\n      \"delegate\": {\n        \"ss58\": \"5HEo565WAy4Dbq3Sv271SAi7syBSofyfhhwRNjFNSM2gP9M2\",\n        \"hex\": \"0xe4df2c7397e1443378b4cec0f2fca9dac1d0923d020e7aab11dd41428014ab59\"\n      },\n      \"block_number\": 4106750,\n      \"timestamp\": \"2024-10-23T14:55:36.004Z\",\n      \"balance\": \"262028445567403\",\n      \"delegate_from\": 252183,\n      \"delegate_from_timestamp\": \"2023-04-24T19:25:36.001Z\"\n    },\n    {\n      \"nominator\": {\n        \"ss58\": \"5FRqwexkxqXLg4frDhGKM6rCw2y32JWojQ6JV6zBgzhnhq7r\",\n        \"hex\": \"0x94d412dc09782a38b2dd3fef97b96b8245b1b96843559fe89592c88ed3bb6531\"\n      },\n      \"delegate\": {\n        \"ss58\": \"5FxcZraZACr4L78jWkcYe3FHdiwiAUzrKLVtsSwkvFobBKqq\",\n        \"hex\": \"0xac4ba7704623c5beb4950ef97ddea57c9c12b91938c86f28475f8050741ac956\"\n      },\n      \"block_number\": 4106750,\n      \"timestamp\": \"2024-10-23T14:55:36.004Z\",\n      \"balance\": \"202513253736495\",\n      \"delegate_from\": 3791750,\n      \"delegate_from_timestamp\": \"2024-09-09T20:14:48Z\"\n    },\n    {\n      \"nominator\": {\n        \"ss58\": \"5EU92KqB1wwvkHonEzZktPRt7FxkUxPa9vY5kgNtJSCr39hs\",\n        \"hex\": \"0x6a57d4453c26629b4105379402cb7d5c9224f50576a1c5c1611b8acd26f9e168\"\n      },\n      \"delegate\": {\n        \"ss58\": \"5FxcZraZACr4L78jWkcYe3FHdiwiAUzrKLVtsSwkvFobBKqq\",\n        \"hex\": \"0xac4ba7704623c5beb4950ef97ddea57c9c12b91938c86f28475f8050741ac956\"\n      },\n      \"block_number\": 4106750,\n      \"timestamp\": \"2024-10-23T14:55:36.004Z\",\n      \"balance\": \"155773243407128\",\n      \"delegate_from\": 3791750,\n      \"delegate_from_timestamp\": \"2024-09-09T20:14:48Z\"\n    },\n    {\n      \"nominator\": {\n        \"ss58\": \"5EaBdmkhnzamcWTHBmNyFqB4JJtG4AMg2yYteDMrmFVw1S7o\",\n        \"hex\": \"0x6ef4176eee0a17e68b4f32242af30adae6afecfa6122a090c0d1c91ad948964f\"\n      },\n      \"delegate\": {\n        \"ss58\": \"5HEo565WAy4Dbq3Sv271SAi7syBSofyfhhwRNjFNSM2gP9M2\",\n        \"hex\": \"0xe4df2c7397e1443378b4cec0f2fca9dac1d0923d020e7aab11dd41428014ab59\"\n      },\n      \"block_number\": 4106750,\n      \"timestamp\": \"2024-10-23T14:55:36.004Z\",\n      \"balance\": \"92261837157473\",\n      \"delegate_from\": 72638,\n      \"delegate_from_timestamp\": \"2023-03-30T20:56:36.004Z\"\n    },\n    {\n      \"nominator\": {\n        \"ss58\": \"5HiveMEoWPmQmBAb8v63bKPcFhgTGCmST1TVZNvPHSTKFLCv\",\n        \"hex\": \"0xfa538a1f58eb874d88632a329bc3e6423be5f7da88c1133e4b4d5ed1f3f1ce05\"\n      },\n      \"delegate\": {\n        \"ss58\": \"5Hp18g9P8hLGKp9W3ZDr4bvJwba6b6bY3P2u3VdYf8yMR8FM\",\n        \"hex\": \"0xfe32e033f4c4b81bf0f1d2a35f3d2818a7e3fcb4464d54e6819b4d9ef9117a6a\"\n      },\n      \"block_number\": 4106750,\n      \"timestamp\": \"2024-10-23T14:55:36.004Z\",\n      \"balance\": \"91263910429186\",\n      \"delegate_from\": 2955508,\n      \"delegate_from_timestamp\": \"2024-05-14T13:59:12.001Z\"\n    }\n  ]\n}"
  }
}

400 — Bad request

404 — Delegations not found

500 — Internal server error

Authentication

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