Read a wallet's unpaid trading fees per venue
Preview: available on staging (https://staging-execution.kairos.trade); not yet released in production, where trade plans — the only source of this fee debt — return 503.
Trades placed through trade plans on Polymarket and Predict.fun accrue the Kairos fee and the partner fee as a debt per wallet and collateral asset; nothing is deducted inside the order. This read returns the debt per venue, the threshold at which POST /v3/trade-plans refuses new trades with FEE_SETTLEMENT_REQUIRED, and any open settlement.
owedRaw is a signed integer string in token base units: it is negative when confirmed payments exceed the fees booked so far (a credit carried against later fees). The threshold is set by Kairos per partner. A venue whose settlement rail is not offered is omitted.
Reading also advances settlements: it refreshes the open settlement from chain evidence and credits late payments. Hyperliquid has no fee debt on this API.
curl --request GET \
--url https://execution.kairos.trade/v3/fees \
--header 'Authorization: <api-key>' \
--header 'X-Kairos-Partner-Id: <api-key>'import requests
url = "https://execution.kairos.trade/v3/fees"
headers = {
"X-Kairos-Partner-Id": "<api-key>",
"Authorization": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Kairos-Partner-Id': '<api-key>', Authorization: '<api-key>'}
};
fetch('https://execution.kairos.trade/v3/fees', 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/v3/fees",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"X-Kairos-Partner-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/v3/fees"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Kairos-Partner-Id", "<api-key>")
req.Header.Add("Authorization", "<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/v3/fees")
.header("X-Kairos-Partner-Id", "<api-key>")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://execution.kairos.trade/v3/fees")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Kairos-Partner-Id"] = '<api-key>'
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"venues": [
{
"venue": "polymarket",
"holdingWallet": "0x2f9c4b8e1d7a6c5b4a3f2e1d0c9b8a7f6e5d4c3b",
"assetKey": "evm:137:0xc011a7e12a19f7b1f670d46f03b03f3342e82dfb",
"decimals": 6,
"owedRaw": "400000",
"thresholdRaw": "10000000",
"settlement": null
},
{
"venue": "predictfun",
"holdingWallet": "0x8ba1f109551bd432803012645ac136ddd64dba72",
"assetKey": "evm:56:0x55d398326f99059ff775485246999027b3197955",
"decimals": 18,
"owedRaw": "0",
"thresholdRaw": "10000000000000000000",
"settlement": null
}
]
}{
"error": "unknown or expired action"
}{
"error": "sign-in token has expired; run a login action"
}{
"error": "API key missing trade:read scope"
}{
"error": "wallet not found"
}{
"error": "rate limit exceeded for this endpoint; retry later"
}{
"error": "internal error"
}{
"error": "unknown or expired action"
}Authorizations
Wallet API partner id, issued by Kairos together with the partner's base URL. Identifies the partner (tenant) on every /v3 call; sent instead of an API key. Letters, digits and ._:-, at most 64 characters, case-insensitive. A partner id issued for an individual account cannot be sent this way — that account sends its API key triple instead.
Wallet sign-in token: SIWE <token>, where <token> is result.token from a login action (exactly one space after SIWE). Proves the wallet on reads of its orders and positions, and on trade plans, fee settlements and on-chain intents. The token is bound to the partner and the environment that issued it and lasts 24 hours; run a new login action to renew it.
Query Parameters
The wallet's EVM address. No other query parameter is accepted.
^0x[0-9a-fA-F]{40}$Response
Debt per venue.
Response of GET /v3/fees.
Show child attributes
Show child attributes
Was this page helpful?
curl --request GET \
--url https://execution.kairos.trade/v3/fees \
--header 'Authorization: <api-key>' \
--header 'X-Kairos-Partner-Id: <api-key>'import requests
url = "https://execution.kairos.trade/v3/fees"
headers = {
"X-Kairos-Partner-Id": "<api-key>",
"Authorization": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Kairos-Partner-Id': '<api-key>', Authorization: '<api-key>'}
};
fetch('https://execution.kairos.trade/v3/fees', 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/v3/fees",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"X-Kairos-Partner-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/v3/fees"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Kairos-Partner-Id", "<api-key>")
req.Header.Add("Authorization", "<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/v3/fees")
.header("X-Kairos-Partner-Id", "<api-key>")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://execution.kairos.trade/v3/fees")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Kairos-Partner-Id"] = '<api-key>'
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"venues": [
{
"venue": "polymarket",
"holdingWallet": "0x2f9c4b8e1d7a6c5b4a3f2e1d0c9b8a7f6e5d4c3b",
"assetKey": "evm:137:0xc011a7e12a19f7b1f670d46f03b03f3342e82dfb",
"decimals": 6,
"owedRaw": "400000",
"thresholdRaw": "10000000",
"settlement": null
},
{
"venue": "predictfun",
"holdingWallet": "0x8ba1f109551bd432803012645ac136ddd64dba72",
"assetKey": "evm:56:0x55d398326f99059ff775485246999027b3197955",
"decimals": 18,
"owedRaw": "0",
"thresholdRaw": "10000000000000000000",
"settlement": null
}
]
}{
"error": "unknown or expired action"
}{
"error": "sign-in token has expired; run a login action"
}{
"error": "API key missing trade:read scope"
}{
"error": "wallet not found"
}{
"error": "rate limit exceeded for this endpoint; retry later"
}{
"error": "internal error"
}{
"error": "unknown or expired action"
}