Get a non-binding quote for opening a perpetual position on a supported DEX (Gains Network, Lighter). Quotes do not authenticate the caller and are not used by the execution flow; they are purely informational and exposed to help clients pick a DEX, price, or slippage before building a real payload.
Documentation Index
Fetch the complete documentation index at: https://docs.mobula.io/llms.txt
Use this file to discover all available pages before exploring further.
/2/perp/payloads/<action> → /2/perp/execute-v2 flow. Use the quote endpoint to preview fills, fees, and which DEX would route best; then call /2/perp/payloads/create-order to build the actual signed payload you submit.ETH, 0x...).10 for 10x).true for long, false for short. String form ("true"/"false") is also accepted.true if the order should only reduce an existing position (never increase exposure).quote token units (e.g., 100 USDC).market, limit, stop_limit. Default market.limit and stop_limit.collateralAmount * leverage.0.5 = 0.5%).["evm:42161"], ["lighter:301"]). Omit to search all supported chains.gains, lighter. Omit to consider all.0 = cross, 1 = isolated. DEX-specific; ignored when not applicable.| Status | When | message |
|---|---|---|
| 400 | Zod validation failed | zod validation failed |
| 500 | No DEX returned a quote | could not find quote |
errors field lists per-DEX failures, formatted as "<dex> - <error>".Wallet address of the trader. Used to scope the quote (e.g., Lighter account lookup).
Base token address, symbol, or Mobula asset id.
Quote/collateral token (typically USDC).
market, limit, stop_limit gains, lighter