Kalshi 预测市场 API 与 Python SDK 使用指南 - 体育赛事数据分析与交易

kalshi by machina-sports/sports-skills

212 周安装量

62 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/machina-sports/sports-skills --skill kalshi

数据分析金融科技 API

🇨🇳中文介绍

Kalshi — 预测市场

在编写查询之前，请查阅 references/api-reference.md 以了解体育代码、系列代码和命令参数。

快速开始

推荐使用 CLI — 它可以避免 Python 导入路径问题：

sports-skills kalshi search_markets --sport=nba
sports-skills kalshi get_todays_events --sport=nba
sports-skills kalshi get_sports_config
sports-skills kalshi get_markets --series_ticker=KXNBA --status=open

Python SDK（备选方案）：

from sports_skills import kalshi

kalshi.search_markets(sport='nba')
kalshi.search_markets(sport='nba', query='Lakers')
kalshi.get_todays_events(sport='nba')
kalshi.get_sports_config()
kalshi.get_markets(series_ticker="KXNBA", status="open")

重要提示：在任何查询之前

重要提示：在调用任何市场端点之前，请验证：

对于单场比赛市场，sport 参数总是传递给 search_markets 和。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

体育市场搜索（推荐）

search_markets --sport=nba — 查找所有开放的 NBA 市场。
可选添加 --query="Lakers" 以按关键词过滤。
结果包含每个市场的 yes_bid、no_bid、volume。

get_todays_events --sport=nba — 包含嵌套市场的开放赛事。
展示带有价格的赛事（价格 = 隐含概率，0-100 标度）。

get_markets --series_ticker=<ticker> --status=open
按 last_price 降序排序。
展示具有概率和交易量的顶级竞争者。

从 search_markets --sport=nba 获取市场代码。
get_market_candlesticks --series_ticker=<s> --ticker=<t> --start_ts=<start> --end_ts=<end> --period_interval=60
展示带有交易量的 OHLC 数据。

有关完整命令列表及参数，请参阅 references/api-reference.md。

命令	描述
`get_sports_config`	可用的体育代码和系列代码
`get_todays_events`	某个体育项目今日的赛事及其嵌套市场
`search_markets`	按体育项目和/或关键词查找市场
`get_markets`	市场列表（原始 API）
`get_event`	赛事详情
`get_market`	市场详情
`get_trades`	近期交易
`get_market_candlesticks`	OHLC 价格历史

示例 1：NBA 市场搜索 用户说："Kalshi 上有哪些 NBA 市场？" 操作：

调用 search_markets(sport='nba') 结果：所有开放的 NBA 市场，包含是/否价格和交易量

示例 2：英超比赛市场 用户说："在 Kalshi 上显示利兹联对阵曼城的赔率" 操作：

调用 search_markets(sport='epl', query='Leeds') 结果：所有英超系列中与利兹联相关的英超市场，包含价格和交易量

示例 3：今日英超赛事 用户说："Kalshi 上有哪些英超比赛？" 操作：

调用 get_todays_events(sport='epl') 结果：今日的英超赛事及其嵌套市场

示例 4：欧冠联赛期货 用户说："谁会赢得欧冠联赛？" 操作：

调用 search_markets(sport='ucl') 或 get_markets(series_ticker="KXUCL", status="open")
按 last_price 降序排序（价格 = 隐含概率）结果：欧冠顶级竞争者，包含 yes_sub_title、last_price（%）和交易量

示例 5：市场价格历史 用户说："显示这场 NBA 比赛的价格历史" 操作：

从 search_markets(sport='nba') 获取市场代码
调用 get_market_candlesticks(series_ticker="KXNBA", ticker="...", start_ts=..., end_ts=..., period_interval=60) 结果：包含交易量的 OHLC 价格数据

不存在的命令 — 切勿调用这些

~~get_odds~~ — 不存在。使用 search_markets 或 get_markets 来查找市场价格。
~~get_team_schedule~~ — 不存在。Kalshi 提供市场，而非赛程。请使用特定体育项目的技能来获取赛程。
~~get_scores~~ / ~~get_results~~ — 不存在。Kalshi 是预测市场。请使用特定体育项目的技能。

如果某个命令未在 references/api-reference.md 中列出，则它不存在。

错误： search_markets 返回 0 个结果 原因： 缺少 sport 参数 — 没有它，搜索仅返回高交易量的期货市场，而错过单场比赛市场 解决方案： 始终向 search_markets 传递 sport='<code>'。检查 references/api-reference.md 以获取有效的体育代码

错误： 返回的市场包含已结算/过期的合约 原因： 未设置 status 参数 解决方案： 始终传递 status="open" 以仅筛选出开放市场

错误： 系列代码未返回结果 原因： 系列代码可能不正确或没有开放市场 解决方案： 调用 get_series_list() 来发现可用的代码，或检查 references/series-tickers.md

错误： 搜索 "Football" 时未找到足球市场 原因： 在 Kalshi 上，"Football" 指 NFL — 足球使用特定联赛代码 解决方案： 对于足球联赛，使用 sport='epl'、sport='ucl'、sport='laliga' 等

🇺🇸English

Kalshi — Prediction Markets

Before writing queries, consult references/api-reference.md for sport codes, series tickers, and command parameters.

Quick Start

