Get account balance

Returns the Laso account balance and total deposits for the authenticated user, plus the managed agent wallet's balance under agent_wallet so both are visible in one call.

These are two separate balances. The account balance is a ledger held by Laso. The agent wallet is an on-chain wallet that holds USDC. A paid request moves USDC from the wallet to Laso, so it is recorded on the account balance as a deposit and then debited by the purchase. total_deposits therefore includes purchases paid from the agent wallet, and a balance of 0 after a purchase is expected. Funds still held are agent_wallet.balance_usdc plus balance.

Requires a Bearer token from /auth or /get-card.

get/get-account-balance

Request

  • Base URL: https://laso.finance
  • URL: https://laso.finance/get-account-balance
  • Auth: API key in header Authorization

Response

Account balance information

user_idstring

The user's ID (lowercase wallet address)

balance_type'account_balance'

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

balancenumber

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_depositsnumber

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.

notestring

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

created_timestampnumber
created_timestamp_readablestring

Changes

No recorded changes to this operation across all 3 revisions of this API.