flash-props-api

Flash Props API + MCP

Flash Props API 是 Flash AI Solutions 提供的球员数据 API 和 MCP 服务，可用于查看各项运动和电竞的已发布盘口、Flash 预测、证据、背景信息和盘口变动。

本仓库是托管版 Flash Props API 和 MCP 服务的公开连接器和元数据入口。本仓库不提供可供安装的专有 Flash Props 后端服务。将客户端指向托管端点，并使用 Flash Props API 密钥进行身份验证，即可获取盘口数据。

Flash Props 官方链接

• 网站：https://api.flashodds.live/
• 文档：https://api.flashodds.live/docs
• OpenAPI：https://api.flashodds.live/openapi.json
• 公开契约：https://api.flashodds.live/contract.json
• MCP 端点：https://api.flashodds.live/mcp
• 免费 API 密钥：https://api.flashodds.live/billing/free
• 发布方：https://www.flashaisolutions.org
• Postman 设置指南
• 公开 Postman 工作区
• Postman JSON 集合

使用 Postman 探索 API

Flash Props 公开 Postman 工作区包含用于图形化探索和分叉的集合。若要在不使用 SDK 的情况下成功发送第一个请求，请先阅读 Postman 快速入门指南，创建免费密钥，然后在 Start here 文件夹中运行 List supported sports with live status + capability 请求。

如果无法通过浏览器访问 Postman，请下载不含凭据的集合 JSON，并使用 Postman 的 Import 操作。我们的 API 主机将该 JSON 维护为参考版本；产品发布后，市场中的副本可能会滞后。

切勿将密钥粘贴到 GitHub、URL、共享集合变量或屏幕截图中。集合的 apiKey 变量有意留空；运行需要身份验证的请求前，请在 Postman 中私下设置密钥。

两个请求即可试用 REST API（Node 20+）

刚开始接触体育数据集成？运行无需依赖的首次请求示例。它会读取当前体育项目目录，然后获取你选择的体育项目的市场词汇表。这是一个只读示例，无需投注、投注自动化、安装 SDK 或付费计划。

1. 获取免费的 Flash Props API 密钥。
2. 将密钥放入本地 FLASH_PROPS_API_KEY 环境变量。不要将其提交到代码仓库或放入查询字符串。
3. 运行 node examples/first-request.mjs 获取 CS2 数据，或运行 node examples/first-request.mjs nfl 获取 NFL 数据。

在 macOS/Linux 上，可以使用 read -rs FLASH_PROPS_API_KEY && export FLASH_PROPS_API_KEY 安全地在 Shell 中输入密钥，且不会将其保存到命令历史记录。在 PowerShell 上，使用 $env:FLASH_PROPS_API_KEY = Read-Host "Flash Props API key"。使用后请清除该变量。

脚本会检查 401、403 和 429 响应，不会泄露密钥，也不会静默重试直到撞上配额限制。脚本使用 GET /api/v1/sports 作为当前数据覆盖范围的真实依据；所选体育项目当前可能没有实时盘口。测试位于 examples/first-request.test.mjs 下，使用模拟响应且不访问网络。

想改为连接 AI Agent？ 使用下方的远程 MCP 端点，并使用相同的密钥和计划。如果第三方目录缓存的功能列表早于托管服务，请优先参考实时公开接口约定。

连接

Streamable HTTP 端点：

https://api.flashodds.live/mcp

在 Authorization 标头中发送 API 密钥：

Authorization: Bearer <your_api_key>

匿名访问可用于能力发现（list_sports、get_market_metadata），这样客户端可以在首次运行时检查当前数据覆盖范围。获取盘口数据至少需要免费密钥。请前往 https://api.flashodds.live/billing/free 获取。

