Markets

Batch fetch market metadata for multiple contracts

Batch variant of /markets/metadata, capped at 100 contracts. Contracts whose provider is currently inactive are dropped before processing; if that empties the batch the response is {}. Looks up the rest via a cached-metadata fast path, with a fallback for cache misses and non-Polymarket providers. Unless titles_only: true is set, three further best-effort enrichment passes run (each independently swallows its own errors and never fails the request):

API fallback — any contract still found: false is retried against the live provider API (same fallback /markets/metadata uses), for markets too new to be indexed.
Category inference — markets with no category get one inferred from Kalshi crypto ticker patterns or crypto keywords in the title (bitcoin/ethereum/solana/xrp/“btc ”/“eth ”/“sol ”).
Tag icon enrichment — resolves market-to-platform-tag mappings and assigns the highest-precedence tag’s icon as tag_icon; can also backfill category from the tag’s slug (crypto/politics/sports/esports/finance/tech/world). Note: Polymarket order-book liquidity-rewards enrichment (used by the single-market /markets/metadata) is intentionally not run here — this endpoint feeds list views where the rewards badge doesn’t render.

POST

markets

metadata

batch

Batch fetch market metadata for multiple contracts

curl --request POST \
  --url https://data.kairos.trade/markets/metadata/batch \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-Secret: <api-key>' \
  --header 'X-Client-Id: <api-key>' \
  --data '
{
  "contracts": [
    {
      "ticker": "KXBTC15M-26JUL221600-00",
      "provider": "kalshi"
    },
    {
      "ticker": "0x1234abcd...ef",
      "provider": "polymarket"
    }
  ],
  "titles_only": false
}
'

import requests

url = "https://data.kairos.trade/markets/metadata/batch"

payload = {
    "contracts": [
        {
            "ticker": "KXBTC15M-26JUL221600-00",
            "provider": "kalshi"
        },
        {
            "ticker": "0x1234abcd...ef",
            "provider": "polymarket"
        }
    ],
    "titles_only": False
}
headers = {
    "X-Client-Id": "<api-key>",
    "X-Api-Key": "<api-key>",
    "X-Api-Secret": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Client-Id': '<api-key>',
    'X-Api-Key': '<api-key>',
    'X-Api-Secret': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    contracts: [
      {ticker: 'KXBTC15M-26JUL221600-00', provider: 'kalshi'},
      {ticker: '0x1234abcd...ef', provider: 'polymarket'}
    ],
    titles_only: false
  })
};

