v3

latestOpenAPI 3.1.02026-08-086132738.0 KB

V2 - Perps

Get perp quote

Get a non-binding quote for opening a perpetual position on a supported DEX (Gains Network, Lighter). Informational only — execution uses /2/perp/payloads/<action> → /2/perp/execute-v2.

post/api/2/perp/quote

Request body

userstring required

Wallet address of the trader. Used to scope the quote (e.g., Lighter account lookup).

baseTokenstring required

Base token address, symbol, or Mobula asset id.

quotestring required

Quote/collateral token (typically USDC).

leveragenumber required

reduceOnlyboolean required

collateralAmountnumber required

orderType'market' | 'limit' | 'stop_limit'

openPricenumber

tpnumber

slnumber

amountRawnumber

maxSlippagePnumber

chainIdsstring[]

dexesstring[]

marginModenumber

referrerstring

Response

Perp quote response

successboolean required