Get miner details
Returns detailed information for a specific miner including hashboard-level and fan-level breakdowns.
Authorization
LuxorAPIKey Use your API key here.
In: header
Path Parameters
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/commander/miners/string"{ "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "ip_address": "10.0.1.42", "mac_address": "AA:BB:CC:DD:EE:FF", "model": "S19 Pro", "firmware": { "name": "LuxOS", "version": "2024.12.1" }, "hashing_status": "hashing", "healthy_status": "healthy", "site_id": "b0a5fad8-1234-5678-9abc-def012345678", "agent_id": "056a4f62-1234-5678-9abc-def012345678", "hashrate": "110000000000000", "power": 3250, "max_temperature": 65, "fan_speed": [ 4200, 4180, 4180, 4100 ], "pool": { "url": "stratum+tcp://pool.example.com:3333", "username": "lux_phx_0", "worker": "myworker.001" }, "last_seen_at": "2026-02-20T12:00:00Z", "url": "/v2/commander/miners/a1b2c3d4-e5f6-7890-abcd-ef1234567890", "hashboards": [ { "index": 0, "board_hashrate": "27500000000000", "board_voltage": 15.1, "board_frequency": 500, "board_temperature": 62, "chips_total": 114, "chips_active": 114 } ], "pool_configs": [ { "priority": 1, "username": "lux_phx_0", "worker": "myworker.001", "url": "stratum+tcp://pool.example.com:3333", "status": true, "group": "Group 1" } ], "atm": { "enabled": true, "startup_minutes": 10, "post_ramp_minutes": 5, "temp_window": 10, "temp_buffer": 10, "min_profile": "1", "max_profile": "4", "prevent_oc": true }}{ "statusCode": 400, "code": "FST_ERR_VALIDATION", "error": "Bad Request", "message": "body/end_date Required"}{ "statusCode": 400, "code": "FST_ERR_VALIDATION", "error": "Bad Request", "message": "body/end_date Required"}{ "statusCode": 400, "code": "FST_ERR_VALIDATION", "error": "Bad Request", "message": "body/end_date Required"}Get miners
Returns a paginated list of miners with optional filtering by site, agent, status, model, and firmware. For nested AND/OR logic across a larger field set, pass the `filter` query parameter as URL-encoded JSON; when supplied, it supersedes the flat filter params.
Get miner details (batch)
Returns detailed information for up to 500 miners scoped to a single site in a single request. Designed for polling workflows that would otherwise exceed rate limits with one-at-a-time GETs. Access is gated by two checks: the caller must have commander-read on `site_id`, and on every site that the requested `miner_ids` belong to — any miner ID owned by a site the caller can't read causes the whole request to return 403. Unknown miner IDs (that don't exist anywhere) are silently omitted from the response. Lift metrics may report 0 for miners that have been offline for more than an hour.