Wallet

Get top-up configuration

Changed on

Fees and limits for wallet top-ups, plus the workspace's applied promotion (tiers, presets) and the auto-reload checkout offer.

get/v1/wallet/topup

Request

  • Base URL: https://api.monid.ai
  • URL: https://api.monid.ai/v1/wallet/topup
  • Auth: HTTP bearer

Headers

X-Monid-Agent-Modelstring

Model driving the calling agent. Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

X-Monid-Agent-Harnessstring

Agent harness or client making the call (e.g. a coding agent, an agent framework). Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

X-Monid-Agent-Session-Idstring

Caller-side session identifier, so the calls of one agent session (discover → inspect → run → polling) can be correlated. Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

Response

Top-up fees, limits, promotion tiers, and presets

minAmountnumber required

Minimum top-up amount in dollars.

maxAmountnumber

Maximum top-up amount in dollars. Omitted when no app-level cap is configured.

currency'USD' required

Top-up currency (currently always USD).

presetsnumber[] required

Preset amounts in dollars, display order. Bonuses are client-derived from tiers (round-down tier match).

defaultPresetnumber required

Pre-selected preset amount in dollars.

Example response

{
  "minAmount": 5,
  "maxAmount": 1000,
  "processingFee": {
    "rate": 0.05,
    "description": "Processing fee (5%)"
  },
  "promotion": {
    "key": "firstTopup",
    "label": "New user promotion"
  },
  "tiers": [
    {
      "minAmount": 100,
      "rate": 0.15
    }
  ],
  "defaultPreset": 100,
  "autoReload": {
    "topUpToAmount": 20,
    "threshold": 5
  }
}

Changes

  • 631143e91790Revision changes
    • info

      added the new optional header request parameter X-Monid-Agent-Harness

    • info

      added the new optional header request parameter X-Monid-Agent-Model

    • info

      added the new optional header request parameter X-Monid-Agent-Session-Id

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

  • b944bb23906cRevision changes
    • warning

      added the new PROMO_REDEEM_DISABLED enum value to the response property for the response status

    • warning

      added the new PROMO_REDEEM_DISABLED enum value to the response property for the response status

    • warning

      added the new PROMO_REDEEM_DISABLED enum value to the response property for the response status

    • warning

      added the new RATE_LIMITED enum value to the response property for the response status

    • warning

      added the new RATE_LIMITED enum value to the response property for the response status

    • warning

      added the new RATE_LIMITED enum value to the response property for the response status

    • info

      added the non-success response with the status