Skip to main content
GET
/
private-api
/
v1
/
{workspace_id}
/
farms
/
{farm_id}
/
miners
/
{miner_id}
/
history
List History
curl --request GET \
  --url https://api.nonce.app/private-api/v1/{workspace_id}/farms/{farm_id}/miners/{miner_id}/history \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": [
    {
      "id": "<string>",
      "miner_id": "002b1a50fa281efe0f320ebc39f5047b",
      "agent_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "farm_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "workspace_id": "org_xxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "hashrate": 100120000000000,
      "wattage": 9771,
      "temp": 75.5,
      "serial_number": "HTM3FS28HD25011939878367054H36045",
      "model": "Antminer S19",
      "ip": "192.168.1.100",
      "mac": "00:1B:44:11:3A:B7",
      "firmware_version": "20250304.15.REL",
      "period": "2025-09-07T00:00:00.000Z",
      "pool_url": "stratum+tcp://pool.example.com:4444",
      "worker_id": "worker1.100x0x217"
    }
  ],
  "pagination": {
    "total": 50,
    "limit": 10,
    "offset": 0,
    "hasNext": true,
    "hasPrevious": false
  },
  "error": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.nonce.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Clerk Machine API Key for authentication

Path Parameters

​
workspace_id
string
required
​
farm_id
string
required
​
miner_id
string
required

Query Parameters

​
page
number

Page number (default: 1)

Required range: x >= 1
Example:

1

​
pageSize
number

Number of items per page (default: 10, max: 10000)

Required range: 1 <= x <= 10000
Example:

10

​
from_time
string<datetime>
required

Start time for the history data in ISO 8601 format with timezone offset. Must be within the last 7 days

Example:

"YYYY-MM-DDTHH:MM:SSZ"

​
to_time
string<datetime>
required

End time for the history data in ISO 8601 format with timezone offset. Must be within the last 7 days

Example:

"YYYY-MM-DDTHH:MM:SSZ"

Response

Successfully retrieved miner history

​
success
boolean
required

Indicates if the request was successful

Example:

true

​
data
Miner History Record · object[]
required

Array of items

​
pagination
object
required

Pagination metadata

​
error
null
required

Error object (null on success)

Example:

null