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.

Authorization

authorization<token>

Use your API key here.

In: header

Request Body

application/jsonRequired

site_idRequiredstring

Site UUID. All miner_ids must belong to this site.

Format: "uuid"

miner_idsRequiredarray<string>

List of miner IDs to fetch (max 500). Duplicates are removed.

curl -X POST "https://app.luxor.tech/api/v2/commander/miners/details" \
  -H "authorization: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "site_id": "b0a5fad8-1234-5678-9abc-def012345678",
    "miner_ids": [
      "aaaa1111-bbbb-cccc-dddd-eeee11111111",
      "aaaa2222-bbbb-cccc-dddd-eeee22222222"
    ]
  }'

Default Response

{
  "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",
      "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
      }
    }
  ]
}

Get miner details (batch)

Authorization

Request Body

Response

TypeScript