List Metrics History
Returns historical farm metrics. The granularity query parameter selects the time resolution. day (default) returns the full daily metric set (hashrate, online miners, BTC earnings, electricity). hour and 10min return a hashrate-only subset (period, pool hashrate, online / offline miner counts) aggregated from raw 10-minute samples; agent, finance and electricity fields are omitted at sub-day granularity. Sub-day query windows are bounded: 10min up to 7 days, hour up to 60 days.
Authorizations
Clerk Machine API Key for authentication
Query Parameters
Page number (default: 1)
x >= 11
Number of items per page (default: 10, max: 10000)
1 <= x <= 1000010
Date in YYYY-MM-DD format
^\d{4}-\d{2}-\d{2}$"2025-09-07"
Date in YYYY-MM-DD format
^\d{4}-\d{2}-\d{2}$"2025-09-07"
Time resolution of the returned metrics.
day(default): full daily metric set (pool / agent hashrate, online miners, BTC earnings, electricity).hour/10min: hashrate-only subset (period, pool hashrate, online / offline miner counts) aggregated from raw 10-minute samples. Sub-day query windows are bounded:10minup to 7 days,hourup to 60 days.dayis unbounded.
day, hour, 10min Response
Successfully retrieved farm metric history
Indicates if the request was successful
true
Array of items
- Farm Metric History
- Farm Sub-Day Metric History
Pagination metadata
Error object (null on success)
null