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

​
action
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

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

​
Example

Verify the result with get_positions after the transaction confirms.