需要把 ESPN 赛程与…

在 ESPN 赛程与 Kalshi、Polymarket 预测市场之间做统一看板、赔率对比、实体搜索、套利检测与投注评估。

适用场景

解决思路

1. 调用任何编排命令前，先查阅 references/api-reference.md 确认支持的 sport 代码、命令参数与价格归一化格式。
2. 对依赖运动的命令（get_todays_markets、compare_odds、get_sport_markets、evaluate_market）必须提供 sport 代码。
3. 归一化前先确认价格来源：espn = American odds，polymarket = 0-1 概率，kalshi = 0-100 整数。
4. 用 get_todays_markets --sport=nba 获取当日看板：每场比赛的 ESPN 信息、DraftKings 赔率、匹配的 Kalshi 市场与 Polymarket 市场。
5. 用 search_entity --query="Lakers" --sport=nba 在两个平台跨平台搜索球队/球员市场，返回价格与成交量。
6. 找特定比赛的套利：先用 get_sport_schedule --sport=nba 拿到 ESPN event ID，再调用 compare_odds --sport=nba --event_id=<id>。
7. 若检测到套利，响应会给出分配比例与 ROI，但基于 reference 价格（price_basis: "reference"），交易前必须在各场馆订单簿上确认两条腿。
8. 查看 sources 与 completeness 字段确认哪些场馆实际为该比赛定价；提供方错误会以 error 报告，而不是显示为“无市场”。
9. 完整投注评估：调用 evaluate_market --sport=nba --event_id=<id> --outcome=0 --fee_per_contract=<每张 $1 合约的费用>。
10. evaluate_market 会先验证该市场确实是本场比赛的整场获胜方市场，再从订单簿读取 ask 价。
11. evaluate_market 将 ask + fee 传入 betting.evaluate_bet：devig → edge → Kelly，返回公平概率、edge、EV、Kelly 比例与建议。
12. 未提供 fee_per_contract 时只报告 ask，evaluation 为 null——拒绝给出净收益数字而不是假设零费用。
13. 若 ticker 或 token_id 指向另一支球队、另一个日期或衍生市场（上半场、让分），会被拒绝而不是替换。
14. 费用目前无法通过 CLI 设置，需使用 Python 包装：markets.evaluate_market(..., fee_per_contract=...)。
15. 同一场比赛跨两个场馆：调用 match_markets --sport=mlb --date=2026-06-06，按日期 + 球队代码确定性连接（标题模糊匹配为后备），配对 Kalshi 事件（含 market tickers）与 Polymarket 事件（含 moneyline token IDs）。
16. 将 kalshi.market_tickers[i] 与 polymarket.markets[i].token_ids[j] 直接传入 get_market_price 比较价格。
17. 查询单点历史价格：get_market_price --venue=kalshi --ticker=<ticker> --at_time=2026-05-01，返回 yes/no 两侧 0-1 价格。
18. 查询完整价格序列：get_price_history --venue=kalshi --ticker=<ticker> --interval=1d，两个场馆返回相同的 {timestamp, price} 结构。
19. 用 normalize_price --price=0.65 --source=polymarket 做价格转换，返回隐含概率（0.65）、American odds（-185.7）与 decimal（1.54）的统一结构。
20. 不要调用不存在的命令：get_odds（改用 compare_odds）、search_markets（改用 search_entity）、get_schedule（改用 get_sport_schedule）。
21. 若某命令未列在 references/api-reference.md 中，即视为不存在。
22. 排错：某运动无市场返回时，检查 sport 代码是否正确（如 nba、epl、laliga）。
23. 排错：compare_odds 对某事件无数据时，先调用 get_sport_schedule(sport=...) 获取正确 event_id。
24. 排错：某来源出现警告时，说明 Kalshi 或 Polymarket 暂时不可用，使用部分结果，并单独用 kalshi 或 polymarket 技能重试该来源。
25. 排错：normalize_price 返回异常 American odds 时，检查 source 参数——Kalshi 用 0-100 整数，Polymarket 用 0-1 小数。

适用边界 · 注意事项

• 用户只想要原始预测市场数据、不需要 ESPN 上下文时——直接用 polymarket 或 kalshi 技能。
• 用户只做纯赔率数学（转换、去水、Kelly）时——使用 betting 技能。
• 用户只要实时比分、不需要市场数据时——使用对应运动的专项技能。