实时赛况 - AnySport

按 match_id 返回该场比赛的全量事件流（每次调用都是全场至今所有事件的完整快照，而非增量）、当前技术统计（角球/任意球/黄红牌等 11 项）以及最新一帧事件状态 status。适合做”文字直播”式的比赛进程展示。每次轮询直接用最新返回结果整体替换即可，无需客户端自己拼接增量。status/events[].type 均为可能持续扩充的开放式英文 code，解析时请对未知取值降级为普通事件而非报错。与实时比分的关系：14 只给比分和阶段，本接口给具体”发生了什么”。

接口路径

GET /v1/soccer/matches/{match_id}/situation

入参说明

参数	位置	必填	说明
`match_id`	path	是	比赛 ID（`as_` id，与 /matches 一致）
`lang`	query	否	`en` / `zh-CN`，非法值静默回退默认语言，可选值以 `GET /languages`（19）为准

该场比赛无赛况数据时返回 404（NOT_FOUND）。

出参说明（data: 对象）

字段	类型	说明
`match_id`	string	比赛 ID（`as_` 前缀，与引用类同 id）
`status`	string	最新一帧事件的英文 code（snake_case，如 `full_time`/`home_corner`）：主队事件加 `home_` 前缀、客队事件加 `away_` 前缀、中性/全局事件无前缀（主客同义成对，如 `home_corner`/`away_corner`）；结束判定用 `full_time`/`extra_time_full_time` 或 livescore 的 `phase`。取值可能扩充，请容忍未知 code；部分事件可能不下发该字段，客户端需容错
`status_label`	string	`status` code 的本地化文本（按 lang 返回，例如 lang=zh-CN 时为「全场结束」）；`status` 原 code 不变，当 lang 为非默认语言、且该取值存在本地化文本时下发
`minute`	int	当前分钟（口径同 livescore）
`ball_xy`	string	当前控球权/球权坐标，`x,y` 归一化小数（以主队进攻方向为参照）；未提供时缺失
`events[]`	array	全量事件快照（每次推送覆盖全场至今所有事件）
`events[].seq`	int	场内序号（1 起，大体按时间序）
`events[].minute`	int	发生时刻（int 分钟，与顶层 `minute` 同型）。含加时连续计分钟（`121` = 120+1’）；汇总类事件为 `0`
`events[].type`	string	类型枚举（7 值）：`goal` / `yellow_card` / `red_card` / `corner` / `penalty` / `substitution` / `event`
`events[].type_label`	string	事件类型的本地化文本（按 lang 返回，例如 lang=zh-CN 时为「进球」）；`type` 原 code 不变，当 lang 为非默认语言、且该取值存在本地化文本时下发
`events[].team`	string	`home`/`away`；中性事件无此字段
`events[].text`	string	事件文字描述（英文），带分钟与场内第 N 次前缀
`stats`	object	全场技术统计。键为统计项缩写、值为 `[主队, 客队]` 数值对（如 `"c":[8,2]` = 角球主 8 客 2）；未提供时缺失
`stat_labels`	object	`stats` 键 → 本地化标签的映射（按 lang 返回，例如 lang=zh-CN 时为 `{"c":"角球"}`）；仅包含存在本地化文本的键；`stats` 原键不变，当 lang 为非默认语言、且该键存在本地化文本时下发
`updated_at`	string	更新时间，UTC ISO-8601（带 `Z`）

*_label 约定：status / events[].type / stats 键均保留原 code/键值不变，另新增平行的本地化标签 status_label / events[].type_label / stat_labels（stat_labels 为对象，仅包含存在本地化文本的键）；当 lang 为非默认语言、且对应取值存在本地化文本时下发。事件文本 text、队名/联赛名暂不随 lang 本地化。

枚举说明

status 英文 code

status 下发英文 code（snake_case，下划线连接的英文释义）：

主队事件加 home_ 前缀
客队事件加 away_ 前缀
中性/全局事件无前缀（主客同义成对，如 home_corner/away_corner）
status 为最新一帧的事件 code。

status 为开放枚举：取值可能扩充，部分事件可能不下发该字段；下游遇到未知 code 或字段缺失时应降级为普通事件。

中性 / 全局状态

枚举值（code）	含义
`danger`	危险进攻（Danger）
`goal`	进球
`corner`	角球
`yellow_card`	黄牌
`dangerous_free_kick`	危险任意球
`kick_off`	开球
`half_time`	中场休息
`second_half_start`	下半场开始
`full_time`	常规全场结束
`extra_time_kick_off`	加时开球
`extra_time_half_time`	加时中场
`extra_time_second_half`	加时下半场
`extra_time_full_time`	加时全场结束
`penalty_shootout`	点球大战
`penalty_missed`	点球罚失（官方名 Penalty missed，多见于点球大战语境）
`injury`	伤停
`injury_time`	伤停补时
`match_info`	比赛信息
`offside`	越位
`zone_throw_in`	区域界外球
`substitution`	换人
`var_review`	VAR 审核中
`var_red_card`	VAR 审红牌
`var_goal`	VAR 审进球
`var_penalty`	VAR 审点球

主队事件 home_*

