---
title: "Get user yield positions"
method: GET
path: "/user-yield/{user_id}"
tags: ["User Data"]
---

# Get user yield positions

`GET /user-yield/{user_id}`

Returns paginated Breeze position value and earned yield for a wallet. Optionally filter by `fund_id`; values are in each fund's base token units and APY is expressed as percentage points.

## Path parameters

- `user_id` string, required

## Query parameters

- `fund_id` string
- `page` integer
- `limit` integer

## Response `200`

User yield data retrieved successfully

- UserYieldResponse
  - `data` UserYield[], required
    - `apy` number, double, required — Current annual percentage yield expressed as percentage points.
    - `base_asset` string, required — Base-asset symbol.
    - `entry_date` string, required — ISO 8601 timestamp for the position's mirrored entry.
    - `fund_id` string, required — Breeze fund account address.
    - `fund_name` string, required — Display name for the fund.
    - `last_updated` string, required — ISO 8601 timestamp for the position's mirrored update.
    - `position_value` integer, required — Current position value in the token's smallest unit.
    - `yield_earned` integer, required — Yield earned in the token's smallest unit.
  - `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

---

[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/revisions/d0a18846aa92/schema)