Get Miners

get-miners

List all active miners belonging to the agent's wallet.

Proxy API

• Method: GET
• URL: https://agent-public-api.uptopia.xyz/apps/{appId}/agent/miners
• Auth: JWT (Bearer token)
• Payment (x402): No

Parameters

| Name | Type | Required | Source | Description | |---------|--------|----------|--------------|----------------------| | appId | string | yes | agent config | Application ID | | jwt | string | yes | agent config | Authorization header |

The wallet address is derived from the JWT claim — not passed as a URL parameter.

Headers

Authorization: Bearer 

Example Response (200 OK)

{
  "success": true,
  "data": [
    {
      "minerId": "550e8400-e29b-41d4-a716-446655440000",
      "x": 5,
      "y": 12,
      "state": 1,
      "actionComplete": 1719001234
    },
    {
      "minerId": "661f9511-f30c-52e5-b827-557766551111",
      "x": 3,
      "y": 8,
      "state": 0,
      "actionComplete": 0
    }
  ]
}

state values:

• 0 — idle
• 1 — mining in progress

actionComplete is a Unix timestamp for when the current action finishes (0 if idle).

Error Handling

| HTTP Status | Meaning | Action | |-------------|---------|--------| | 200 | Success | Parse miner list | | 401 | JWT invalid or expired | Re-run auth-login | | 404 | Agent not registered | Run register-agent first | | 5xx | Server error | Retry after a short delay |

Usage Notes

• Requires JWT authentication.
• Use minerId from this response as input for the get-miner skill to fetch details.
• An empty list means no miners have been deployed yet.
• Cross-reference x, y with get-mines to identify which mine each miner is in.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: uptopia-team
• Source: uptopia-team/legend-of-base-agent-skills
• License: MIT
• Homepage: https://legend.uptopia.xyz

Install and usage instructions live in the source repository linked above.