v2

latestOpenAPI 3.1.02026-08-08112946.7 KB
Users

Get all current positions for a wallet

Returns every vault position the wallet currently holds or has pending exposure in (pending deposit or redeem). Fully-exited positions (zero shares, no pending escrow) are excluded.

All monetary metrics include a usd field (null when pricing is unavailable). value.usd and pending_deposit_assets.usd use the current spot price. cost_basis.usd and pnl.realized.usd are computed by replaying on-chain events against the token's historical price series — the same method used by GET /v1/users/{wallet}/positions/{vault_id}. pnl.unrealized.usd, pnl.total.usd, and roi_pct.usd are derived from those.

Cursor-paginated on internal position ID. Default page size 100, max 500.

get/v1/users/{wallet_address}/positions

Path parameters

wallet_addressstring required

Ethereum wallet address

Query parameters

nextstring

Opaque cursor from previous meta.next_cursor.

limitinteger

Page size (1–500, default 100).

Response

All wallet positions