Quote a perp open
What opening a position would take, at the live mark: the collateral in the collateral mint, the notional, the venue fee estimate and an estimated liquidation price. Nothing is built and nothing is reserved.
With triggerPriceE6 the quote is that of a limit open (GMTrade only; Jupiter answers
422 venue_form): same fields, collateral converted at today’s mark (it is deposited now), and
the liquidation estimated at the trigger price. A long limit must sit below the mark and a
short limit above it.
When fundingMint is another token than the collateral, the exact-out funding route is quoted
too (funding), with a routeTicket you can pass to /perp/instructions to build on that
route.
The quote of a market open and the quote that /perp/instructions returns for the same
request are computed by the same function.
estLiquidationE6 is an estimate with a 0.6% maintenance margin, not the venue’s rule.Authorizations
Body
<venue>:<SYMBOL>-PERP, from /perp/markets
"jupiter:SOL-PERP"
buy and sell are accepted too
long, short Collateral in micro-USD (10000000 = $10). The notional is collateral × leverage
x >= 125000000
Leverage in bps (30000 = 3x). The router enforces only the 1x minimum; the venue's limits apply at execution
x >= 1000030000
Accepted price move from the mark at execution, and the funding route's slippage
0 <= x <= 9999What the wallet pays with. Omitted or the collateral mint: the collateral already in the
wallet's token account (held). SOL or native: native SOL, wrapped in the transaction
when the collateral is wSOL (native), otherwise routed from SOL. Any other mint: an
exact-out route into the collateral (routed). The wSOL mint address means wSOL already held.
Optional, only validated as an address
Quote a limit open at this price (GMTrade only)
x >= 1Response
The quote
Canonical market id
jupiter, gmtrade long, short How the collateral reaches the venue: already in the wallet, native SOL wrapped in the transaction, or a swap route in the transaction
held, native, routed Seconds spent by the router
The exact-out swap route into the collateral mint, present only when fundingMode is routed