Claude Desktop

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "flash-props": {
      "type": "streamable-http",
      "url": "https://api.flashodds.live/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

工具

下方的访问权限阶梯根据托管接口约定生成。请勿手动编辑。

工具	访问权限
list_sports	匿名能力发现
get_market_metadata	匿名能力发现
list_games	匿名预览（前 5 项）；完整赛程需 Free+
get_game_props	Free+
scan_props	匿名预览（前 5 行）；Free+；各等级的行数上限不同（Free 15 行、Builder 100 行、Pro 3,000 行、Enterprise 5,000 行）
find_game	Free+
find_player_props	Free+
get_player_context	Free/Builder 提供基础信息；Pro 提供完整信息
get_prop_evidence	Free 提供预览；Builder 提供基础信息；Pro 提供完整信息
get_prop_history	Builder 提供有限数据（最近 25 个数据点）；Pro 提供完整数据
scan_movers	Builder 提供有限数据（波动最大的前 25 项）；Pro 提供完整数据
get_leaders	Free 提供前 3 项；Builder 提供前 10 项；Pro 提供前 100 项

各工具的返回内容：

• list_sports：所有体育项目的实时状态、数据新鲜度及预测/背景信息能力
• get_market_metadata：市场标签、类别、范围，以及市场是否经过建模
• list_games：某个体育项目中提供道具数据的比赛
• get_game_props：某场比赛的所有球员道具数据
• scan_props：覆盖整个赛程的市场级道具扫描
• find_game：将球队名称解析为赛事 ID
• find_player_props：某位球员的所有有效道具
• get_player_context：赛季基准、近期表现和深入背景信息
• get_prop_evidence：博彩公司盘口、Flash 盘口、差值、状态、置信度、分项数据和变动
• get_prop_history：某项道具的盘口和赔率历史记录，按时间顺序排列
• scan_movers：指定时间窗口内变动最大的盘口
• get_leaders：按差值、状态和样本强度排序的榜单

REST 和 MCP 采用相同的权限塑形，因此无论使用哪种传输方式，密钥对应的产品等级都相同。

由提供方驱动的覆盖范围

不要硬编码包含 Flash 预测的运动项目列表。覆盖范围根据服务器已注册的模型提供方确定，并且可能因运动项目 + 市场而异。

使用 list_sports（或 GET /api/v1/sports）查看 projectionCapability、effectiveProjection 和 contextCapability，然后使用 get_market_metadata 判断特定市场是否有模型支持。某个运动项目只有部分市场有模型支持是完全正常的：例如，一个统计项可以提供 Flash 预测，而另一个统计项仍然只能显示已发布盘口。

缺少分析时会明确报告。Flash Props 不会为了填补不受支持的市场而捏造预测。

读取预测和盘口快照

• 检查每项预测的 basis。 current_season 基于本赛季数据。prior_season 是前一赛季的基准，绝不能将其描述为当前状态；basisNote 和 seasonId 会说明数据来自哪个赛季。
• 使用 snapshotId 判断数据是否描述同一个盘口。 体育项目、比赛和道具响应中的 snapshotId 相同，表示计数和行数据来自同一个逻辑盘口。mixed 一致性值表示响应不完整，因此不要将其计数与其他快照中的行数据进行比较。

套餐等级

根据托管合约生成。请勿手动编辑。

• Free：$0，每天 300 个请求，每分钟 10 个请求，扫描 15 行，证据预览，上下文基础版，历史记录无，变动无，领先者前 3 名
• Builder（内部 ID starter）：$19/月，每天 25,000 个请求，每分钟 120 个请求，扫描 100 行，证据基础版，上下文基础版，历史记录有限，变动有限，领先者前 10 名
• Pro：$49/月，每天 150,000 个请求，每分钟 600 个请求，扫描 3,000 行，证据完整版，上下文完整版，历史记录完整，变动完整，领先者前 100 名
• Enterprise：自定义限额

查看最新定价和 REST 参考文档：**https://api.flashodds.live/**。

合约

本 README 中的套餐限额、权益和 MCP 工具梯度均为自动生成，并非手动编写。托管 API 会发布一个无需密钥即可访问的机器可读合约，本仓库在 contract/flash-props-contract.json 中存有一份副本。

机器可读数据源按权威性排序如下：

• GET https://api.flashodds.live/contract.json：套餐、配额、权益、MCP 工具及其访问权限、体育项目词汇表、预测和快照规则。每个 API 版本发布后内容固定。
• GET https://api.flashodds.live/api/v1/sports（需要 Free 密钥）或匿名 MCP list_sports 工具：运行时状态。哪些运动项目当前有模型支持、正在进行或数据新鲜，均以此处为准，不会写在合约或本 README 中。

维护者：

node scripts/contract.mjs sync          # regenerate README blocks and server.json version
node scripts/contract.mjs check         # offline drift gate (runs on every push and PR)
node scripts/contract.mjs check --live  # also compare the vendored copy to the hosted contract
node scripts/contract.mjs links         # check every https link in this README

当生成的内容块过期、说明文字引用了合约中不存在的配额或价格、出现已弃用的套餐名称、出现固定的受支持运动项目列表、server.json 与合约中的版本或 MCP 端点不一致，或 README 与合约对现有工具的描述不一致时，CI 都会失败。每日定时任务还会将仓库中的合约副本与托管版本进行比较，因此即使本仓库没有变更，也能检测到差异。

免责声明

数据仅供参考。Flash Props 不是体育博彩平台，也不隶属于任何联盟、球队、球员、体育博彩平台或 DFS 运营商。

链接

• API + 定价：https://api.flashodds.live/
• REST 参考文档：https://api.flashodds.live/docs
• 公开合约：https://api.flashodds.live/contract.json
• 由 Flash AI Solutions 构建