​
Understanding Balances

A balance is considered “spendable” when:

  • Funds have been fully settled and verified
  • Funds aren’t reserved for pending operations
  • Funds aren’t subject to any holds or restrictions
# Check how much money your AI Agent can spend
balance = payman.balances.get_spendable_balance("USD")
print(f"Available balance: ${balance:.2f}")  # e.g., "Available balance: $150.00"

Parameters

ParameterTypeDescription
currencystr'USD', 'USDC', 'TSD' (For Test Wallets)

Response

Returns a float representing the spendable balance in USD:

42.50  # $42.50 USD