get_positions

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

Input

userAddress

string

required

Wallet address to read positions for.

chainId

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.

{
  "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.

build_manage_tx Find the best yield

Introduction

Connect a client

Concepts

Tools

Guides

Reference

Input

Output

Example

​Input

​Output

​Example

Input

Output

Example