DeFi Positions

get

https://api.vybenetwork.xyz/v4/wallets/{ownerAddress}/defi-positions

Returns a wallet's live DeFi positions across all supported protocols
(lending/borrowing, liquidity pools, perps/margin, limit orders & DCA,
staking, rewards, vesting, and more).

The response is a flat list of self-contained position "elements" under
data.portfolio — there is no platform grouping. Each element is typed by
its type field (borrowlend | liquidity | leverage | trade |
multiple), which determines the shape of its nested data, and carries its
own platformId, networkId, value (USD, nullable when unpriced), and
label. To reconstruct a per-platform view, group elements by platformId
client-side and sum value per group.

Use this to render a wallet's complete DeFi portfolio in one call. Integrators
should switch on element.type and default-handle unknown types gracefully so
newly added position kinds don't break parsing.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200DeFi positions for the wallet. data.portfolio is a flat array of typed position elements (may be empty if the wallet has no positions). Group by each element's platformId to reconstruct a per-platform view.

400Invalid parameters — verify that ownerAddress is a valid base58 Solana wallet address.

404No data could be found for the given wallet.

500Unexpected server error. The response body includes an id field — provide this when contacting support at [email protected].

502Partial result — one or more protocol handlers failed while assembling the portfolio. The body still contains the successfully fetched positions in data.portfolio, plus a partial_failures array naming the protocols that errored. Render what's present and optionally retry.