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.
curl --request GET \
--url https://execution.kairos.trade/orders/route-quote \
--header 'X-Api-Key: <api-key>' \
--header 'X-Api-Secret: <api-key>' \
--header 'X-Client-Id: <api-key>'import requests
url = "https://execution.kairos.trade/orders/route-quote"
headers = {
"X-Client-Id": "<api-key>",
"X-Api-Key": "<api-key>",
"X-Api-Secret": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Client-Id': '<api-key>',
'X-Api-Key': '<api-key>',
'X-Api-Secret': '<api-key>'
}
};
fetch('https://execution.kairos.trade/orders/route-quote', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://execution.kairos.trade/orders/route-quote",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>",
"X-Api-Secret: <api-key>",
"X-Client-Id: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://execution.kairos.trade/orders/route-quote"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Client-Id", "<api-key>")
req.Header.Add("X-Api-Key", "<api-key>")
req.Header.Add("X-Api-Secret", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://execution.kairos.trade/orders/route-quote")
.header("X-Client-Id", "<api-key>")
.header("X-Api-Key", "<api-key>")
.header("X-Api-Secret", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://execution.kairos.trade/orders/route-quote")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Client-Id"] = '<api-key>'
request["X-Api-Key"] = '<api-key>'
request["X-Api-Secret"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"routed": true,
"notes": [
"<string>"
],
"legs": [
{
"provider": "<string>",
"market_id": "<string>",
"token_id": "<string>",
"quantity": "<string>",
"limit_price": "<string>",
"effective_limit": "<string>",
"est_notional": "<string>",
"est_fee": "<string>",
"below_min_notional": true
}
],
"requested": "<string>",
"planned": "<string>",
"unfilled": "<string>",
"link_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"link_title": "<string>",
"blended_effective": "<string>",
"stop": "filled",
"cheaper_elsewhere": {
"provider": "kalshi",
"blended_effective": "<string>",
"delta_per_share": "<string>",
"reason": "not_connected"
}
}{
"error": "Unauthorized"
}Authorizations
Credential client id (kairos_ck_...). Must be sent together with X-Api-Key and X-Api-Secret.
64-char hex API key.
64-char hex API secret.
Query Parameters
The venue you are quoting from; any leg of the link, routable or not.
"polymarket"
yes or no, case-insensitive.
yes, no Decimal string, must be > 0.
"100"
Must be in [1, 99] if provided.
Response
The routing plan (check routed).
Response for GET /orders/route-quote. A quote that cannot be routed is still a 200 with routed set false — check the flag, not the status code.
Show child attributes
Show child attributes
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.
filled, exhausted, effective_cap, below_minimum A venue the caller cannot route to that would have filled the whole request at a strictly lower fee-inclusive price. Today only a Kalshi leg for an account with no Kalshi credential (reason: not_connected); null when no such venue beats the plan, or its book is not fresh. The plan itself never includes that venue.
Show child attributes
Show child attributes
Was this page helpful?
curl --request GET \
--url https://execution.kairos.trade/orders/route-quote \
--header 'X-Api-Key: <api-key>' \
--header 'X-Api-Secret: <api-key>' \
--header 'X-Client-Id: <api-key>'import requests
url = "https://execution.kairos.trade/orders/route-quote"
headers = {
"X-Client-Id": "<api-key>",
"X-Api-Key": "<api-key>",
"X-Api-Secret": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Client-Id': '<api-key>',
'X-Api-Key': '<api-key>',
'X-Api-Secret': '<api-key>'
}
};
fetch('https://execution.kairos.trade/orders/route-quote', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://execution.kairos.trade/orders/route-quote",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>",
"X-Api-Secret: <api-key>",
"X-Client-Id: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://execution.kairos.trade/orders/route-quote"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Client-Id", "<api-key>")
req.Header.Add("X-Api-Key", "<api-key>")
req.Header.Add("X-Api-Secret", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://execution.kairos.trade/orders/route-quote")
.header("X-Client-Id", "<api-key>")
.header("X-Api-Key", "<api-key>")
.header("X-Api-Secret", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://execution.kairos.trade/orders/route-quote")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Client-Id"] = '<api-key>'
request["X-Api-Key"] = '<api-key>'
request["X-Api-Secret"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"routed": true,
"notes": [
"<string>"
],
"legs": [
{
"provider": "<string>",
"market_id": "<string>",
"token_id": "<string>",
"quantity": "<string>",
"limit_price": "<string>",
"effective_limit": "<string>",
"est_notional": "<string>",
"est_fee": "<string>",
"below_min_notional": true
}
],
"requested": "<string>",
"planned": "<string>",
"unfilled": "<string>",
"link_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"link_title": "<string>",
"blended_effective": "<string>",
"stop": "filled",
"cheaper_elsewhere": {
"provider": "kalshi",
"blended_effective": "<string>",
"delta_per_share": "<string>",
"reason": "not_connected"
}
}{
"error": "Unauthorized"
}