Documentation / API reference / Pending Coldkey Swap
Get Pending Coldkey Swap
Reference
Last reviewed 2026-09-18
Returns pending coldkey swaps with old and new key information and their scheduled execution blocks. Records also include predicted execution timestamps.
Try it
Parameters
No parameters.
Responses
200 — Pending coldkey swaps retrieved successfully
| Field | Type | Required | Description |
|---|---|---|---|
data | array | Yes | |
data[].block_number | integer (int32) | Yes | |
data[].execution_block_number | integer (int32) | Yes | |
data[].new_coldkey | object, nullable | ||
data[].new_coldkey.hex | string | Yes | The hex format of the hot key |
data[].new_coldkey.ss58 | string | Yes | The SS58 format of the hot key |
data[].new_coldkey_hash | string, nullable | ||
data[].old_coldkey | object | Yes | |
data[].old_coldkey.hex | string | Yes | The hex format of the hot key |
data[].old_coldkey.ss58 | string | Yes | The SS58 format of the hot key |
data[].predicted_execution_timestamp | string (date-time) | Yes | |
data[].timestamp | string (date-time) | Yes | |
pagination | object | Yes | |
pagination.current_page | integer (int32) | Yes | |
pagination.next_page | integer (int32), nullable | ||
pagination.per_page | integer (int32) | Yes | |
pagination.prev_page | integer (int32), nullable | ||
pagination.total_items | integer (int32) | Yes | |
pagination.total_pages | integer (int32) | Yes |
Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Pending coldkey swaps not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.