Manage & close

Every adjustment uses build_manage_tx against a position’s on-chain id (from get_positions).

Find the position

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

Adjust

await call("build_manage_tx", { userAddress, id, action: "add_collateral", payToken: "0x…", amount: "5000" });

await call("build_manage_tx", { userAddress, id, action: "repay", payToken: "0x…", amount: "5000", full: true });

await call("build_manage_tx", { userAddress, id, action: "increase_leverage", desiredLtv: "75" });

await call("build_manage_tx", { userAddress, id, action: "remove_collateral", amount: "1000" });
await call("build_manage_tx", { userAddress, id, action: "borrow", amount: "1000" });

Close

const bundle = await call("build_manage_tx", { userAddress, id, action: "close" });
// Send bundle.tx — swaps all collateral back to the loan token, repays, returns the rest.

Each returns the same { approvals, tx, meta } bundle — sign approvals first, then the tx. Verify with get_positions after it confirms.

Unwinding when exit liquidity is gone

close needs a live swap route. If it’s gone the build fails closed — but you can still exit in-kind, because these two need no swap:

Repay the debt (no swap)

// Pay in the LOAN token → direct repay, no route needed
await call("build_manage_tx", { userAddress, id, action: "repay", payToken: loanToken, amount: "…", full: true });

Withdraw the collateral (no swap)

await call("build_manage_tx", { userAddress, id, action: "remove_collateral", amount: "…" });

You exit holding the collateral token itself, never touching its market.

Don’t wait for close to throw. get_positions returns exitLiquidity.exceedsCleanExitSize per position — poll it and unwind while a route still exists.

Introduction

Connect a client

Concepts

Tools

Guides

Reference

Find the position

Adjust

Close

Unwinding when exit liquidity is gone

​Find the position

​Adjust

​Close

​Unwinding when exit liquidity is gone

Find the position

Adjust

Close

Unwinding when exit liquidity is gone