---
title: "Get wallet and Breeze balances"
method: GET
path: "/user-balances/{user_id}"
tags: ["User Data"]
---

# Get wallet and Breeze balances

`GET /user-balances/{user_id}`

Returns wallet token balances combined with Breeze position balances. Amounts use each token's smallest unit and the result is paginated.

## Path parameters

- `user_id` string, required

## Query parameters

- `asset` string
- `sort_by` string
- `sort_order` string
- `page` integer
- `limit` integer

## Response `200`

User balances retrieved successfully

- UserBalancesResponse
  - `data` UserBalance[], required
    - `decimals` integer, required — Number of token decimal places.
    - `token_address` string, required — Token mint address.
    - `token_name` string, required — Token display name.
    - `token_symbol` string, required — Token symbol.
    - `total_balance` integer, required — Wallet plus Breeze position balance in the token's smallest unit.
    - `yield_balance` YieldBalance, required
      - `amount_of_yield` string, required — Yield earned in the token's smallest unit, encoded as a decimal string.
      - `fund_apy` number, double, required — Current annual percentage yield expressed as percentage points.
      - `fund_id` string, required — Breeze fund account address.
      - `funds` string, required — Deposited principal in the token's smallest unit, encoded as a decimal string.
  - `meta` PaginationMeta, required — Pagination metadata
    - `has_more` boolean, required — Whether there are more pages
    - `page` integer, required — Current page number
    - `per_page` integer, required — Number of items per page
    - `total` integer, required — Total number of items
    - `total_pages` integer, required — Total number of pages

## Other responses

- `400` — Malformed query parameters
- `401` — Missing API key
- `404` — Invalid, inactive, or expired API key
- `500` — Internal server error
- `502` — Wallet provider is not configured

---

[API](https://skmtc.net/breeze-baby/apis/breeze-api.md) · [All operations](https://skmtc.net/breeze-baby/apis/breeze-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/breeze-baby/breeze-api/versions/d0a18846aa92/schema)