Prefer the CLI — it avoids Python import path issues:

sports-skills kalshi search_markets --sport=nba
sports-skills kalshi get_todays_events --sport=nba
sports-skills kalshi get_sports_config
sports-skills kalshi get_markets --series_ticker=KXNBA --status=open

Python SDK (alternative):

from sports_skills import kalshi

kalshi.search_markets(sport='nba')
kalshi.search_markets(sport='nba', query='Lakers')
kalshi.get_todays_events(sport='nba')
kalshi.get_sports_config()
kalshi.get_markets(series_ticker="KXNBA", status="open")

CRITICAL: Before Any Query

CRITICAL: Before calling any market endpoint, verify:

The sport parameter is always passed to search_markets and get_todays_events for single-game markets.
Prices are on a 0-100 integer scale (20 = 20% implied probability) — do not treat as American odds.
status="open" is used when querying markets to exclude settled/closed markets.

Without the sport parameter:

WRONG: search_markets(query="Leeds")           → 0 results
RIGHT: search_markets(sport='epl', query='Leeds') → returns all Leeds markets

Important Notes

On Kalshi, "Football" = NFL. For football/soccer (EPL, La Liga, etc.), use sport codes: epl, ucl, laliga, bundesliga, seriea, ligue1, mls.
Prices are probabilities. A last_price of 20 means 20% implied probability. Scale is 0-100 (not 0-1 like Polymarket).
Always usestatus="open" when querying markets, otherwise results include settled/closed markets.
Shared interface with Polymarket: search_markets(sport=...), , and work the same way on both platforms.

Workflows

Sport Market Search (Recommended)

search_markets --sport=nba — finds all open NBA markets.
Optionally add --query="Lakers" to filter by keyword.
Results include yes_bid, no_bid, volume for each market.

Today's Events

get_todays_events --sport=nba — open events with nested markets.
Present events with prices (price = implied probability, 0-100 scale).

Futures Market Check

get_markets --series_ticker=<ticker> --status=open
Sort by last_price descending.
Present top contenders with probability and volume.

Market Price History

Get market ticker from search_markets --sport=nba.
get_market_candlesticks --series_ticker=<s> --ticker=<t> --start_ts=<start> --end_ts=<end> --period_interval=60
Present OHLC with volume.

Commands

See references/api-reference.md for the full command list with parameters.

Command	Description
`get_sports_config`	Available sport codes and series tickers
`get_todays_events`	Today's events for a sport with nested markets
`search_markets`	Find markets by sport and/or keyword
`get_markets`	Market listing (raw API)
`get_event`	Event details
`get_market`	Market details

Examples

Example 1: NBA market search User says: "What NBA markets are on Kalshi?" Actions:

Call search_markets(sport='nba') Result: All open NBA markets with yes/no prices and volume

Example 2: EPL game markets User says: "Show me Leeds vs Man City odds on Kalshi" Actions:

Call search_markets(sport='epl', query='Leeds') Result: Leeds EPL markets across all EPL series with prices and volume

Example 3: Today's EPL events User says: "What EPL games are available on Kalshi?" Actions:

Call get_todays_events(sport='epl') Result: Today's EPL events with nested markets

Example 4: Champions League futures User says: "Who will win the Champions League?" Actions:

Call search_markets(sport='ucl') or get_markets(series_ticker="KXUCL", status="open")
Sort by last_price descending (price = implied probability) Result: Top UCL contenders with yes_sub_title, last_price (%), and volume

Example 5: Market price history User says: "Show me the price history for this NBA game" Actions:

Get market ticker from search_markets(sport='nba')
Call get_market_candlesticks(series_ticker="KXNBA", ticker="...", start_ts=..., end_ts=..., period_interval=60) Result: OHLC price data with volume

Commands that DO NOT exist — never call these

~~get_odds~~ — does not exist. Use search_markets or get_markets to find market prices.
~~get_team_schedule~~ — does not exist. Kalshi has markets, not schedules. Use the sport-specific skill for schedules.
~~get_scores~~ / ~~get_results~~ — does not exist. Kalshi is a prediction market. Use the sport-specific skill.

If a command is not listed in references/api-reference.md, it does not exist.

Troubleshooting

Error: search_markets returns 0 results Cause: The sport parameter is missing — without it, search only returns high-volume futures and misses single-game markets Solution: Always pass sport='<code>' to search_markets. Check references/api-reference.md for valid sport codes

Error: Markets returned include settled/expired contracts Cause: status parameter is not set Solution: Always pass status="open" to filter to open markets only

Error: Series ticker returns no results Cause: The series ticker may be incorrect or have no open markets Solution: Call get_series_list() to discover available tickers, or check references/series-tickers.md

Error: Football/soccer markets not found when searching "Football" Cause: On Kalshi, "Football" refers to NFL — soccer uses league-specific codes Solution: Use sport='epl', sport='ucl', sport='laliga', etc. for soccer leagues

Weekly Installs

163

Repository

machina-sports/…s-skills

GitHub Stars

First Seen

Feb 16, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

codex149

gemini-cli146

opencode146

cursor138

github-copilot137

kimi-cli131

DOCX文件创建、编辑与分析完整指南 - 使用docx-js、Pandoc和Python脚本

50,600 周安装

get_todays_events(sport=...)

get_sports_config()