枚举值（code）	含义
`home_penalty_shootout_scored`	主队点球大战罚进
`home_penalty_shootout_missed`	主队点球大战罚失
`home_penalty_shootout_pending`	主队点球大战待罚
`home_dangerous_attack`	主队危险进攻
`home_attack`	主队进攻
`home_possession`	主队控球
`home_goal`	主队进球
`home_corner`	主队角球
`home_yellow_card`	主队黄牌
`home_red_card`	主队红牌
`home_goal_kick`	主队球门球
`home_penalty_awarded`	主队获得点球
`home_direct_free_kick`	主队直接任意球
`home_free_kick`	主队普通任意球
`home_shot_on_target`	主队射正
`home_shot_off_target`	主队射偏
`home_substitution`	主队换人
`home_kick_off`	主队开球
`home_second_half_kick_off`	主队下半场开球
`home_penalty_shootout`	主队点球大战
`home_penalty_missed`	主队点球罚失
`home_throw_in`	主队界外球
`home_injury`	主队伤停
`home_injury_time`	主队伤停补时
`home_offside`	主队越位
`home_zone_throw_in`	主队区域界外球
`home_dangerous_attack_with_ball`	主队带球危险进攻
`home_attack_with_ball`	主队带球进攻
`home_safe_possession`	主队带球安全控球
`home_var_review`	主队 VAR 审核中
`home_var_red_card`	主队 VAR 审红牌
`home_var_goal`	主队 VAR 审进球
`home_var_penalty`	主队 VAR 审点球
`home_corner_top`	主队角球(上侧)
`home_corner_bottom`	主队角球(下侧)
`home_free_kick_zone_1`~`home_free_kick_zone_6`	主队任意球区位（6 个区位）

客队事件 away_* 客队对应 away_* ，与主队事件同义成对，比如home_attack代表客队进攻。 任意球区位码 任意球区位码为唯一例外，不适用主客”同义成对”规则：主队为 home_free_kick_zone_1 ~ home_free_kick_zone_6（区位 1~6）；客队为 away_free_kick_zone_7 ~ away_free_kick_zone_12（区位 7~12，客队用独立编号，不是主队区位的镜像）。

phase

结束判定参照，livescore 独有， 4 值：

枚举值	含义
`regular`	常规进行中（默认值。加时赛进行中的普通攻防帧也归 `regular`，判断”是否在加时”用 `minute > 90` 更可靠）
`extra_time`	加时边界事件（加时开球 / 加时中场休息 / 加时下半场开始，即 `extra_time_kick_off`/`extra_time_half_time`/`extra_time_second_half` 的帧）
`penalty`	点球大战（点球大战开始、罚进/罚失、待罚等码的帧）
`finished`	全场结束（常规结束 `full_time` 或加时结束 `extra_time_full_time`）

events[].type

事件类型按 text 文本关键字归类（type 由服务端从文本推导），命中优先级从上到下：

枚举值	命中关键字	含义（覆盖的事件种类）
`goal`	text 含 “goal”	进球（含乌龙、点球破门）
`yellow_card`	text 含 “yellow”	黄牌（含加时黄牌 `Yellow Card ET`）
`red_card`	text 含 “red”	红牌
`corner`	text 含 “corner”	角球、角球竞赛标记（Race to N Corners）
`penalty`	text 含 “penalty”	点球罚失、点球大战开始、点球大战罚进
`substitution`	text 含 “substitution”	换人
`event`	其余	射正、射偏、助攻、越位、阶段比分标记、时间区间标记、点球大战结果等

进球方式后缀

进球 text 的 - 后缀，可缺省。

枚举值	含义
`Shot`	射门
`Header`	头球
`Penalty`	点球
`Free Kick`	任意球
`Own Goal`	乌龙

(Assist: …) 助攻后缀亦可缺省。

stats 键字典

固定 11 键，恒返回；每键的值为 [主队, 客队] 二元数组

枚举值（键）	含义（官方名）
`a`	进球（Goal，= 当前比分，含加时）
`h1`	上半场进球（1st Half）
`c`	角球（Corner）
`f`	任意球（Free Kick，非犯规数）
`t`	界外球（Throw In）
`g`	球门球（Goal Kick）
`y`	黄牌（Yellow Card）
`r`	红牌（Red Card）
`p`	点球（Penalty）
`o`	越位（Offside）
`s`	换人（Substitution）

入参示例

GET /v1/soccer/matches/as_3b37c382f39a4235aa93705f053b2da4/situation

出参示例

HTTP 200，events 共 88 条，minute 均为 int 分钟；节选

{
  "success": true,
  "data": {
    "match_id": "as_3b37c382f39a4235aa93705f053b2da4",
    "status": "extra_time_full_time",
    "minute": 120,
    "events": [
      {
        "seq": 1,
        "minute": 1,
        "type": "event",
        "team": "away",
        "text": "1' - 1st Shot Off Target - (Switzerland)"
      },
      {
        "seq": 2,
        "minute": 7,
        "type": "event",
        "team": "away",
        "text": "7' - 2nd Shot Off Target - (Switzerland)"
      },
      {
        "seq": 3,
        "minute": 9,
        "type": "corner",
        "team": "home",
        "text": "9' - 1st Corner - (Argentina)"
      },
      {
        "seq": 87,
        "minute": 123,
        "type": "event",
        "team": "away",
        "text": "120+3' - 7th Offside - (Switzerland)"
      },
      {
        "seq": 88,
        "minute": 120,
        "type": "event",
        "text": "Score After Extra Time - 3-1"
      }
    ],
    "stats": {
      "c": "",
      "f": "",
      "o": "",
      "p": "",
      "r": "",
      "t": "",
      "y": "",
      "s": "",
      "g": "",
      "a": "",
      "h1": ""
    },
    "updated_at": "2026-07-12T03:45:50Z"
  },
  "meta": {
    "timestamp": "2026-07-17T05:16:34.398572300Z"
  },
  "traceId": "ac2290f7-eacd-4825-ba47-aab52ba7f1ba"
}

​接口路径

​入参说明

​出参说明（data: 对象）

​枚举说明

​status 英文 code

​phase

​events[].type

​进球方式后缀

​stats 键字典

​入参示例

​出参示例

接口路径

入参说明

出参说明（data: 对象）

枚举说明

status 英文 code

phase

events[].type

进球方式后缀

stats 键字典

入参示例

出参示例