# Kalshi 市场列表 API (kalshi.markets)

- Canonical page: https://everyinfra.com/kalshi-api/markets
- Endpoint: POST /api/v1/social with {"platform": "kalshi", "action": "markets", "params": {...}}
- Price: $0.006806 per call ($6.81 per 1,000 requests); failed and empty results are not charged
- Returns: list, default 20, max 100 per call
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=kalshi&action=markets

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| event_ticker | not declared | no | not declared | 只看一个事件下的市场：Kalshi 事件代码，例如 KXBTC2026200-27JAN01，取自返回行的 event_ticker。 |
| keyword | not declared | no | not declared | 在市场标题里搜的词，至少 3 个字，例如 bitcoin、fed、election；不传按排序列全站。 |
| sort | enum: close_time / open_interest / price_asc / price_desc / volume | no | not declared | volume（默认，按成交份数）、open_interest、price_desc、price_asc、close_time。 |
| status | enum: closed / open | no | not declared | open（默认，还在交易）或 closed（已结束、已结算）。 |
| limit | integer (1–100) | no | 20 | 这次调用最多返回的条数，整数，1–100；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| ticker | 市场代码（Kalshi 自己的写法）。 |
| event_ticker | 所属事件代码；可作为 markets 的 event_ticker 查同一事件下的其他市场。 |
| series_ticker | 所属系列代码。 |
| title | 标题。平台无标题概念时（如纯文本帖）为 null。 |
| event_title | 所属事件标题。 |
| yes_subtitle | Yes 一边的说明（如 Above $200000）。 |
| no_subtitle | No 一边的说明。 |
| status | 市场状态，Kalshi 原值（如 open、closed、settled）。 |
| result | 结算结果 yes / no；没结算时没有。 |
| last_price | 最近成交价，美元（0–1，一份合约结算时值 $1，可读作市场给的概率）。 |
| yes_bid | Yes 一边当前买价，美元。 |
| yes_ask | Yes 一边当前卖价，美元。 |
| no_bid | No 一边当前买价，美元。 |
| no_ask | No 一边当前卖价，美元。 |
| volume | 累计成交合约份数。 |
| open_interest | 未平仓合约份数。 |
| dollar_volume | 累计成交额，美元。 |
| dollar_open_interest | 未平仓金额，美元。 |
| strike_type | 行权方式，Kalshi 原值（如 greater、less、between）；不是数值区间型市场时没有。 |
| floor_strike | 下限行权值；没有时没有这个字段。 |
| cap_strike | 上限行权值；没有时没有这个字段。 |
| rules | 市场的主要结算规则原文。 |
| settlement_sources | 结算依据来源名称列表。 |
| open_at | 开盘时间，ISO 8601 UTC。 |
| close_at | 收盘时间，ISO 8601 UTC。 |
| settled_at | 结算时间，ISO 8601 UTC；没结算时没有。 |
| can_close_early | 条件提前满足时能否提前收盘。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "kalshi",
  "action": "markets",
  "params": {}
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "kalshi",
        "action": "markets",
        "params": {},
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

No real sample for these example parameters yet: structure only, every value is a placeholder (…).

```text
{
  "id": "req_…",
  "platform": "kalshi",
  "action": "markets",
  "results": [
    {
      "ticker": …,
      "event_ticker": …,
      "series_ticker": …,
      "title": …,
      "event_title": …,
      "yes_subtitle": …,
      "no_subtitle": …,
      "status": …,
      "result": …,
      "last_price": …,
      "yes_bid": …,
      "yes_ask": …,
      "no_bid": …,
      "no_ask": …,
      "volume": …,
      "open_interest": …,
      "dollar_volume": …,
      "dollar_open_interest": …,
      "strike_type": …,
      "floor_strike": …,
      "cap_strike": …,
      "rules": …,
      "settlement_sources": …,
      "open_at": …,
      "close_at": …,
      "settled_at": …,
      "can_close_early": …,
      "platform": …
    }
  ],
  "count": …,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=kalshi
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md