---
title: "Get account balance"
method: GET
path: "/get-account-balance"
---

# Get account balance

`GET /get-account-balance`

## Request

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

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`.

## Response `200`

Account balance information

- AccountBalance: Account balance information.
  - `user_id` string: The user's ID (lowercase wallet address)
  - `balance_type` 'account_balance': Names what `balance` measures: the Laso account balance, not the agent wallet.
  - `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` AgentWalletBalance: 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`.
    - `has_wallet` boolean: False for wallet-native accounts and managed accounts with no wallet provisioned yet.
    - `wallet_address` string, nullable: The wallet's Solana address, or null when `has_wallet` is false.
    - `balance_usdc` number: USDC held on-chain by the agent wallet. The same figure `getAgentWallet` reports.
  - `note` string: Plain-language explanation of how the account balance and the agent wallet relate.
  - `created_timestamp` number
  - `created_timestamp_readable` string

## Other responses

- `401`: Missing or invalid Bearer token
- `403`: Account is frozen. The response includes a `frozen_message` field explaining why.
- `404`: Account balance not found

---

[API](https://skmtc.dev/laso/apis/laso-finance-x402-api.md) · [All operations](https://skmtc.dev/laso/apis/laso-finance-x402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/laso/apis/laso-finance-x402-api/revisions/ff8ce20b49ba?raw)