Miner API Reference

This section covers all endpoints related to miner.

List Chutes

Endpoint: GET /miner/chutes/

Parameters

Parameter	Type	Required	Description
X-Chutes-Hotkey	string | null	No
X-Chutes-Signature	string | null	No
X-Chutes-Nonce	string | null	No
Authorization	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

List Images

Endpoint: GET /miner/images/

Parameters

Parameter	Type	Required	Description
X-Chutes-Hotkey	string | null	No
X-Chutes-Signature	string | null	No
X-Chutes-Nonce	string | null	No
Authorization	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

List Nodes

Endpoint: GET /miner/nodes/

Parameters

Parameter	Type	Required	Description
X-Chutes-Hotkey	string | null	No
X-Chutes-Signature	string | null	No
X-Chutes-Nonce	string | null	No
Authorization	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

List Servers

List all servers for the authenticated miner, with nested GPU info. Provides full visibility into server inventory (including servers with no GPUs, duplicate IPs, or name collisions).

Endpoint: GET /miner/servers/

Parameters

Parameter	Type	Required	Description
X-Chutes-Hotkey	string | null	No
X-Chutes-Signature	string | null	No
X-Chutes-Nonce	string | null	No
Authorization	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

List Instances

Endpoint: GET /miner/instances/

Parameters

Parameter	Type	Required	Description
explicit_null	boolean | null	No
X-Chutes-Hotkey	string | null	No
X-Chutes-Signature	string | null	No
X-Chutes-Nonce	string | null	No
Authorization	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

List Available Jobs

Endpoint: GET /miner/jobs/

Parameters

Parameter	Type	Required	Description
X-Chutes-Hotkey	string | null	No
X-Chutes-Signature	string | null	No
X-Chutes-Nonce	string | null	No
Authorization	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

Release Job

Endpoint: DELETE /miner/jobs/{job_id}

Parameters

Parameter	Type	Required	Description
job_id	string	Yes
X-Chutes-Hotkey	string | null	No
X-Chutes-Signature	string | null	No
X-Chutes-Nonce	string | null	No
Authorization	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

Get Full Inventory

Endpoint: GET /miner/inventory

Parameters

Parameter	Type	Required	Description
X-Chutes-Hotkey	string | null	No
X-Chutes-Signature	string | null	No
X-Chutes-Nonce	string | null	No
Authorization	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

Metrics

Endpoint: GET /miner/metrics/

Parameters

Parameter	Type	Required	Description
X-Chutes-Hotkey	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

---

List Active Instances

Get all active instances across the platform. Used by miners to make informed preemption decisions based on global state.

Endpoint: GET /miner/active_instances/

Parameters

Parameter	Type	Required	Description
X-Chutes-Hotkey	string | null	No
X-Chutes-Signature	string | null	No
X-Chutes-Nonce	string | null	No
Authorization	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

Get Chute

Endpoint: GET /miner/chutes/{chute_id}/{version}

Parameters

Parameter	Type	Required	Description
chute_id	string	Yes
version	string	Yes
X-Chutes-Hotkey	string | null	No
X-Chutes-Signature	string | null	No
X-Chutes-Nonce	string | null	No
Authorization	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

Get Stats

Get miner stats over different intervals based on instance data (matching actual scoring).

Returns instance-based metrics (total_instances, compute_seconds, compute_units, bounty_count) which align with how miners are actually scored for validator weights.

Endpoint: GET /miner/stats

Parameters

Parameter	Type	Required	Description
miner_hotkey	string | null	No
per_chute	boolean | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

---

Get Scores

Endpoint: GET /miner/scores

Parameters

Parameter	Type	Required	Description
hotkey	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

---

Unique Chute History

Endpoint: GET /miner/unique_chute_history/{hotkey}

Parameters

Parameter	Type	Required	Description
hotkey	string	Yes

Responses

Status Code	Description
200	Successful Response
422	Validation Error

---

Get Thrash Cooldowns

Return all chutes where this miner is currently in a thrash cooldown, along with when the cooldown expires.

Endpoint: GET /miner/thrash_cooldowns

Parameters

Parameter	Type	Required	Description
X-Chutes-Hotkey	string | null	No
X-Chutes-Signature	string | null	No
X-Chutes-Nonce	string | null	No
Authorization	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

Get Metagraph

Endpoint: GET /miner/metagraph

Responses

Status Code	Description
200	Successful Response

---