🔌 接口与收费

对齐官方 OpenAPI 契约 · 50 个端点 · 版本 v2.25.1

真实接口调用方式

Base URL:https://www.qiuxiaoce.com/wp-json/abv2-creator/v1

鉴权:请求头 X-API-Key: qxz_…(从环境变量读取,不写死在代码中)。

计费单位:1 元 = 100 点(以 /quota 实测为准)。本站所有数据通过服务端客户端真实请求,未使用任何模拟数据。

查看接口状态

✅ 免费 / 不扣点

接口 / 情形说明
/quota查余额、有效期、今日已用(0 点)
/skill/version、/skill/download免 Key,更新 Skill 包
60 秒内相同请求服务端自动去重,不重复扣点
401/402/403/404/429/500 失败全部不扣点,预扣原路退回
本地缓存命中TTL 内直接用本地库,0 点

💰 收费接口一览(按功能分组)

扣费以响应里的 meta.billing / X-Credits-Charged 为准,不要靠重复请求确认。

旗舰接口 · 单场全景分析

接口点数说明
/match-pack/{id} 当天首次 50 点 一次覆盖赛前全部维度(xG/高阶对位/交锋/伤停/市场波动)
/match-pack/{id} 5 分钟内重复 0 点 去重,带 X-Dedup-Hit
/match-pack/{id} 当天再拉 25 点 距上次扣费超 5 分钟
/match-pack/{id} 当日封顶 150 点后免费 单场当日累计封顶

当日竞彩 / 赛程

接口点数说明
/today/digest 5 点 当日竞彩场次摘要、包与研报状态
/fixtures 2 点 赛程列表,支持 id 等过滤

实体搜索

接口点数说明
/teams?q= 球队 2 点 中文/英文关键词
/players?q= 球员 2 点 至少 2 字
/leagues?q= 联赛 2 点 关键词搜索
/referees?q= 裁判 2 点 英文姓名模糊匹配

球队

接口点数说明
/teams/{id} 详情 2 点 三字码/国家/成立年/球场
/teams/{id}/form 近期战绩 5 点 近 N 场(1-20)
/teams/{id}/fixtures 赛季赛果 3 点 逐场历史,2008 年至今
/teams/{id}/statistics 赛季统计 5 点 按联赛行
/teams/{id}/advanced 高阶画像 10 点 xG/进攻/防守/控球/纪律
/teams/{id}/injuries 伤停 5 点 当前伤停(TTL 6h)
/teams/{id}/squad 阵容 3 点 大名单
/teams/{id}/coach 现任教练 3 点 含 coach_id
/teams/{id}/venue-profile 主场档案 3 点 球场 + 历史主场战绩
/teams/{id}/players-advanced 全队高阶 10 点 一次取全队(limit=50),比逐个查省点
/h2h 两队交锋 5 点 汇总 + 逐场

联赛 / 积分榜

接口点数说明
/leagues/{id} 详情 3 点 可附积分榜
/leagues/{id}/teams 参赛队 2 点
/leagues/{id}/seasons 赛季列表 1 点
/leagues/{id}/fixtures 赛季逐场 5 点 支持轮次过滤
/leagues/{id}/topscorers 射手榜 5 点
/leagues/{id}/topassists 助攻榜 5 点
/standings 积分榜 3 点 league + season

球员

接口点数说明
/players/{id} 详情 2 点 含身价
/players/{id}/stats 赛季统计 3 点 球队×联赛行
/players/{id}/advanced 单球员高阶 3 点 只查 1 人时用;整队请用全队端点

单场细分

接口点数说明
/fixtures/{id} 单场详情 2 点 基础信息 + 完整比分
/fixtures/{id}/stats 技术统计 5 点
/fixtures/{id}/events 事件流 5 点
/fixtures/{id}/lineups 官方阵容 5 点
/fixtures/{id}/players 球员评分 5 点
/fixtures/{id}/quotes 市场快照 5 点 合规口径:参考值
/fixtures/{id}/quotes/history 走势 5 点
/fixtures/{id}/market 异动 5 点
/fixtures/{id}/shotmap 射门图 无数据不扣点 404 时不扣
/fixtures/{id}/market-behavior 市场行为 无数据不扣点 404 时不扣

交锋 / 裁判 / 教练 / 转会

接口点数说明
/transfers 转会记录 7 点 team / player 二选一
/coaches/{id} 教练履历 6 点 完整执教履历
/referees/{id} 裁判执法数据 7 点 场均黄红牌 + 近 10 场

复盘与统计

接口点数说明
/stats/overall 整体命中率 5 点 官网历史样本
/stats/team 某队命中 5 点
/review?days=7 近 N 天聚合 10 点 1-30 天

研报(最贵,建议官网直接看)

接口点数说明
/posts 批量检索 1000 点/次 按天批发摘要
/posts/today 当日研报 1000 点/次 销售日口径
/posts/{id} 单篇全文 历史 25 / 当天 100 批发覆盖的文章当天 0 点

💡 省钱要点

  1. 单场分析直接调 /match-pack(50 点),别拆成 8 个零散接口——拆开反而更贵。
  2. 取整队球员高阶用 /teams/{id}/players-advanced?limit=50(10 点/队),别逐个调 /players/{id}/advanced(3 点/人)。
  3. 先查本地缓存,TTL 内命中不扣点;相同请求 60 秒内自动去重。
  4. 研报类官网可直接看免费,无需为看单篇调接口(批量 1000 点/次)。

全部 50 个端点(来自官方契约)

GET /quota · 0 点
GET /fixtures
GET /match-pack/{fixture_id}
GET /today/digest
GET /posts
GET /posts/today
GET /posts/{post_id}
GET /teams
GET /teams/{team_id}
GET /teams/{team_id}/form
GET /teams/{team_id}/fixtures
GET /teams/{team_id}/statistics
GET /teams/{team_id}/advanced
GET /teams/{team_id}/injuries
GET /teams/{team_id}/squad
GET /teams/{team_id}/coach
GET /teams/{team_id}/players-advanced
GET /h2h
GET /leagues
GET /leagues/{league_id}
GET /standings
GET /leagues/{league_id}/teams
GET /leagues/{league_id}/seasons
GET /leagues/{league_id}/topscorers
GET /leagues/{league_id}/topassists
GET /leagues/{league_id}/fixtures
GET /fixtures/{fixture_id}
GET /fixtures/{fixture_id}/players
GET /fixtures/{fixture_id}/stats
GET /fixtures/{fixture_id}/events
GET /fixtures/{fixture_id}/lineups
GET /fixtures/{fixture_id}/quotes
GET /fixtures/{fixture_id}/quotes/history
GET /fixtures/{fixture_id}/market
GET /players
GET /players/{player_id}
GET /players/{player_id}/stats
GET /players/{player_id}/advanced
GET /stats/overall
GET /stats/team
GET /review
GET /transfers
GET /coaches/{id}
GET /referees
GET /referees/{id}
GET /skill/version · 公开
GET /skill/download · 公开
GET /fixtures/{fixture_id}/shotmap
GET /fixtures/{fixture_id}/market-behavior
GET /teams/{team_id}/venue-profile