# Agent402 Kalshi Live Market Data

> Agent402 Kalshi Live Market Data is a paid API for AI agents from agent402.tools, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-16).

Fetches live price series, candlestick chart data, and event details for a Kalshi prediction market contract by event or series ticker

## Facts

- Endpoint: POST https://agent402.tools/api/kalshi-live-data?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-kalshi-live-market-data-f9c3a16a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_b3JZff8_iYYUYPQBkptv9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent402-kalshi-live-market-data-f9c3a16a -d '<json body>'
```

Example prompt: Pull the latest live market data for the Kalshi BTC series KXBTC, showing the 1-hour chart range with up to 200 data points, so I can see the current price and candlestick history.

## When to prefer this

Choose this endpoint when you need live or recent Kalshi prediction market data — including price series, OHLC candlesticks, and event maturity details — for crypto or macro events like BTC price or CPI outcomes. Prefer it over generic crypto price APIs when you specifically need Kalshi contract pricing or want to track a prediction market rather than a spot exchange price.

## Known failure modes

- Invalid or unknown eventTicker/seriesTicker returns an error or empty result
- Requesting a range not supported by the event type may return null range
- Exceeding limit max of 1000 is silently capped
- Event already resolved may return isHistorical=true with no live data
- x402 payment failure if insufficient USDC balance

## How this service works

The live feed a Kalshi event settles on, from Kalshi's free live_data tier: a crypto event returns the CF Benchmarks price series, candlesticks (15M, 1M) and the maturity time; an economic-data event (CPI, jobs) returns the provider's series with the target period. Pass an eventTicker, or a seriesTicker (e.g. KXBTC) and the soonest open event is resolved for you. The type field names the schema of details.

## Output

Returns a JSON object containing the latest price point with timestamp, a time series array, OHLC candlestick data grouped by interval, event metadata (ticker, maturity timestamp), the data source ('kalshi'), available range options, and a flag indicating whether the event is historical or live.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "description": "Newest points to keep per series and per candlestick interval (default 200, max 1000)."
  },
  "range": {
   "type": "string",
   "description": "Chart range hint for types that support it: 15min, 1h, 3h, 1d, 1w, 1m, 1y, 5y, all."
  },
  "eventTicker": {
   "type": "string",
   "description": "Kalshi event ticker, e.g. KXBTC-26SEP1817. Either this or seriesTicker."
  },
  "seriesTicker": {
   "type": "string",
   "description": "Kalshi series ticker, e.g. KXBTC or KXCPI - the soonest open event of the series is resolved."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "coin": "BTC",
  "type": "crypto",
  "range": null,
  "latest": {
   "time": "2026-09-18T16:22:00.000Z",
   "value": 80867.31
  },
  "series": [
   {
    "time": "2026-09-18T16:22:00.000Z",
    "value": 80867.31
   }
  ],
  "source": "kalshi",
  "details": {
   "coin": "BTC",
   "event_ticker": "KXBTC-26SEP1817",
   "maturity_ts_ms": 1789765200000
  },
  "eventTicker": "KXBTC-26SEP1817",
  "seriesCount": 5,
  "candlesticks": [
   {
    "count": 5,
    "candles": [
     {
      "low": 80664.65,
      "high": 80868.42,
      "open": 80703.13,
      "time": "2026-09-18T16:15:00.000Z",
      "close": 80867.31
     }
    ],
    "interval": "15M"
   }
  ],
  "defaultRange": "1h",
  "isHistorical": false,
  "maturityTime": "2026-09-18T21:00:00.000Z",
  "rangeOptions": [
   "15min",
   "1h",
   "3h"
  ],
  "resolvedFrom": {
   "title": "BTC price range on Sep 18, 2026 at 5pm EDT?",
   "strikeDate": "2026-09-18T21:00:00Z",
   "seriesTicker": "KXBTC"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-kalshi-live-market-data-f9c3a16a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)