Skip to main content
A quote prices a trade on one outcome across every venue that lists it, and returns the split that fills best. You then fill the quote by its quoteId. See Execution for the fill.
API reference: Get a quote (smart route).

Request

In the SDK the trade direction is tradeSide. For signingAddress or fundingAddresses, use the HTTP query as shown in Self-custody trading.
  • Quote status (ok, no_orderbooks) is not a fill HTTP code (quote_not_found).
  • slipCapBps caps slippage; appFeeBips is your fee rate, not slippage.
  • status: "no_orderbooks" means the quote cannot be filled; a warning reason of no_orderbook only 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?

Check status 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.

Execution

Fill a quote, or place direct and limit orders.

Comparing venue prices

Show per-venue prices next to the routed price.