---
title: "Request for Miner List (USER_DATA)"
method: GET
path: "/sapi/v1/mining/worker/list"
tags: ["Mining"]
---

# Request for Miner List (USER_DATA)

`GET /sapi/v1/mining/worker/list`

Weight(IP): 5

## Query parameters

- `algo` string, required
- `userName` string, required
- `pageIndex` integer
- `sort` integer
- `sortColumn` integer
- `workerStatus` integer
- `recvWindow` integer
- `timestamp` integer, required
- `signature` string, required

## Response `200`

List of workers

- object
  - `code` integer, required
  - `msg` string, required
  - `data` object, required
    - `workerDatas` object[], required
      - `workerId` string, required
      - `workerName` string, required
      - `status` integer, required — Status：1 valid, 2 invalid, 3 no longer valid
      - `hashRate` integer, required — Real-time rate
      - `dayHashRate` integer, required — 24H Hashrate
      - `rejectRate` integer, required — Real-time Rejection Rate
      - `lastShareTime` integer, required — Last submission time
    - `totalNum` integer, required
    - `pageSize` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized Request

## Changes

- **2021-10-25** `a484ce871a72` — 6 breaking, 17 info
  - for the `query` request parameter `pageIndex`, the type/format was changed from `string`/`` to `integer`/`int32`
  - for the `query` request parameter `recvWindow`, the type/format was changed from `integer`/`` to `integer`/`int64`
  - for the `query` request parameter `sort`, the type/format was changed from `integer`/`` to `integer`/`int32`
  - for the `query` request parameter `sortColumn`, the type/format was changed from `integer`/`` to `integer`/`int32`
  - …19 more

[Change history](https://skmtc.dev/binance/apis/binance-public-spot-api/changes/sapi/v1/mining/worker/list/get.md)

---

[API](https://skmtc.dev/binance/apis/binance-public-spot-api.md) · [All operations](https://skmtc.dev/binance/apis/binance-public-spot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/binance/binance-public-spot-api/revisions/0dd2f133e12d/schema)