get_positions

Reads a wallet’s leverage positions directly from chain state (read-only).

Input

string

required

Wallet address to read positions for.

integer

default:"1"

Output

Each position carries:

Field	Meaning
`id`	On-chain index — feeds `build_manage_tx`.
`positionId`	Globally-unique `${chainId}-${strategyId}-${id}`.
`open` / `liquidated`	Lifecycle flags.
`amountLeveragedCollateral`, `amountLoan`	Collateral and debt.
`ltv` / liquidation LTV + headroom	Current risk.
`leverage`, `netValueUsd`, `currentLeverageApyPct`	Live position economics.
`exitLiquidity`	Can this position actually be unwound? See below.

Exit health (per position)

Closing swaps the full leveraged collateral, so exit health is measured against the whole position — not your equity:

"exitLiquidity": {
  "tier": "good",                 // deep | good | limited | thin | unknown
  "cleanExitSize": "$500K+",      // largest notional that exits cleanly
  "unwindSizeUsd": 264.2,         // this position's full unwind notional
  "exceedsCleanExitSize": false,  // ← act on this
  "noSwapRoute": false            // hard flag: collateral currently unswappable
}

Poll this on open positions. A market can be deep while your position still exceeds the depth that exits cleanly — exceedsCleanExitSize: true means expect slippage on close. If a route disappears entirely, you can still exit in-kind (repay + remove_collateral need no swap) — see Oracle & exit liquidity.

{
  "chainId": 1,
  "userAddress": "0x…",
  "positions": [
    { "id": 0, "positionId": "1-0x3274…-0", "open": true, "leverage": "3.0", "currentLeverageApyPct": "5.64" }
  ]
}

Example

const { positions } = await call("get_positions", { userAddress: "0x…" });

No cost-basis or realized P&L — those require off-chain history. Positions are read live from chain and returned newest-first.

Introduction

Connect a client

Concepts

Tools

Guides

Reference

Input

Output

Exit health (per position)

Example

​Input

​Output

​Exit health (per position)

​Example

Input

Output

Exit health (per position)

Example