Wallet

GET /v1/balance

Get the current wallet balance.

GET /v1/balance

Headers

HeaderRequiredDescription
AuthorizationYesBearer <api-key>
curl https://api.toolplexer.com/v1/balance \
  -H "Authorization: Bearer tpl_live_..."
FieldDescription
balanceUsdMicroPrepaid balance
heldUsdMicroIn-flight holds
availableUsdMicroSpendable now
budgetLimitUsdMicro / budgetSpentUsdMicroPeriod budget
maxRunUsdMicroPer-run cap, or null
apiKeyBudgetThis key’s limit, if set

Amounts are integer micro-dollars (1e6 = $1).

When a hold would exceed wallet, budget, API-key limit, or the per-run cap, the run is BLOCKED with controls. Show those to the user. Do not auto-retry. Set a per-run cap in the dashboard.

On this page