KAkairos
Routing

Price a size across the legs of an approved cross-venue market link

Plans a buy across the venues of an approved market link the caller can route to and returns the per-leg sizes, limit prices and fee estimates it would use, without submitting anything. POST /orders/route-buy executes the same plan. Routable legs are per caller: Polymarket and Predict.fun always, Hyperliquid when routing is enabled, Kalshi only for an account with a Kalshi credential connected. A Kalshi leg that would have filled the request at a strictly lower fee-inclusive price than the plan is reported in cheaper_elsewhere with reason: not_connected; it is never planned. A plan that cannot be built is still a 200 with routed: false — no approved link for this market, sources unavailable, or no routable leg with a live book. Only caller-input errors are 400. Auth & scope. Requires trade:read for provider.

get/orders/route-quote

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

Query parameters

providerstring required
Example:polymarket

The venue you are quoting from; any leg of the link, routable or not.

market_idstring required
side'yes' | 'no' required

yes or no, case-insensitive.

quantitystring required
Example:100

Decimal string, must be > 0.

slippage_centsinteger

Must be in [1, 99] if provided.

Response

The routing plan (check routed).

routedboolean required
link_idstring uuid nullable
link_titlestring nullable
notesstring[] required
requestedstring required
plannedstring required
unfilledstring required
blended_effectivestring nullable
stop'filled' | 'exhausted' | 'effective_cap' | 'below_minimum' nullable

Why planning stopped. below_minimum means every venue leg fell under its venue's minimum order (Polymarket $1.00, Predict.fun 0.90 USD, Hyperliquid its configured USDC minimum), so nothing was planned; each exclusion is a notes entry ending minimum order — leg excluded.

Example response

{
  "cheaper_elsewhere": {
    "provider": "kalshi"
  }
}

Changes

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