Kalshi
Prediction-market data.
获取 Kalshi 市场
使用文档记载的 status、ticker、event、series 和时间戳筛选条件列出预测市场。本契约包含 max_updated_ts，但未声明自由文本搜索参数。市场记录和分页请遵循响应结构。
计费参考
- 计量方式：按成功请求的固定成本计费。
- 参考请求估算：0.02 美元。
仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。
- 类型: stringcursor
分页游标。使用上一次响应返回的游标值获取下一页结果。第一页留空。
- 类型: stringevent
_ticker 用于筛选的事件 ticker。仅支持单个事件 ticker。
- 类型: integer 格式: int64limit最小值:0最大值:1000
每页结果数。默认 100，最大值为 1000。
- 类型: integer 格式: int64max
_close _ts 筛选在该 Unix 时间戳之前关闭的条目
- 类型: integer 格式: int64max
_created _ts 筛选在该 Unix 时间戳之前创建的条目
- 类型: integer 格式: int64max
_settled _ts 筛选在该 Unix 时间戳之前结算的条目
- 类型: integer 格式: int64max
_updated _ts 返回元数据更新时间早于或等于该 Unix 时间戳（秒）的市场。仅跟踪非交易类变更。可与 min_updated_ts 和 mve_filter=exclude 组合使用。也可与 series_ticker 组合，但此时要求 mve_filter=exclude。与其他筛选条件不兼容。
- 类型: integer 格式: int64min
_close _ts 筛选在该 Unix 时间戳之后关闭的条目
- 类型: integer 格式: int64min
_created _ts 筛选在该 Unix 时间戳之后创建的条目
- 类型: integer 格式: int64min
_settled _ts 筛选在该 Unix 时间戳之后结算的条目
- 类型: integer 格式: int64min
_updated _ts 返回元数据更新时间晚于该 Unix 时间戳（秒）的市场。仅跟踪非交易类变更。可与 max_updated_ts 和 mve_filter=exclude 组合使用。也可与 series_ticker 组合，但此时要求 mve_filter=exclude。与其他筛选条件不兼容。
- 类型: string 枚举mve
_filter 按多变量事件（组合）筛选。'only' 仅返回多变量事件，'exclude' 排除多变量事件。
值- only
- exclude
- 类型: stringseries
_ticker 按系列 ticker 筛选
- 类型: string 枚举status
按市场状态筛选。留空则返回任意状态的市场。
值- unopened
- open
- paused
- closed
- settled
- 类型: stringtickers
按特定市场 ticker 筛选。以逗号分隔的市场 ticker 列表。
- 类型: object · Response24B585A0A861_GetMarketsResponse200
市场获取成功
- 类型: stringcursor必填
- 类型: array object[] · Response24B585A0A861_Market[]markets必填
- can类型: boolean
_close _early 必填 - close类型: string 格式: date-time
_time 必填the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- created类型: string 格式: date-time
_time 必填the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- event类型: string
_ticker 必填 - expiration类型: string
_value 必填结算时考虑的值
- last类型: string · Response24B585A0A861_FixedPointDollars
_price _dollars 必填定点美元字符串。多数请求字段接受 2–4 位小数（例如 "0.56"、"0.5600"）；响应最多输出 6 位小数。给定市场的有效报价间隔受该市场价格档位结构约束。
- latest类型: string 格式: date-time
_expiration _time 必填该市场可能的最晚到期时间
- market类型: string 枚举
_type 必填标识市场类型
值- binary
- scalar
- no类型: string · Response24B585A0A861_FixedPointDollars
_ask _dollars 必填定点美元字符串。多数请求字段接受 2–4 位小数（例如 "0.56"、"0.5600"）；响应最多输出 6 位小数。给定市场的有效报价间隔受该市场价格档位结构约束。
- no类型: string · Response24B585A0A861_FixedPointDollars
_bid _dollars 必填定点美元字符串。多数请求字段接受 2–4 位小数（例如 "0.56"、"0.5600"）；响应最多输出 6 位小数。给定市场的有效报价间隔受该市场价格档位结构约束。
- no类型: string
_sub _title 必填该市场 NO 一侧的简称
- notional类型: string · Response24B585A0A861_FixedPointDollars
_value _dollars 必填定点美元字符串。多数请求字段接受 2–4 位小数（例如 "0.56"、"0.5600"）；响应最多输出 6 位小数。给定市场的有效报价间隔受该市场价格档位结构约束。
- open类型: string · Response24B585A0A861_FixedPointCount
_interest _fp 必填定点合约数量字符串（2 位小数，例如 "10.00"；在字段名中称为 "fp"）。请求接受 0–2 位小数（例如 "10"、"10.0"、"10.00"）；响应始终输出 2 位小数。支持小数合约值（例如 "2.50"）；最小粒度为 0.01 份合约。
- open类型: string 格式: date-time
_time 必填the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- previous类型: string · Response24B585A0A861_FixedPointDollars
_price _dollars 必填定点美元字符串。多数请求字段接受 2–4 位小数（例如 "0.56"、"0.5600"）；响应最多输出 6 位小数。给定市场的有效报价间隔受该市场价格档位结构约束。
- previous类型: string · Response24B585A0A861_FixedPointDollars
_yes _ask _dollars 必填定点美元字符串。多数请求字段接受 2–4 位小数（例如 "0.56"、"0.5600"）；响应最多输出 6 位小数。给定市场的有效报价间隔受该市场价格档位结构约束。
- previous类型: string · Response24B585A0A861_FixedPointDollars
_yes _bid _dollars 必填定点美元字符串。多数请求字段接受 2–4 位小数（例如 "0.56"、"0.5600"）；响应最多输出 6 位小数。给定市场的有效报价间隔受该市场价格档位结构约束。
- price类型: string
_level _structure 必填该市场的价格档位结构，定义价格区间和最小变动价位
- price类型: array object[] · Response24B585A0A861_PriceRange[]
_ranges 必填该市场订单的有效价格区间
- end类型: string必填
该价格区间的结束价格（美元）
- start类型: string必填
该价格区间的起始价格（美元）
- step类型: string必填
该价格区间的价格步长/最小变动价位（美元）
- result类型: string 枚举必填值
- yes
- no
- scalar
- rules类型: string
_primary 必填对最重要的市场条款的通俗说明
- rules类型: string
_secondary 必填对二级市场条款的通俗说明
- settlement类型: string 枚举
_bounds _type 必填适用于该市场的结算边界。default 表示该市场没有结算边界
值- default
- floor
- settlement类型: integer
_timer _seconds 必填市场确定后到结算之间的时间
- status类型: string 枚举必填
市场在生命周期中的当前状态。
值- initialized
- inactive
- active
- closed
- determined
- disputed
- amended
- finalized
- ticker类型: string必填
- updated类型: string 格式: date-time
_time 必填最近一次非交易类元数据更新的时间。
- volume类型: string · Response24B585A0A861_FixedPointCount
_24h _fp 必填定点合约数量字符串（2 位小数，例如 "10.00"；在字段名中称为 "fp"）。请求接受 0–2 位小数（例如 "10"、"10.0"、"10.00"）；响应始终输出 2 位小数。支持小数合约值（例如 "2.50"）；最小粒度为 0.01 份合约。
- volume类型: string · Response24B585A0A861_FixedPointCount
_fp 必填定点合约数量字符串（2 位小数，例如 "10.00"；在字段名中称为 "fp"）。请求接受 0–2 位小数（例如 "10"、"10.0"、"10.00"）；响应始终输出 2 位小数。支持小数合约值（例如 "2.50"）；最小粒度为 0.01 份合约。
- yes类型: string · Response24B585A0A861_FixedPointDollars
_ask _dollars 必填定点美元字符串。多数请求字段接受 2–4 位小数（例如 "0.56"、"0.5600"）；响应最多输出 6 位小数。给定市场的有效报价间隔受该市场价格档位结构约束。
- yes类型: string · Response24B585A0A861_FixedPointCount
_ask _size _fp 必填定点合约数量字符串（2 位小数，例如 "10.00"；在字段名中称为 "fp"）。请求接受 0–2 位小数（例如 "10"、"10.0"、"10.00"）；响应始终输出 2 位小数。支持小数合约值（例如 "2.50"）；最小粒度为 0.01 份合约。
- yes类型: string · Response24B585A0A861_FixedPointDollars
_bid _dollars 必填定点美元字符串。多数请求字段接受 2–4 位小数（例如 "0.56"、"0.5600"）；响应最多输出 6 位小数。给定市场的有效报价间隔受该市场价格档位结构约束。
- yes类型: string · Response24B585A0A861_FixedPointCount
_bid _size _fp 必填定点合约数量字符串（2 位小数，例如 "10.00"；在字段名中称为 "fp"）。请求接受 0–2 位小数（例如 "10"、"10.0"、"10.00"）；响应始终输出 2 位小数。支持小数合约值（例如 "2.50"）；最小粒度为 0.01 份合约。
- yes类型: string
_sub _title 必填该市场 YES 一侧的简称
- cap类型: number | null 格式: double
_strike 导致 YES 结算的最大到期值
- custom类型: object | null
_strike 每个目标导致 YES 结算的到期值
- early类型: string | null
_close _condition 市场可以提前关闭的条件
- exchange类型: integer · Response24B585A0A861_ExchangeIndex
_index 交易所分片的标识符。
- expected类型: string | null 格式: date-time
_expiration _time 该市场的预期到期时间
- expiration类型: string 格式: date-time
_time 已弃用the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- fee类型: string | null 格式: date-time
_waiver _expiration _time 该市场手续费豁免的到期时间
- floor类型: number | null 格式: double
_strike 导致 YES 结算的最小到期值
- functional类型: string | null
_strike 从到期值到结算值的映射
- is类型: boolean
_provisional 为 true 时，市场在确定后若没有任何活动，可能会被移除
- mve类型: string
_collection _ticker 多变量事件集合的 ticker
- mve类型: array object[] · Response24B585A0A861_MveSelectedLeg[]
_selected _legs - event类型: string
_ticker 所选事件的唯一标识符
- market类型: string
_ticker 所选市场的唯一标识符
- side类型: string
所选市场的一侧
- yes类型: string · Response24B585A0A861_FixedPointDollars
_settlement _value _dollars 定点美元字符串。多数请求字段接受 2–4 位小数（例如 "0.56"、"0.5600"）；响应最多输出 6 位小数。给定市场的有效报价间隔受该市场价格档位结构约束。
- occurrence类型: string | null 格式: date-time
_datetime 底层事件发生时的记录日期时间（若有）
- primary类型: string | null
_participant _key - settlement类型: string · Response24B585A0A861_FixedPointDollars
_floor _dollars 定点美元字符串。多数请求字段接受 2–4 位小数（例如 "0.56"、"0.5600"）；响应最多输出 6 位小数。给定市场的有效报价间隔受该市场价格档位结构约束。
- settlement类型: string | null 格式: date-time
_ts 市场结算的时间戳。仅对已结算的市场填充
- settlement类型: string · Response24B585A0A861_FixedPointDollars
_value _dollars 定点美元字符串。多数请求字段接受 2–4 位小数（例如 "0.56"、"0.5600"）；响应最多输出 6 位小数。给定市场的有效报价间隔受该市场价格档位结构约束。
- strike类型: string 枚举
_type 行权价类型定义市场行权价的设定与评估方式
值- greater
- greater
_or _equal - less
- less
_or _equal - between
- functional
- custom
- structured
- subtitle类型: string已弃用
- title类型: string已弃用
application/json - 400
无法处理该请求。请检查请求参数。
- 401
需要有效的 Felo API 密钥。
- 402
由于未满足计费要求，请求无法继续。
- 403
该账户无权执行此操作。
- 429
已达到请求或支出限额。
- 502
服务无法完成该请求。
- 503
API 或计费服务暂时不可用。
- 504
服务在处理请求时超时。
- default
错误响应；上游透传响应可能采用提供方格式
application/json
curl https://openapi.felo.ai/v1/beta/kalshi/markets \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"markets": [
{
"ticker": "string",
"event_ticker": "string",
"market_type": "binary",
"yes_sub_title": "string",
"no_sub_title": "string",
"created_time": "2026-10-26T08:08:16.601Z",
"updated_time": "2026-10-26T08:08:16.601Z",
"open_time": "2026-10-26T08:08:16.601Z",
"close_time": "2026-10-26T08:08:16.601Z",
"expected_expiration_time": null,
"latest_expiration_time": "2026-10-26T08:08:16.601Z",
"settlement_timer_seconds": 1,
"status": "initialized",
"yes_bid_dollars": "0.5600",
"yes_bid_size_fp": "10.00",
"yes_ask_dollars": "0.5600",
"yes_ask_size_fp": "10.00",
"no_bid_dollars": "0.5600",
"no_ask_dollars": "0.5600",
"last_price_dollars": "0.5600",
"volume_fp": "10.00",
"volume_24h_fp": "10.00",
"result": "yes",
"can_close_early": true,
"open_interest_fp": "10.00",
"notional_value_dollars": "0.5600",
"previous_yes_bid_dollars": "0.5600",
"previous_yes_ask_dollars": "0.5600",
"previous_price_dollars": "0.5600",
"settlement_value_dollars": "0.5600",
"settlement_ts": null,
"settlement_bounds_type": "default",
"settlement_floor_dollars": "0.5600",
"expiration_value": "string",
"occurrence_datetime": null,
"fee_waiver_expiration_time": null,
"early_close_condition": null,
"strike_type": "greater",
"floor_strike": null,
"cap_strike": null,
"functional_strike": null,
"custom_strike": null,
"rules_primary": "string",
"rules_secondary": "string",
"mve_collection_ticker": "string",
"mve_selected_legs": [
{
"event_ticker": "string",
"market_ticker": "string",
"side": "string",
"yes_settlement_value_dollars": "0.5600"
}
],
"primary_participant_key": null,
"price_level_structure": "string",
"price_ranges": [
{
"start": "string",
"end": "string",
"step": "string"
}
],
"is_provisional": true,
"exchange_index": 0
}
],
"cursor": "string"
}