KAkairos
Markets

Fetch multiple markets by id, one provider at a time

Fetches metadata for one provider and up to 200 market ids in a single call. Rate-limit bucket: LIGHT, flat cost of 1 unit regardless of batch size (unlike /v1/market-identifiers/resolve, this endpoint does NOT charge per-item). Not cached (Cache-Control: no-store) — every call returns live data.

Request body is capped at 1 MiB, and market_ids is capped at 200 entries per request (market_ids exceeds maximum 200).

Ids that cannot be found are omitted from markets and listed in misses.

post/v1/markets/batch

Request

  • Base URL
    https://md.kairos.trade
  • Auth
    • none
    • or API key in header X-Client-Id and API key in header X-Api-Key and API key in header X-Api-Secret

Request body

provider'kalshi' | 'polymarket' | 'opinion' | 'predictfun' | 'hyperliquid' | 'kalshi_offchain' | 'dome' required
market_idsstring[] required

Up to 200 market ids for the given provider.

Response

Batch lookup result, keyed by market_id.

exchange_idstring required
marketsobject required

Map of market_id → Market, for every requested id that was found.

missesstring[] required

market_ids from the request that were not found.

Example response

{
  "exchange_id": "polymarket"
}

Changes

No recorded changes to this operation across all 1 revision of this API.