Wallet

Get wallet

Get the caller's wallet: current balance, auto-reload configuration, per-product contract rates, and any in-flight top-up.

get/v1/wallet

Request

Base URL: https://agent.tinyfish.ai
URL: https://agent.tinyfish.ai/v1/wallet
Auth: API key in header X-API-Key

Response

Wallet details

available_balancestring required

Current spendable balance, denominated in currency. A negative value means the wallet is overdrawn.

currency'USD' required

as_ofstring date-time required

agent_top_up_urlstring uri

Present when an agent can add funds itself: POST here and pay the 402 MPP challenge.

Example response

{
  "available_balance": "21.44",
  "currency": "USD",
  "as_of": "2026-08-10T18:04:11.220Z",
  "auto_reload": {
    "threshold": "5.00",
    "recharge_to": "25.00"
  },
  "pending_top_up": {
    "amount": "50.00",
    "started_at": "2026-08-10T18:02:55.000Z"
  },
  "rates": {
    "meters": [
      {
        "label": "Agent steps",
        "unit_amount": "0.016000",
        "currency": "USD",
        "per": "step"
      }
    ],
    "as_of": "2026-08-10T18:04:11.220Z"
  },
  "agent_top_up_url": "https://agent.tinyfish.ai/v1/wallet/top-up"
}

Changes

No recorded changes to this operation across all 1 revision of this API.