Markets

Get one market's metadata

Returns the full metadata document for a single market. Rate-limit bucket: LIGHT.

Provider is resolved case-insensitively against the registry (aliases such as kalshi_offchain → kalshi and dome → polymarket are accepted and normalized before the lookup).

Response is ETagged (strong ETag) with a Cache-Control header; a matching If-None-Match returns 304. Responses ≥1KB are gzip-compressed when the client sends Accept-Encoding: gzip.

GET

markets

{provider}

{market_id}

Get one market's metadata

curl --request GET \
  --url https://md.kairos.trade/v1/markets/{provider}/{market_id} \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-Secret: <api-key>' \
  --header 'X-Client-Id: <api-key>'

import requests

url = "https://md.kairos.trade/v1/markets/{provider}/{market_id}"

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://md.kairos.trade/v1/markets/{provider}/{market_id}', 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://md.kairos.trade/v1/markets/{provider}/{market_id}",
  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://md.kairos.trade/v1/markets/{provider}/{market_id}"

	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://md.kairos.trade/v1/markets/{provider}/{market_id}")
  .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://md.kairos.trade/v1/markets/{provider}/{market_id}")

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

{
  "exchange_id": "polymarket",
  "market_id": "1897040",
  "condition_id": "0xabc123...",
  "event_id": "evt-4521",
  "title": "Will BTC close above $120k on July 31?",
  "neg_risk": false,
  "tick_size": 0.01,
  "taker_base_fee_bps": 200,
  "fees_enabled": true,
  "category": "Crypto",
  "group_slug": "btc-price-2026",
  "fee_type": "standard",
  "status": "active",
  "image": "https://cdn.kairos.trade/markets/1897040.png",
  "icon": "https://cdn.kairos.trade/markets/1897040-icon.png",
  "end_date": "2026-07-31T23:59:59Z",
  "open_time": "2026-01-01T00:00:00Z",
  "outcomes": [
    {
      "outcome": "Yes",
      "normalized_outcome": "yes",
      "token_id": "18812649149814341758733697580460697418474693998558159483117"
    },
    {
      "outcome": "No",
      "normalized_outcome": "no",
      "token_id": "88123409981238091823740918237409182734091823740918237409182"
    }
  ],
  "raw": {}
}

{
  "error": {
    "code": "invalid_request",
    "message": "unknown provider \"coinbase\""
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "valid X-Client-Id, X-Api-Key, and X-Api-Secret headers are required"
  }
}

{
  "error": {
    "code": "ip_not_whitelisted",
    "message": "source IP not in credential whitelist"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "market not found"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "rate limit exceeded"
  }
}

{
  "error": {
    "code": "internal",
    "message": "authentication backend unavailable"
  }
}

{
  "error": {
    "code": "upstream",
    "message": "metadata cache request failed"
  }
}

{
  "error": {
    "code": "cache_cold",
    "message": "metadata cache warming up, retry shortly"
  }
}

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. Must be sent together with X-Client-Id and X-Api-Secret.

X-Api-Secret

string

header

required

64-char hex API secret. Must be sent together with X-Client-Id and X-Api-Key.

Path Parameters

provider

enum<string>

required

Venue identifier. Case-insensitive; aliases are normalized (kalshi_offchain→kalshi, dome→polymarket). Unknown values are rejected with 400.

Available options:

kalshi,

polymarket,

opinion,

predictfun,

hyperliquid,

kalshi_offchain,

dome

market_id

string

required

Venue-specific market identifier (e.g. a Kalshi ticker, or a Polymarket/predict.fun numeric market id or condition id).

Response

Market metadata document.

Full market metadata document. Resolution-state fields (resolution_status, payout_numerators, resolved_ts, proposed_price, challenge_window_ends_at) are present in the payload only when set — the overwhelming majority of markets are unresolved and omit all five.

exchange_id

string

required

Canonical provider name.

Example:

"polymarket"

market_id

string

required

Example:

"1897040"

condition_id

string

required

On-chain condition id for CTF venues; empty string for kalshi.

Example:

"0xabc123..."

event_id

string

required

Grouping event id (multi-market events); may be empty.

Example:

"evt-4521"

title

string

required

Example:

"Will BTC close above $120k on July 31?"

