prophetx

ProphetX — 公共交易所市场（只读）

编写查询前，请先查阅 references/api-reference.md，了解运动项目代码和命令参数。

请先阅读——此技能可以和不可以返回的内容：

• ✅ 赛事（联赛）、比赛（含主队／客队、赛程、状态）、市场目录（独赢盘／让分盘／大小盘、替代盘口、v2 上的球员特别投注）、已匹配投注额（total_stake）、主盘口标记（favourite）。
• ✅ 交易所赔率（美式赔率）及其推导出的隐含概率——但仅限公开订单簿开放的市场。请检查每个市场的 selections_available；可用情况因市场而异（赛前核心市场通常有订单簿；滚球和活跃度低的市场通常会返回 [null, null]）。
• ❌ 无法保证每个市场都有赔率，也无法获取完整的订单簿深度／流动性。当 selections_available 为 False 时，只有市场结构和已匹配投注额——绝不可编造赔率。完整赔率覆盖仅能通过经过身份验证的 ProphetX Affiliate API 获取；它是独立的、需凭据的 Machina 连接器——绝不可将令牌接入此技能。

快速开始

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

sports-skills prophetx get_sports_config
sports-skills prophetx search_markets --sport=nfl --query="Eagles"
sports-skills prophetx get_todays_events --sport=mlb
sports-skills prophetx get_tournaments --sport=soccer
sports-skills prophetx get_markets --event_id=19742 --api_version=v2

Python SDK（替代方案）：

from sports_skills import prophetx

prophetx.get_sports_config()
prophetx.search_markets(sport="nfl", query="Eagles")
prophetx.get_todays_events(sport="mlb")
prophetx.get_events(109)                      # tournament_id
prophetx.get_markets(19742, api_version="v2") # event_id
prophetx.get_market(19742, 219)               # market id or "19742:219"

重要：执行任何查询前

• 市场 id 是市场类型 ID（219 = 任意比赛的独赢盘）——每场比赛稳定的唯一键是 market_key（"<event_id>:<market_id>"）。
• api_version="v2" 会添加类别、子类型、替代盘口（market_lines）和球员特别投注；默认的 v1 仅提供精简目录。v2 失败时会自动回退到 v1。
• 读取赔率字段前，请检查 selections_available——只有公开订单簿开放的市场才有赔率；绝不可将 total_stake（已匹配交易量）当作赔率或流动性。
• 运动项目代码：soccer、tennis、basketball、baseball、ice-hockey、american-football + 别名（nfl、nba、mlb、nhl、epl、mls、worldcup，等等）。

工作流

查找比赛市场

1. search_markets --sport=nfl --query="Eagles"——搜索最早开赛的匹配比赛及其市场。
2. 展示市场名称／类型／盘口；仅引用 selections_available: true 的市场赔率，并明确说明公开订单簿为空的市场。

今日赛程

1. get_todays_events --sport=mlb——获取今日比赛（UTC），含主队／客队和赛程。
2. 接着使用 get_markets --event_id=<id> --api_version=v2 获取完整目录（球员特别投注、替代盘口）。

探索交易所

1. get_sports_config——获取运动项目和正在进行的赛事。
2. get_tournaments --sport=soccer → get_events --tournament_id=<id>。

重要说明

• 设计为只读：无需登录、无需 Cookie、无需浏览器自动化，仅使用 GET 请求；采用保守的请求限流 + 缓存 + 指数退避重试；遇到 403／WAF 或架构漂移时会安全失败。
• 已观察到的比赛 status 值：not_started、live。
• _raw 会在每条规范化记录中保留完整的提供方负载。
• 跨平台统一发现：sports-skills markets search_entity --query="Yankees" 会包含 prophetx 部分（公开订单簿开放时，提供每个结果的盘口顶部赔率；未开放任何订单簿的比赛会通过 note 标记）。