Breeze
Endpoints

Get Breeze Balances

GET
/breeze-balances/{user_id}

Returns a user's Breeze positions for one strategy, including principal, current value after strategy fees, yield after strategy fees, APY percentage points, and pagination metadata.

x-api-key<token>

In: header

Path Parameters

user_id*string

Fund user wallet address

Query Parameters

asset?string

Filter by specific asset

sort_by?string

Sort by balance

sort_order?string

Sort order: 'asc' or 'desc'

page?integer

Page number

Formatint32
Range0 <= value
limit?integer

Items per page

Formatint32
Range0 <= value
strategy_id*string

Strategy ID

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/breeze-balances/string?strategy_id=string"
{  "data": [    {      "apy": 5.66,      "decimals": 6,      "fund_id": "LbUiWL3xVV8hTFYBVdbTNrpDo41NKS6o3LHHuDzjfcY",      "last_updated": "2026-07-28T18:32:05+00:00",      "strategy_id": "43620ba3-354c-456b-aa3c-5bf7fa46a6d4",      "strategy_name": "Breeze USDC",      "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",      "token_name": "USD Coin",      "token_symbol": "USDC",      "total_deposited_value": 2000000,      "total_position_value": 2003183,      "yield_earned": 3183    }  ],  "meta": {    "has_more": false,    "page": 1,    "per_page": 1000,    "total": 1,    "total_pages": 1  }}
{  "message": "strategy_id query parameter is required"}
{  "message": "Missing credentials"}
{  "message": "API key invalid or doesn't exist"}
{  "message": "Internal server error"}