quoteId. See
Execution for the fill.
Request
tradeSide. For signingAddress or fundingAddresses, use
the HTTP query as shown in Self-custody trading.
- Quote
status(ok,no_orderbooks) is not a fill HTTPcode(quote_not_found). slipCapBpscaps slippage;appFeeBipsis your fee rate, not slippage.status: "no_orderbooks"means the quote cannot be filled; a warningreasonofno_orderbookonly skips one venue.- A preview has no user JWT; an executable quote has the user’s JWT.
Preview vs executable
A sell quote always needs a signed-in user. Filling a quote that belongs to someone else, or a
preview quote, returns
400 with code: "quote_user_mismatch".
Can it be filled?
Checkstatus before you fill:
When
status is not ok, read error. message is informational. Only fill quotes with status: "ok".
Sellable shares
Every sell quote,ok included, carries positionAvailability: the user’s shares when the quote
was built, on the venues the request allows.
Use it to cap the size you request, for example behind a “Max” button. It is a snapshot, not a
reservation: the fill re-checks the live venue balance, so it can still fail if the position
changed after the quote.
Expiry
Every quote carries two timestamps:
A quote currently lasts about 45 seconds, with
refreshAt about 15 seconds after it is created.
Some routes expire sooner. Always read expiresAt; never hard-code the window.
A fill after expiry returns 400 with code: "quote_not_found" or "quote_expired". Follow
Errors, retries & idempotency. fallbackToLatest is on
Execution.
A quoteId fills at most once. See Errors, retries & idempotency.
What the quote contains
Fees in the quote
feeBreakdown is the number to show before the user commits.
Use
totalCostIncFees for the all-in number. Fees explains each kind.
Warnings
warnings[] lists venues the route skipped or flagged. Each entry has venue,
venueMarketOutcomeId, and reason. The quote is still usable. Known reasons include
low_liquidity, low_balance, stale_orderbook, empty_book, crossed_book, no_orderbook,
app_fee_unsupported, referral_unpaid_on_solana, and referrer_not_activated_on_hypercore.
Geo warnings. A quote can still include venues unavailable in the user’s country. The
warning reason reads Venue not available in your region (XX) when the country is known.
Before offering a fill, re-quote with allowedVenues restricted to eligible venues, or show
that trading is unavailable. A sell quote warns on the held legs it would sell; those cannot be
re-routed. The fill checks location again and can return 403 with code: "geo_blocked". See
Venue geo availability.
Self-custody quotes also carry custodyWarnings[]. See
Self-custody trading.
Related
Execution
Fill a quote, or place direct and limit orders.
Comparing venue prices
Show per-venue prices next to the routed price.