Kalshi
Prediction-market data.
获取 Kalshi 交易
获取 Kalshi 市场的已成交交易记录——是实际成交，而非报价。当需要某段时间内的已实现价格和成交量时使用，例如查看事件发展过程中市场信心的变化；用 ticker 与 min_ts / max_ts 的 Unix 秒范围缩小范围，并设置 is_block_trade 以筛选大额协议交易。返回 trades[]，包含 trade_id、ticker、count_fp（合约数）、yes_price_dollars / no_price_dollars、taker_side 和 created_time，另有用于分页的 cursor。若需要当前报价、结算规则和市场元数据而非成交记录，请使用 get_kalshi_markets。
计费参考
- 计量方式：按成功请求的固定成本计费。
- 参考请求估算：0.02 美元。
仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。
- 类型: stringcursor
分页游标。使用上一次响应返回的游标值获取下一页结果。第一页留空。
- 类型: booleanis
_block _trade 按是否为大宗交易筛选成交。省略则返回所有成交。设为
true仅返回大宗交易，设为false仅返回非大宗交易。 - 类型: integer 格式: int64limit最小值:0最大值:1000
每页结果数。默认 100，最大值为 1000。
- 类型: integer 格式: int64max
_ts 筛选在该 Unix 时间戳之前的条目
- 类型: integer 格式: int64min
_ts 筛选在该 Unix 时间戳之后的条目
- 类型: stringticker
按市场 ticker 筛选
- 类型: object · Response24B585A0A861_GetTradesResponse200
交易获取成功
- 类型: stringcursor必填
- 类型: array object[] · Response24B585A0A861_Trade[]trades必填
- count类型: string · Response24B585A0A861_FixedPointCount
_fp 必填定点合约数量字符串（2 位小数，例如 "10.00"；在字段名中称为 "fp"）。请求接受 0–2 位小数（例如 "10"、"10.0"、"10.00"）；响应始终输出 2 位小数。支持小数合约值（例如 "2.50"）；最小粒度为 0.01 份合约。
- created类型: string 格式: date-time
_time 必填该笔成交的执行时间戳
- is类型: boolean
_block _trade 必填若该笔成交作为大额协议交易在订单簿之外撮合（例如通过 RFQ / 协商大额协议提案）则为 true；在标准订单簿上成交的为 false。
- no类型: string · Response24B585A0A861_FixedPointDollars
_price _dollars 必填定点美元字符串。多数请求字段接受 2–4 位小数（例如 "0.56"、"0.5600"）；响应最多输出 6 位小数。给定市场的有效报价间隔受该市场价格档位结构约束。
- taker类型: string · Response24B585A0A861_BookSide枚举
_book _side 必填订单或成交在订单簿中的方向。对于事件市场，这仅指 YES 一侧：
bid表示买入 YES，ask表示卖出 YES。（卖出 YES 在经济上等同于以1 - price买入 NO，但此端点始终从 YES 一侧报价。）值- bid
- ask
- taker类型: string 枚举
_outcome _side 必填taker 所持的结果方向。buy-yes 和 sell-no 产生 'yes'；buy-no 和 sell-yes 产生 'no'。
taker_outcome_side仅描述方向性敞口，不改变成交价格。价格为p、taker_outcome_side=no的成交，会与方向相反、价格同为p的 maker 撮合——双方以相同价格成交。taker_outcome_side和taker_book_side将成为判定成交方向的标准方式。旧版taker_side字段将在未来版本中弃用——请迁移到这些新字段。值- yes =
Trade Taker Outcome Side Yes - no =
Trade Taker Outcome Side No
- ticker类型: string必填
市场的唯一标识符
- trade类型: string
_id 必填该笔成交的唯一标识符
- yes类型: string · Response24B585A0A861_FixedPointDollars
_price _dollars 必填定点美元字符串。多数请求字段接受 2–4 位小数（例如 "0.56"、"0.5600"）；响应最多输出 6 位小数。给定市场的有效报价间隔受该市场价格档位结构约束。
- taker类型: string 枚举
_side 已弃用已弃用。请改用
taker_outcome_side（或taker_book_side）。参见订单方向。此字段不会在 2026 年 5 月 14 日之前移除。值- yes =
Trade Taker Side Yes - no =
Trade Taker Side No
application/json - 400
无法处理该请求。请检查请求参数。
- 401
需要有效的 Felo API 密钥。
- 402
由于未满足计费要求，请求无法继续。
- 403
该账户无权执行此操作。
- 429
已达到请求或支出限额。
- 502
服务无法完成该请求。
- 503
API 或计费服务暂时不可用。
- 504
服务在处理请求时超时。
- default
错误响应；上游透传响应可能采用提供方格式
application/json
curl https://openapi.felo.ai/v1/beta/kalshi/trades \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"trades": [
{
"trade_id": "string",
"ticker": "string",
"count_fp": "10.00",
"yes_price_dollars": "0.5600",
"no_price_dollars": "0.5600",
"taker_outcome_side": "yes",
"taker_book_side": "bid",
"created_time": "2026-10-26T08:08:16.607Z",
"is_block_trade": true
}
],
"cursor": "string"
}