AGG is currently in alpha. APIs, components, and docs may change.
Agg.market — Prediction Market Aggregator logo

Compute order route

Computes a fill quote across available venues for a specific venue market outcome and returns the suggested fills.

GEThttps://api.agg.market/orderbook/{venueMarketOutcomeId}/route

Computes a fill quote across available venues for a specific venue market outcome and returns the suggested fills. When a user JWT is supplied the quote is scoped to the user's wallet balances and may be executed; without a JWT the response is a preview-only quote.

Loading code example
Loading code example

Authorizations

appIdstringheaderrequired

API key passed in the header.

Path Parameters

venueMarketOutcomeIdstringrequired

Query Parameters

mode"live" | "paper"
Allowed values: "live" | "paper"
chainBalancesstring
slipCapBpsnumber
Required range: x >= 0
maxSpendnumber
Required range: x >= 0
sellSharesnumber
Required range: x >= 0
compareVenues"true" | "false"
Allowed values: "true" | "false"
allowedVenuesany
side"buy" | "sell"
Allowed values: "buy" | "sell"
deepEstimate"true" | "false"
Allowed values: "true" | "false"

Response

application/json

200

quoteIdstringrequired
venueMarketOutcomeIdstringrequired
venueMarketIdstringrequired
estimatedCostRawstringrequired
expiresAtstringrequired
refreshAtstringrequired
status"ok" | "infeasible" | "checker_rejected" | "solver_error" | "invalid_input" | "no_orderbooks" | "insufficient_input_amount" | "engine_unavailable" | "min_order_size_violated" | "insufficient_balance" | "insufficient_position" | "insufficient_depth" | "no_bids_above_min_price"required
Allowed values: "ok" | "infeasible" | "checker_rejected" | "solver_error" | "invalid_input" | "no_orderbooks" | "insufficient_input_amount" | "engine_unavailable" | "min_order_size_violated" | "insufficient_balance" | "insufficient_position" | "insufficient_depth" | "no_bids_above_min_price"
fillsarray<object>required
fills.venuestringrequired
fills.venueMarketIdstringrequired
fills.venueMarketOutcomeIdstringrequired
fills.chainstringrequired
fills.avgPricenumberrequired
fills.yesPricenumberrequired
fills.noPricenumberrequired
fills.fillsarray<object>required
fills.venueQtynumberrequired
fills.venueFeenumber
totalFillednumberrequired
rawExecCostnumberrequired
solveTimeMsnumberrequired
verifyTimeMsnumberrequired
matchedMarketsarray<object>required
matchedMarkets.venuestringrequired
matchedMarkets.venueMarketIdstringrequired
errorstring
venueSoloQuotesarray<object>
venueSoloQuotes.quoteIdstringrequired
venueSoloQuotes.venuestringrequired
venueSoloQuotes.avgPricenumberrequired
venueSoloQuotes.filledQtynumberrequired
venueSoloQuotes.rawExecCostnumberrequired
venueSoloQuotes.estimatedPayoutnumberrequired
venueSoloQuotes.estimatedProfitnumberrequired
venueSoloQuotes.returnPctnumberrequired
venueSoloQuotes.statusstringrequired
venueSoloQuotes.fillsarray<object>required
venueSoloQuotes.allocationsarray<object>
venueSoloQuotes.bridgeStepsarray<object>
venueSoloQuotes.setupCostsarray<object>
venueSoloQuotes.setupCostsTotalnumber
allocationsarray<object>
allocations.sourceChainIdstringrequired
allocations.venuestringrequired
allocations.amountnumberrequired
allocations.sourceTokenAddressstring
allocations.custodyKind"EOA" | "DEPOSIT_WALLET"
Allowed values: "EOA" | "DEPOSIT_WALLET"
allocations.custodyAddressstring
allocations.exactTokenboolean
bridgeStepsarray<object>
bridgeSteps.sourceChainIdstringrequired
bridgeSteps.destChainIdstringrequired
bridgeSteps.amountnumberrequired
bridgeSteps.costnumberrequired
bridgeSteps.sourceTokenAddressstring
bridgeSteps.destTokenAddressstring
feeBreakdownobject
feeBreakdown.rawExecCostnumberrequired
feeBreakdown.venueFeesnumberrequired
feeBreakdown.bridgeFeesnumberrequired
feeBreakdown.executionGasnumberrequired
feeBreakdown.totalCostnumberrequired
feeBreakdown.setupCostsarray<object>
feeBreakdown.setupCostsTotalnumber
feeBreakdown.appFeenumber
feeBreakdown.appFeeBipsnumber
feeBreakdown.appFeeCategorystring
slippageobject
slippage.vwapnumberrequired
slippage.refMidpointnumberrequired
slippage.slippagenumberrequired
slippage.slippageBpsnumberrequired
optimaobject
optima.maxFilledQtynumberrequired
optima.minSlippagenumberrequired
optima.minCostnumberrequired
optima.minRisknumberrequired
optima.minBridgesnumberrequired
optima.minVenuesnumberrequired
warningsarray<object>
warnings.venuestringrequired
warnings.venueMarketOutcomeIdstringrequired
warnings.reasonstringrequired
messagestring
settlementPlanobject
settlementPlan.redeemIdstringrequired
settlementPlan.status"redeem_only" | "partial_redeem"required
Allowed values: "redeem_only" | "partial_redeem"
settlementPlan.messagestringrequired
settlementPlan.totalRedeemableSharesnumberrequired
settlementPlan.totalRedeemSharesnumberrequired
settlementPlan.totalSellSharesnumberrequired
settlementPlan.redeemLegsarray<object>required
estimatedPayoutnumber
totalCostIncFeesnumber
estimatedProfitnumber
returnPctnumber
positionAvailabilityobject
positionAvailability.totalSellableSharesnumberrequired
positionAvailability.venueMarketOutcomesarray<object>required