Skip to main content
Returns the unsigned payload to adjust or unwind an open position, for the owner to sign. Same non-custodial model and output shape as build_leverage_tx.

Actions

string
required
One of:
  • close — unwind the position fully.
  • increase_leverage — borrow to a higher LTV (provide desiredLtv or leverage).
  • add_collateral — top up (provide payToken + amount; pay in collateral or any token).
  • remove_collateral — withdraw collateral (provide amount).
  • repay — pay down debt (provide payToken + amount; set full: true to clear it).
  • borrow — draw more loan token (provide amount).

Input

string
required
Wallet that owns the position and will sign.
integer
required
On-chain position index — from get_positions.
string
Human units. Required for add/remove/repay/borrow.
string
Token to pay in (add_collateral / repay).
boolean
repay only — clear the entire remaining debt.
string
increase_leverage target LTV percent.
number
increase_leverage target leverage.
number
default:"0.005"
integer
default:"1"

Example

Verify the result with get_positions after the transaction confirms.