Get Miner

get-miner

Get detailed status of a specific miner by ID.

Proxy API

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

Parameters

| Name | Type | Required | Source | Description | |-----------|--------|----------|-----------------|---------------------------------------| | appId | string | yes | agent config | Application ID | | minerId | string | yes | user input / get-miners | UUID of the miner to inspect | | 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,
    "oresFound": {
      "0": 2,
      "1": 0,
      "2": 1,
      "3": 0,
      "4": 0
    }
  }
}

state values:

• 0 — idle
• 1 — mining in progress

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

oresFound keys are rarity levels (0 = Common → 4 = Legendary) showing ores collected by this miner.

Error Handling

| HTTP Status | Meaning | Action | |-------------|---------|--------| | 200 | Success | Parse miner detail | | 401 | JWT invalid or expired | Re-run auth-login | | 404 | Miner not found | Check minerId via get-miners | | 5xx | Server error | Retry after a short delay |

Usage Notes

• Requires JWT authentication.
• Obtain minerId from the get-miners skill or from the join-mine response.
• Use actionComplete to determine when mining will finish (convert Unix timestamp to human-readable time).
• A 404 means either the miner ID is wrong or it belongs to a different wallet.

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.