x-app-id and the user’s Authorization: Bearer token. The call
returns before the trade finishes. Track it with
Order lifecycle & statuses.
Follow Quickstart: REST for a complete quote-and-fill
example. The fields and checks below explain how to handle the execution request.
Fill body
POST /execution/fill requires quoteId from an executable quote
(Quotes & smart routing). The response status is always pending: the trade
is accepted, not done.
A
404 from GET /execution/status after this call is not final. Retry by following
Errors, retries & idempotency. Do not get a new quote until a step there says to.
Execute quote.
Direct orders: Direct orders. Limit orders:
Limit orders. Cancel with POST /execution/orders/cancel; a response can
stay cancel_pending, and a filled or already cancelled order returns 409. Compare these flows in
Choose your integration.
Measure order event delivery
Use the SDK’s optional receipt callback to capture when the client handles an order event. The server timestamp stays in milliseconds.deliveryDelayMs is null
when the clocks disagree or a server timestamp is missing.
Redeem
Claiming winnings is Market resolution & voids. EVM redemption completion is the WebSocket eventredeem_event.
Redeem winnings for resolved positions.
Checks at fill time
AGG checks these again when you fill, so a quote that looked fine can still be refused:- The user’s location against each venue in the route. A blocked venue returns
403. - Your app’s venue and category settings. Returns
400quote_app_blocked. - The market is still open. Returns
400quote_market_inactive. - The user’s balance still covers the trade. Returns
400quote_insufficient_balance. - Testing-mode trade cap. Returns
403.
Slippage and price protection
slipCapBps is how far from a reference price you accept, in basis points. 100 is 1%. On a buy
it caps the price per share. On a sell it floors it. maxSpend still bounds the total a buy can
cost, so the cap changes how many shares that spend buys, not how much is spent.
How the cap is used depends on how you place the order. A quote applies it twice. A direct order
with skipQuote applies it once.
With a quote
This covers Get a quote followed by Execute quote. It also covers Place an order directly withoutskipQuote,
which builds a quote for you before placing the order.
Your user sees the quoted price before committing. The quote’s
legBounds[] lists the worst
price each leg accepts as worstPrice, with the cap applied as effectiveSlippageBps.
With a direct order and skipQuote
Place an order directly with skipQuote skips
the router, so there is no quoting step. The order is sized from one price and sent straight to the
venue you name. The cap applies only at execution.
Here the cap only covers the moment between AGG accepting the order and the venue filling it. Send
the price your user saw as
price, so the cap protects a price they accepted. Use skipQuote only
when your backend needs the lower latency. Otherwise place the same order without it.
skipQuote rules are on Direct orders.
When the price moves past the cap
At execution, the order takes only the liquidity inside the cap. If none is left there when the order reaches the venue, the order fails. The reason says the price moved past the accepted quote and slippage. Read it aserrorReason on
Get execution status, or as errorMessage on
Get user orders. Nothing fills, and the funds are not spent. A direct order’s externalId is
used up.
Do not resend the same request. Read the current price, show it to your user, and on
confirmation place a new order with a new externalId, or request a new quote. Retrying unchanged
either fails again or fills at a price your user did not approve.
Choosing a cap
Prices move in steps, so a cap smaller than one step fails on any movement at all. Read the step from the market’stickSize on List venue markets or
Get live orderbooks. Many markets move in one-cent
steps, and one cent is a different share of each price:
A 1% cap (
100) therefore cannot absorb a single one-cent move at any price below 1. Set the cap
to at least one step plus a margin for how fast the market moves:
sellShares bounds the
shares sold, not the proceeds.
Venue rules at execution
OmittingslipCapBps, or sending 10000 or more, uses the venue’s default. These rules apply to
both quotes and direct orders.