neg_risk

boolean

required

Whether this market is part of a Polymarket negative-risk group.

Example:

false

outcomes

object[]

required

Show child attributes

raw

object

required

Full, unmodified provider-specific market document. Shape varies by provider. Treat as opaque/pass-through.

tick_size

number | null

Minimum price increment (0, 1) exclusive.

Example:

0.01

taker_base_fee_bps

integer | null

Example:

200

fees_enabled

boolean | null

category

string | null

Example:

"Crypto"

group_slug

string | null

Example:

"btc-price-2026"

fee_type

string | null

Example:

"standard"

status

string | null

Venue-reported market status, e.g. active/closed. Populated inconsistently across providers.

Example:

"active"

image

string | null

Display image URL.

icon

string | null

Display icon URL.

end_date

string | null

ISO8601 UTC market end/close time.

Example:

"2026-07-31T23:59:59Z"

open_time

string | null

ISO8601 UTC market open/listing time.

Example:

"2026-01-01T00:00:00Z"

resolution_status

string

Present only when the market has resolution state.

Example:

"resolved"

payout_numerators

integer<uint64>[]

Present only when non-empty (i.e. the market has resolved with a payout vector).

Example:

[1, 0]

resolved_ts

string

ISO8601 UTC. Present only when set.

Example:

"2026-07-16T00:00:00Z"

proposed_price

number

Present only when set (a resolution price has been proposed).

Example:

1

challenge_window_ends_at

string

ISO8601 UTC. Present only when set.

Example:

"2026-07-16T02:00:00Z"

Get one market's metadata

curl --request GET \
  --url https://md.kairos.trade/v1/markets/{provider}/{market_id} \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-Secret: <api-key>' \
  --header 'X-Client-Id: <api-key>'

import requests

url = "https://md.kairos.trade/v1/markets/{provider}/{market_id}"

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://md.kairos.trade/v1/markets/{provider}/{market_id}', 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://md.kairos.trade/v1/markets/{provider}/{market_id}",
  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://md.kairos.trade/v1/markets/{provider}/{market_id}"

	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://md.kairos.trade/v1/markets/{provider}/{market_id}")
  .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://md.kairos.trade/v1/markets/{provider}/{market_id}")

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

{
  "exchange_id": "polymarket",
  "market_id": "1897040",
  "condition_id": "0xabc123...",
  "event_id": "evt-4521",
  "title": "Will BTC close above $120k on July 31?",
  "neg_risk": false,
  "tick_size": 0.01,
  "taker_base_fee_bps": 200,
  "fees_enabled": true,
  "category": "Crypto",
  "group_slug": "btc-price-2026",
  "fee_type": "standard",
  "status": "active",
  "image": "https://cdn.kairos.trade/markets/1897040.png",
  "icon": "https://cdn.kairos.trade/markets/1897040-icon.png",
  "end_date": "2026-07-31T23:59:59Z",
  "open_time": "2026-01-01T00:00:00Z",
  "outcomes": [
    {
      "outcome": "Yes",
      "normalized_outcome": "yes",
      "token_id": "18812649149814341758733697580460697418474693998558159483117"
    },
    {
      "outcome": "No",
      "normalized_outcome": "no",
      "token_id": "88123409981238091823740918237409182734091823740918237409182"
    }
  ],
  "raw": {}
}

{
  "error": {
    "code": "invalid_request",
    "message": "unknown provider \"coinbase\""
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "valid X-Client-Id, X-Api-Key, and X-Api-Secret headers are required"
  }
}

{
  "error": {
    "code": "ip_not_whitelisted",
    "message": "source IP not in credential whitelist"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "market not found"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "rate limit exceeded"
  }
}

{
  "error": {
    "code": "internal",
    "message": "authentication backend unavailable"
  }
}

{
  "error": {
    "code": "upstream",
    "message": "metadata cache request failed"
  }
}

{
  "error": {
    "code": "cache_cold",
    "message": "metadata cache warming up, retry shortly"
  }
}

Overview

Market Data API

Data API

Execution API

Agora Auction API

REST Guides

Market Data Guides

RPC Guides

RFQ Guides

WebSocket Guides

Krisis Guides

Get one market's metadata

Authorizations

Path Parameters

Response