Quote
Simulate a cross-venue fill for a predexon_id without placing an order
Overview
Simulate filling a single logical order across every routed venue that lists the outcome identified bypredexonId. The router expands the supplied canonical predexon_id to every routed venue listing for that outcome, walks merged fee-inclusive order books, and returns the projected fill price, per-venue breakdown, and fill likelihood.
No order is placed. Quote uses the same routing engine as Place Market Order, so a quote taken immediately before an order is a reliable preview of what the order will do.
See the Order Router concept page for an end-to-end walkthrough of how the router decides which venues to route to.
Path Parameters
Query Parameters
Response Fields
Top level
Venue entry
Summary
Errors
Every error response includes a machine-readableerrorCode alongside the human-readable error string.
Example
GET /api/accounts/acc_8f2e/router/quote?predexonId=px-uvtpjis2k7bj&side=buy&amount=10
bestPrice but a higher feeBpsAtTop can lose to a nominally worse venue with a thinner fee. feeBpsAtTop is price-aware, so different levels of the same book can surface different basis-point values.venues[] lists only venues the router can actionably route to right now. Venues without a streaming book (infrastructure dropouts) are excluded from the response. The number of entries is therefore the count of routable venues for this outcome, not the size of the cross-venue equivalence set.Authorizations
Trading key provided by Predexon. The data key used by the Sports Discovery API on api.predexon.com is a separate credential.
Path Parameters
Account ID. Must belong to the calling API key.
Query Parameters
Canonical predexon_id for the outcome. The router expands this to every routed venue listing for that canonical outcome.
Order side.
buy, sell USD/stablecoin notional to spend. Required when side=buy. Must not be set when side=sell.
Number of shares to sell. Required when side=sell. Must not be set when side=buy.
Response
Quote simulated successfully.
Echoes the request predexonId.
Human-readable outcome label (e.g. "Atlanta Hawks").
Canonical outcome code (e.g. "atl", "draw").
buy, sell Echo of the amount query parameter (stringified number). Present on buy quotes; null on sell quotes.
Echo of the size query parameter (stringified number). Present on sell quotes; null on buy quotes.
One entry per actionable venue — venues the router cannot currently route to (no book, or a disconnected feed) are excluded from the array entirely.
Aggregate projected fill. null when no venue could host any portion of the order.
