# 数据接入状态

生成时间：2026-09-26

## 已经接入

### 足球

- API-Football：赛程、伤停、首发阵容。
- API-Football 高级采集：`/fixtures/statistics`、`/predictions`，带本地缓存，由 `api-football.mjs --advanced=true` 触发。
- 特征层：`football-features.mjs`。
- 已计算的字段：休息天数、7/14 天赛程密度、伤停加权影响、阵容完整度、近期进失球、近期射门和 xG 字段。
- 盘口层：Odds-API.io 多公司让分、大小分、独赢快照。

当前状态：API-Football 今日请求额度已经耗尽，所以高级统计覆盖暂时为 0；基础特征已经生成。额度恢复后，`run-market-snapshot.ps1` 会自动带上高级采集。

### 篮球

- API-Basketball：欧洲联赛、球队、赛程、积分榜和球员名单。
- 特征层：球队 Elo、近期得分、近期失分、预计分差、预计总分。
- 新增字段：休息天数、背靠背、7 天比赛数、近期节奏、休息调整后的预计分差、节奏调整后的预计总分。
- WNBA：SportsDataIO 球员级伤停影响仍然保留。
- 盘口层：Odds-API.io 让分、大小分快照。

当前限制：欧洲篮球没有稳定的官方伤停和球员级 on/off 数据，所以球员影响主要覆盖 WNBA。

### 电竞

- PandaScore：战队 Elo、近期状态、休息天数、交手记录。
- 新增字段：BO1/BO3/BO5、赛事级别、赛区、版本字段、数据缺失标记。
- 盘口层：Odds-API.io 独赢、让分、大小分、总击杀、总回合、总地图等市场。

当前限制：地图池、Ban/Pick、选手伤病和阵容变化没有接入。PandaScore 当前接口没有返回这些明细，需要 GRID、Abios 或同等级详细数据源。

### 盘口和资金

- 开盘、赛前、收盘快照已经采集。
- 账本支持记录、结算和 CLV。
- 只有通过滚动回测的 A/B 方向进入盈利模式，C 只观察。

## 新数据要怎样才能进入 A/B

1. 确认数据源和 API 额度。
2. 采集原始数据并保存快照。
3. 按比赛 ID、球队 ID 和开赛时间做映射。
4. 生成特征，禁止使用赛后数据。
5. 做按时间滚动回测，训练、验证、测试分开。
6. 只有样本外 ROI、命中率和 CLV 都不错，才允许升级为 A/B。

## 当前最缺的付费数据

- 足球：稳定的 xG、xGA、射门质量、expected threat、球员级伤停和首发价值。API-Football 部分联赛有射门统计，但 xG 不一定完整。
- 篮球：欧洲篮球官方伤停、球员 on/off、阵容、节奏和每回合数据。
- 电竞：地图池、Ban/Pick、选手状态、版本强度和详细对局统计。
- 盘口：更多博彩公司的开盘、赛前 1 小时、收盘和成交量数据。

没有这些字段时，模型宁可保持 C 级观察，也不会把未经回测的数据包装成高胜率推荐。

## 历史高级统计回填

- 脚本：run-football-advanced-backfill.ps1
- 逻辑：只使用 API-Football 剩余额度，按比赛缓存，不会重复请求。
- 当前状态：API-Football 今日额度已耗尽，脚本会直接记录额度不足并退出，不会伪造数据。
- 额度恢复或升级后运行，才会得到真正可用于回测的历史射门/xG 样本。