simulate_equity_deposit

Previews depositing USDG into a stock + yield equity vault on Robinhood Chain. Deterministic, read-only, built from live swap quotes — no wallet. You end up 1x long the stock (held as your own Morpho collateral on the partner market), with stockLtvPct of its value borrowed as USDG and flash-looped into the vault’s yield strategy.

Input

string

required

The vault’s id from list_strategies (starts with equity-).

string

required

Deposit in human units of the vault’s deposit token (USDG), e.g. "10000".

string

Stock-leg LTV percent to borrow at. Default: the vault’s targetLtvPct. Capped at 88% of the stock market’s liquidation LTV (55 on a 62.5% market) — a higher value is refused, never clamped.

number

default:"0.01"

Ratio; capped at 0.01 (the app’s setting for vaults).

integer

default:"1"

Vaults exist on 4663 only.

Output

{
  "action": "equity_deposit",
  "preview": {
    "depositAmount": "1000",
    "stock": {
      "symbol": "SPY", "priceUsd": "766.6309", "minReceived": "1.291249",
      "ltvPct": "50.00", "maxLtvPct": "55.00", "liquidationLtvPct": "62.50",
      "liquidationPriceUsd": "613.3047", "priceDropToLiquidationPct": "20.00",
      "borrowUsdg": "494.96", "borrowApyPct": "0.06", "priceImpactPct": "-0.01"
    },
    "yieldLeg": {
      "collateralSymbol": "syrupUSDG", "collateralIn": "488.735796",
      "leverage": "10.5", "ltvPct": "90.50", "amountFlashLoan": "4711.99", "leverageApyPct": "40.79"
    },
    "netApyPct": "20.37",
    "fees": { "stockLegBps": 25, "yieldLegBps": 5, "estimatedFeeUsd": "5.10" },
    "slippage": 0.01
  }
}

Field	Meaning
`stock.minReceived`	The least stock the deposit swap delivers; the router supplies what it actually gets (≥ this).
`stock.borrowUsdg`	USDG borrowed against the stock at `ltvPct`, all deployed into the yield loop.
`stock.liquidationPriceUsd`	The stock price at which the stock leg reaches its liquidation LTV, from the entry price.
`yieldLeg`	The loop the borrowed USDG opens: its collateral, fixed leverage (the yield market’s max-safe LTV), flash loan and APY.
`netApyPct`	Net dollar APY on the deposit at this LTV: `ltv × (yieldLeg.leverageApyPct − stock.borrowApyPct)`.
`fees`	Entry swap fees: 25 bps on the stock leg (price exposure), 5 bps on the yield legs.

Fail-closed cases

The preview refuses, with a plain reason, when the stock market cannot lend the borrow (liquidityUsd), when the yield market cannot fund the flash loop directly (the vault entry has no reallocation path), when stockLtvPct is above the cap, when market data is stale, or when the id is a loop rather than a vault.

Example

const sim = await call("simulate_equity_deposit", {
  strategyId: "equity-0x50bc…", amount: "10000", stockLtvPct: "50", chainId: 4663,
});
// sim.preview.netApyPct, sim.preview.stock.liquidationPriceUsd

Introduction

Connect a client

Concepts

Tools

Guides

Reference

simulate_equity_deposit

Input

Output

Fail-closed cases

Example

​Input

​Output

​Fail-closed cases

​Example

Input

Output

Fail-closed cases

Example