get_balance
The user's Qumge balance, plus what each Cap has spent this month against its monthly limit. Call this before a paid call when the user asks whether they can afford it, and after a 402 that says the balance or a limit stopped the call — it returns the top-up link to hand to the user. Needs the user's qumge key.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| qumge_key | No | Optional: your Qumge API key, for clients that cannot set an Authorization header. Takes precedence over the header. Never echoed back. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| caps | No | ||
| topup_url | No | ||
| frozen_micro_usd | No | ||
| balance_micro_usd | Yes | ||
| available_micro_usd | Yes | ||
| withdrawable_micro_usd | Yes |