Luxor PlatformAPI DocumentationCommanderReporting
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.
Authorization
LuxorAPIKey authorization<token>
Use your API key here.
In: header
Query Parameters
site_id?string
Format
uuidagent_id?string
Format
uuidhashing_status?string
Value in
- "hashing"
- "idle"
- "offline"
- "N/A"
healthy_status?string
Value in
- "healthy"
- "failing"
- "N/A"
model?string
firmware?string
Value in
- "LuxOS"
- "Bitmain"
- "MicroBT"
- "Avalon"
- "Bitdeer"
- "FluxOS"
- "MaraFW"
filter?
sort_by?string
Value in
- "hashrate"
- "max_temperature"
- "power"
- "model"
- "firmware"
- "ip_address"
- "last_seen_at"
sort_order?string
Default
"asc"Value in
- "asc"
- "desc"
page_number?integer
Range
1 <= valueDefault
1page_size?integer
Range
1 <= value <= 5000Default
25Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v2/commander/miners"{ "miners": [ { "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" } ], "pagination": { "page_number": 1, "page_size": 1, "item_count": 0, "previous_page_url": null, "next_page_url": null }}{ "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"}