Skip to main content
POST
Buy a size split across both legs of an approved cross-venue market link

Authorizations

X-Client-Id
string
header
required

Credential client id (kairos_ck_...). Must be sent together with X-Api-Key and X-Api-Secret.

X-Api-Key
string
header
required

64-char hex API key.

X-Api-Secret
string
header
required

64-char hex API secret.

Body

application/json

Body for POST /orders/route-buy.

provider
string
required
market_id
string
required
quantity
string
required

Decimal string, must be > 0.

side
enum<string> | null

yes or no. Supply this or outcome.

Available options:
yes,
no
outcome
string | null

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

slippage_cents
integer | null

Must be in [1, 99] if provided.

Response

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

Response for POST /orders/route-buy. Individual legs can fail while the request succeeds — always inspect legs[].error.

route_order_id
string<uuid>
required
status
enum<string>
required

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

Available options:
submitting
requested
string
required
planned
string
required
legs
object[]
required
notes
string[]
required