Routing

Buy a size split across both legs of an approved cross-venue market link

Executes the plan GET /orders/route-quote previews: creates a parent route row and submits one child order per leg. Children go through the same validation, admission and rate limiting as POST /orders. Partial success is a 200. status is always submitting; a leg that failed to submit has order_id: null and a populated legs[].error. Track the parent via GET /orders/routes and the children via GET /orders/{order_id}. Feature-gated. Disabled unless ROUTED_EXECUTION_ENABLED is set on the deployment; otherwise every call is a 403. Auth & scope. Requires the mutation gate (API-key triple satisfies it). This handler enforces no scope of its own — each child order carries the normal trade:execute and per-provider checks.

post/orders/route-buy

Request

  • Base URL
    https://execution.kairos.trade
  • Auth
    API key in header X-Client-Id and API key in header X-Api-Key and API key in header X-Api-Secret

Request body

providerstring required
market_idstring required
side'yes' | 'no' nullable

yes or no. Supply this or outcome.

outcomestring nullable

Venue-native outcome label, as an alternative to side.

quantitystring required

Decimal string, must be > 0.

slippage_centsinteger nullable

Must be in [1, 99] if provided.

Response

Route created and children dispatched. Inspect legs[].error for per-leg failures.

route_order_idstring uuid required
status'submitting' required

Always submitting — children are dispatched asynchronously. Poll GET /orders/routes.

requestedstring required
plannedstring required
notesstring[] required

Changes

No recorded changes to this operation across all 1 revision of this API.