Markets

Current valid tick grid for one market

Returns the grid of valid price increments the venue CURRENTLY enforces for a market — the same grid the order executor validates against. It describes the grid; it never snaps or rounds a price. Served from the market metadata cache, which the orderbook streamer keeps current with the venue's live tick changes. Rate-limit bucket: LIGHT.

  • polymarket — a single flat range over [0, 1]; the venue flips 0.01↔0.001 at the price extremes. Pass asset_id (the CLOB token id) to read the per-token tick, which is where a live change lands first.
  • kalshi — the market's price_ranges (a tapered grid). min_tick is the finest step. If only the deprecated flat tick_size is present the response is a single flat range flagged synthetic: true.
  • predictfun — supported: false; the venue exposes no per-market tick. No grid is fabricated.

Query parameters and the response body are wire-compatible with the Data API's GET /markets/tick-size; as_of (when the grid was read from the metadata cache) is additive. start / end / step / min_tick are decimal strings so precision is never lost. Cached for 5 seconds (public, max-age=5 with a strong ETag).

get/v1/markets/tick-size

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

Query parameters

provider'kalshi' | 'polymarket' | 'predictfun' required
contract_idstring required

Kalshi ticker, or Polymarket condition id / market id.

asset_idstring

Polymarket CLOB token id. Enables the per-token read; ignored for other providers.

Response

The market's current tick grid, or the explicit unsupported payload for predictfun.

OR

Example response

{
  "ranges": [
    {
      "start": "0.04",
      "end": "0.96",
      "step": "0.01"
    }
  ],
  "min_tick": "0.001"
}

Changes

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