fetch('https://data.kairos.trade/markets/metadata/batch', 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://data.kairos.trade/markets/metadata/batch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'contracts' => [
        [
                'ticker' => 'KXBTC15M-26JUL221600-00',
                'provider' => 'kalshi'
        ],
        [
                'ticker' => '0x1234abcd...ef',
                'provider' => 'polymarket'
        ]
    ],
    'titles_only' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://data.kairos.trade/markets/metadata/batch"

	payload := strings.NewReader("{\n  \"contracts\": [\n    {\n      \"ticker\": \"KXBTC15M-26JUL221600-00\",\n      \"provider\": \"kalshi\"\n    },\n    {\n      \"ticker\": \"0x1234abcd...ef\",\n      \"provider\": \"polymarket\"\n    }\n  ],\n  \"titles_only\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Client-Id", "<api-key>")
	req.Header.Add("X-Api-Key", "<api-key>")
	req.Header.Add("X-Api-Secret", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://data.kairos.trade/markets/metadata/batch")
  .header("X-Client-Id", "<api-key>")
  .header("X-Api-Key", "<api-key>")
  .header("X-Api-Secret", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"contracts\": [\n    {\n      \"ticker\": \"KXBTC15M-26JUL221600-00\",\n      \"provider\": \"kalshi\"\n    },\n    {\n      \"ticker\": \"0x1234abcd...ef\",\n      \"provider\": \"polymarket\"\n    }\n  ],\n  \"titles_only\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://data.kairos.trade/markets/metadata/batch")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Client-Id"] = '<api-key>'
request["X-Api-Key"] = '<api-key>'
request["X-Api-Secret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"contracts\": [\n    {\n      \"ticker\": \"KXBTC15M-26JUL221600-00\",\n      \"provider\": \"kalshi\"\n    },\n    {\n      \"ticker\": \"0x1234abcd...ef\",\n      \"provider\": \"polymarket\"\n    }\n  ],\n  \"titles_only\": false\n}"

response = http.request(request)
puts response.read_body

{}

{
  "detail": "<string>"
}

{
  "detail": "Not authenticated"
}

{
  "detail": "Invite required"
}

{
  "detail": "Request body too large"
}

{
  "detail": [
    {}
  ]
}

{
  "error": "Rate limit exceeded: 100 per 1 minute"
}

{
  "detail": "Batch fetch failed"
}

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

contracts

object[]

required

Maximum array length: 100

Show child attributes

titles_only

boolean

default:false

When true, skips the API fallback, category inference, and tag-icon enrichment passes — returns whatever was already cached directly.

Response

Metadata items keyed by the requested ticker. Every requested ticker (whose provider wasn't hidden) appears, with found: false for unresolved ones.

Metadata items keyed by the requested ticker.

{key}

object

Show child attributes

Batch fetch market metadata for multiple contracts

curl --request POST \
  --url https://data.kairos.trade/markets/metadata/batch \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-Secret: <api-key>' \
  --header 'X-Client-Id: <api-key>' \
  --data '
{
  "contracts": [
    {
      "ticker": "KXBTC15M-26JUL221600-00",
      "provider": "kalshi"
    },
    {
      "ticker": "0x1234abcd...ef",
      "provider": "polymarket"
    }
  ],
  "titles_only": false
}
'

import requests

url = "https://data.kairos.trade/markets/metadata/batch"

payload = {
    "contracts": [
        {
            "ticker": "KXBTC15M-26JUL221600-00",
            "provider": "kalshi"
        },
        {
            "ticker": "0x1234abcd...ef",
            "provider": "polymarket"
        }
    ],
    "titles_only": False
}
headers = {
    "X-Client-Id": "<api-key>",
    "X-Api-Key": "<api-key>",
    "X-Api-Secret": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Client-Id': '<api-key>',
    'X-Api-Key': '<api-key>',
    'X-Api-Secret': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    contracts: [
      {ticker: 'KXBTC15M-26JUL221600-00', provider: 'kalshi'},
      {ticker: '0x1234abcd...ef', provider: 'polymarket'}
    ],
    titles_only: false
  })
};

fetch('https://data.kairos.trade/markets/metadata/batch', 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://data.kairos.trade/markets/metadata/batch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'contracts' => [
        [
                'ticker' => 'KXBTC15M-26JUL221600-00',
                'provider' => 'kalshi'
        ],
        [
                'ticker' => '0x1234abcd...ef',
                'provider' => 'polymarket'
        ]
    ],
    'titles_only' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://data.kairos.trade/markets/metadata/batch"

	payload := strings.NewReader("{\n  \"contracts\": [\n    {\n      \"ticker\": \"KXBTC15M-26JUL221600-00\",\n      \"provider\": \"kalshi\"\n    },\n    {\n      \"ticker\": \"0x1234abcd...ef\",\n      \"provider\": \"polymarket\"\n    }\n  ],\n  \"titles_only\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Client-Id", "<api-key>")
	req.Header.Add("X-Api-Key", "<api-key>")
	req.Header.Add("X-Api-Secret", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://data.kairos.trade/markets/metadata/batch")
  .header("X-Client-Id", "<api-key>")
  .header("X-Api-Key", "<api-key>")
  .header("X-Api-Secret", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"contracts\": [\n    {\n      \"ticker\": \"KXBTC15M-26JUL221600-00\",\n      \"provider\": \"kalshi\"\n    },\n    {\n      \"ticker\": \"0x1234abcd...ef\",\n      \"provider\": \"polymarket\"\n    }\n  ],\n  \"titles_only\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://data.kairos.trade/markets/metadata/batch")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Client-Id"] = '<api-key>'
request["X-Api-Key"] = '<api-key>'
request["X-Api-Secret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"contracts\": [\n    {\n      \"ticker\": \"KXBTC15M-26JUL221600-00\",\n      \"provider\": \"kalshi\"\n    },\n    {\n      \"ticker\": \"0x1234abcd...ef\",\n      \"provider\": \"polymarket\"\n    }\n  ],\n  \"titles_only\": false\n}"

response = http.request(request)
puts response.read_body

{}

{
  "detail": "<string>"
}

{
  "detail": "Not authenticated"
}

{
  "detail": "Invite required"
}

{
  "detail": "Request body too large"
}

{
  "detail": [
    {}
  ]
}

{
  "error": "Rate limit exceeded: 100 per 1 minute"
}

{
  "detail": "Batch fetch failed"
}

Overview

Market Data API

Data API

Execution API

Agora Auction API

REST Guides

Market Data Guides

RPC Guides

RFQ Guides

WebSocket Guides

Krisis Guides

Batch fetch market metadata for multiple contracts

Authorizations

Body

Response