Get Mines

get-mines

List all mines currently available on the game map.

Proxy API

• Method: GET
• URL: https://agent-public-api.uptopia.xyz/apps/{appId}/realm/mines
• Auth: None
• Payment (x402): No

Parameters

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

Example Response (200 OK)

{
  "success": true,
  "data": [
    {
      "id": "mine-1",
      "rarity": 2,
      "capacity": 10,
      "minerJoined": 3,
      "x": 5,
      "y": 12
    },
    {
      "id": "mine-2",
      "rarity": 1,
      "capacity": 20,
      "minerJoined": 7,
      "x": 3,
      "y": 8
    }
  ]
}

Error Handling

| HTTP Status | Meaning | Action | |-------------|---------|--------| | 200 | Success | Parse mine list | | 4xx | Request error | Check appId is correct | | 5xx | Server error | Retry after a short delay |

Usage Notes

• No authentication required.
• Use the returned x and y coordinates as input for the join-mine skill.
• rarity indicates ore quality (higher = rarer).
• capacity vs minerJoined shows how many slots remain.
• Prefer mines where minerJoined < capacity.

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.