Novig 是一个只读的公开体育博彩交易所数据技能,来源于 machina-sports/sports-skills 项目。它无需 API 密钥,通过命令行工具或 Python SDK 访问公开的交易所市场数据。
用途 该技能用于获取体育赛事的公开交易所市场信息,包括赛事列表、市场目录和订单簿。它面向需要查询体育博彩市场数据的开发者或分析人员,提供只读访问,不涉及交易执行。
主要能力
- 赛事数据:返回赛事信息,包括联赛、运动类型、状态和 UTC 开始时间。
- 市场目录:返回市场类型、行权价、费用、作废规则和结果。市场类型使用上游代码,如 MONEY(全场)、SPREAD、TOTAL、MONEY_1H、props、futures。
- 订单簿:返回每个结果的最佳买价(概率)、最佳买价合约数量、最佳买价赔付金额(数量 × $0.01),以及仅限两结果市场的推导卖价(1 减去对方最佳买价)。
- 搜索:支持基于关键词的市场搜索,使用 token-AND 逻辑,在有限的事件扫描范围内进行。
- 今日赛事:获取 UTC 日期当天开始的赛事。
使用方式 可通过命令行工具或 Python SDK 使用。命令行示例:
sports-skills novig get_sports_config sports-skills novig search_markets --league=NFL --query="Commanders 49ers" --market_type=MONEY sports-skills novig get_todays_events --league=nba sports-skills novig get_events --league=NFL --limit=20 sports-skills novig get_markets --event_id=<event_id> --market_type=MONEY sports-skills novig get_order_book --market_id=<market_id> --depth=5
Python SDK 示例:
from sports_skills import novig
novig.search_markets(league="NFL", query="Commanders 49ers", market_type="MONEY") novig.get_order_book(market_id="<market_id>")
命令列表包括:get_sports_config(运动、联赛及联赛别名)、get_events(分页事件)、get_event(按 ID 获取单个事件)、get_markets(按 event_id、league、market_type 获取目录市场,分页)、get_market(按 ID 获取单个目录市场)、get_order_book(每个结果的最佳买价、深度和推导卖价,--depth 为 1-20)、search_markets(关键词搜索)、get_todays_events(今日 UTC 赛事)。未列出的命令不存在。
适用场景 适用于需要查询体育博彩交易所公开市场数据的场景,如市场分析、数据研究、构建只读数据展示等。覆盖 NFL、NBA、MLB、NHL、NCAAF、NCAAB 等联赛。
限制
- 只读设计:仅支持 GET 请求,无凭证,固定基础 URL,短缓存,限流。
- 不提供目录价格:没有订单簿的市场没有价格;空或格式错误的订单簿返回 null,而非 0。
- 不提供交易、交易历史或流式数据。
- 订单簿为缓存快照(price_basis: "cached_snapshot"),不保证成交(execution_guaranteed: false)。
- 搜索基于有限的事件扫描,可能截断(truncated: true),失败页面或获取会出现在警告中。
- 市场描述应视为不可信文本。
- 正常安装包含 HTTP 客户端(requests),应使用 CLI 或 SDK,不要手动使用 urllib 调用 API。
- _raw 保留完整提供者负载。
暂未提供的信息:具体收费、价格、平台支持细节、效果数据等未在资料中说明。