MLB Pitcher Intelligence API
收藏MLB Pitcher Intelligence API
版本： v1.0.0
基础 URL： https://propdata-pitcher-api.sales-fd3.workers.dev
提供方： PropTechUSA.ai
支持邮箱： propdata@proptechusa.ai
概述
基于 Statcast 接触质量的投手分析 API。通过惩罚分数（0-100）量化投手最近 5 次先发的被击球质量，帮助用户识别应堆叠打击或回避的投手。
核心功能与端点
-
获取单个投手档案
GET /v1/mlb/pitcher- 支持通过 MLB 球员 ID 或姓名查询。
- 返回最近 5 次先发的 Statcast 数据、惩罚分数、等级及投注信号。
- 所需套餐： STARTER 及以上
-
获取今日先发投手名单
GET /v1/mlb/pitcher/slate- 返回当日所有可能先发投手的完整名单，按惩罚分数从高到低排序。
- 所需套餐： BASIC 及以上
-
获取高风险投手名单
GET /v1/mlb/pitcher/punished- 仅返回当日惩罚分数达到 50 分及以上（leaking 或 getting_smoked）的投手，快速识别应堆叠打击的对象。
- 所需套餐： BASIC 及以上
惩罚分数 (Punishment Score)
一个 0-100 的综合评分，基于投手最近 5 次先发的以下指标：
| 信号 | 权重 | 阈值 |
|---|---|---|
| 强击率 (Hard hit %) | 最多 25 分 | > 35% |
| 平均出口速度 (Avg exit velocity) | 最多 20 分 | > 89mph |
| barrels % | 最多 20 分 | > 7% |
| 防御率 (ERA) | 最多 15 分 | > 4.50 |
| 每九局被全垒打数 (HR/9) | 最多 10 分 | > 1.5 |
| 三振率趋势 (K9 trend) 下降 | 最多 10 分 | 负向趋势 |
等级划分：
- getting_smoked (70+)：打者面对该投手时击球质量极高，建议强烈回避或押注大分。
- leaking (50-69)：被击球质量偏高，倾向于看衰该投手。
- mixed (30-49)：情况不明朗，需视情况而定。
- cruising (<30)：投手状态良好，建议回避打者相关投注（如打者安打）。
输出示例
json GET /v1/mlb/pitcher?name=Jacob+deGrom
{ "pitcher_name": "Jacob deGrom", "pitcher_team": "TEX", "throws": "R", "last_5_summary": { "ip": "28.2", "er": 8, "k": 39, "hr": 3, "era": "2.51", "k9": "12.24", "hr9": "0.94", "hard_hit_pct": "0.284", "barrel_pct": "0.048", "avg_ev": "87.6", "k9_trend": "+1.2", "k9_trend_label": "improving" }, "punishment_score": 18, "tier": "cruising", "angle": "Clean in recent starts. Fade hitter props against this arm.", "betting_signals": { "hr_overs": "unfavorable", "k_overs": "favorable", "lean": "fade against — K overs" } }
定价方案
| 方案 | 价格 | 每月请求次数 | 功能 |
|---|---|---|---|
| STARTER | $2.99/月 | 300 | 仅限单个投手档案查询 |
| BASIC | $7.99/月 | 1,000 | 包含今日名单及高风险投手名单 |
| PRO | $14.99/月 | 5,000 | 更高请求配额 |
| ULTRA | $24.99/月 | 无限 | 全部功能 |
错误码
| 状态码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 401 | API 密钥无效或缺失 |
| 403 | 需要更高级别的套餐 |
| 404 | 未找到该投手 |
| 429 | 超出速率限制或配额 |
| 502 | MLB API 暂时不可用 |
