Skip to main content
GET
Get account balance

Authorizations

Authorization
string
header
required

Firebase ID token from /auth or any paid route, sent as a Bearer token: Authorization: Bearer <id_token> (the Bearer prefix is required).

Response

Account balance information

Account balance information.

user_id
string

The user's ID (lowercase wallet address)

balance_type
enum<string>

Names what balance measures: the Laso account balance, not the agent wallet.

Available options:
account_balance
balance
number

Laso account balance in USD. This is a ledger held by Laso and is what /withdraw draws on. It is not the agent wallet's on-chain balance; see agent_wallet.

total_deposits
number

Total lifetime USD credited to the account balance. Includes every paid request settled from the agent wallet, because each one arrives as a deposit before the purchase debits it. It is not a measure of money received from outside.

agent_wallet
object

The caller's managed agent wallet: separate on-chain USDC on Solana and Base, with balance_usdc the total. Not part of the account balance. Spend it through agentX402Pay and move it with agentWalletTransfer.

note
string

Plain-language explanation of how the account balance and the agent wallet relate.

created_timestamp
number
created_timestamp_readable
string