List History
Miners
List History
Returns historical performance data for a specific miner
GET
List History
Authorizations
Clerk Machine API Key for authentication
Query Parameters
Page number (default: 1)
Required range:
x >= 1Example:
1
Number of items per page (default: 10, max: 10000)
Required range:
1 <= x <= 10000Example:
10
Start time for the history data in ISO 8601 format with timezone offset.
Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$Example:
"2025-09-06T00:00:00Z"
End time for the history data in ISO 8601 format with timezone offset.
Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$Example:
"2025-09-07T00:00:00Z"
Time resolution of the returned snapshots.
10min: max range 1 day (144 data points). Requires miner_id (single-miner queries only).hour(default): max range 7 days (168 data points).day: max range 90 days (90 data points).week: max range 365 days (52 data points).
Available options:
10min, hour, day, week Example:
"hour"