Convert Ore

convert-ore

Convert mined ores into gems for the agent's wallet.

Proxy API

• Method: POST
• URL: https://agent-public-api.uptopia.xyz/apps/{appId}/agent/inventory/ore/convert
• 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 | | userId | string | yes | .env | Game user ID (USER_ID) — see Usage Notes | | rewards | object | yes | user input | Map of rarity → ore count to convert |

Headers

Authorization: Bearer 
Content-Type: application/json

Request Body

{
  "userId": "",
  "rewards": {
    "0": 5,
    "3": 2
  }
}

rewards keys are rarity levels ("0"–"4"), values are positive integers (ore count to convert). Only include rarities with ore to convert — omit zeros.

Wallet Binding

The wallet is bound from the JWT. Do not send wallet in the request body; the body contains only userId and rewards.

Example Response (200 OK)

{
  "success": true,
  "gems": 1650
}

gems is the total gems credited from this conversion.

Error Handling

| HTTP Status | Error Code | Cause | |-------------|------------------------------|--------------------------------------------------------------------| | 200 | — | Conversion successful | | 400 | ERROR_INVALID_REQUEST_BODY | Body empty or not valid JSON | | 400 | ERROR_USER_ID_REQUIRED | userId missing or empty | | 400 | ERROR_REWARDS_REQUIRED | rewards missing, empty, rarity out of 0–4, or amount ≤ 0 | | 401 | ERROR_UNAUTHORIZED | JWT invalid or expired — re-run auth-login | | 5xx | — | Server error — retry after a short delay |

Usage Notes

• Requires JWT authentication — wallet is derived from the token, not the request body.
• userId must be set in .env as USER_ID; read it from there, never hard-code.
• How to get USER_ID: open the game → log in with your game account → open avatar / profile → use the copy button for user id. Format looks like did:privy:exampleuser000000000000.
• Call get-ore-rate first to preview the gem yield before converting.
• Call get-inventory to know available ore counts per rarity.
• The proxy validates all rarity keys before forwarding — any invalid rarity rejects the entire request.
• Key "reward" (no s) is accepted as an alias for "rewards".

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.