simulate_leverage

Previews the exact position that opening would produce. Deterministic and read-only — identical for ETH and ERC-20 pay tokens, with no on-chain call and no wallet.

Input

strategyId

string

required

Morpho market id of the strategy.

payToken

string

required

Token you pay in. The collateral (opened directly) or any other token (zapped to collateral first). Native ETH = the zero address.

amount

string

required

Amount of payToken in human units, e.g. "10000".

leverage

number

Target leverage, e.g. 3. Provide this or desiredLtv.

desiredLtv

string

Target LTV percent, e.g. "66.67". Provide this or leverage.

slippage

number

default:"0.005"

Ratio; capped at 0.01.

chainId

integer

default:"1"

Output

{
  "path": "swapAndLeverage",
  "positionPreview": {
    "leverage": "3.0",
    "requestedLtv": "66.67",
    "effectiveLtv": "66.73",
    "amountLeveragedCollateral": "52048.44",
    "expectedLeverageApy": "5.64",
    "priceImpactPct": "0.07"
  },
  "amountFlashLoan": "…",
  "minTokenOut": "…",
  "reallocationFeeWei": null,
  "slippage": 0.005
}

Example

const sim = await call("simulate_leverage", {
  strategyId, payToken, amount: "50000", leverage: 8,
});
// sim.positionPreview.expectedLeverageApy

Always simulate before building. The preview comes from a live swap quote, so numbers move with prices — treat it as current, not fixed.

get_prices build_leverage_tx

Introduction

Connect a client

Concepts

Tools

Guides

Reference

Input

Output

Example

​Input

​Output

​Example

Input

Output

Example