WS / REST 节点集群运行正常
|
毫秒级体育盘口与即时赔率数据接入引擎
锐矩盘口API提供高并发、强一致性的标准化足球盘口接口。针对全球超过 1,280 个职业足球联赛与杯赛，将多源异构数据清洗为统一的盘口数据模型，完整涵盖赛前初盘、临场变盘、滚球即时水位推送、危险球锁盘信号（Bet Stop）与多源赛事 ID 映射。
足球盘口接口内置标准化的玩法枚举字典（market_type_id），支持主盘口（Main Line）与多档附加盘口（Alternative Lines）同步输出，并提供香港盘、欧洲十进制盘、马来盘及印尼盘的原生转换。
足球亚盘 API 采用绝对十进制浮点与复合区间双字段下发模式。无论是整数盘（-1.0）、半盘（-0.5）还是复合分裂盘（如平手/半球 -0.25、半球/一球 -0.75），接口均同时提供数值计算项 handicap_value 与展示表达式 handicap_display，免除业务端繁琐的字符拆解逻辑。
| 中文盘口名 | handicap_value | handicap_display | 滚球基准分 (base_score) | 结算逻辑标识 |
|---|---|---|---|---|
| 平手盘 | 0.00 | "0" | "1-1" | DRAW_REFUND |
| 平手/半球 | -0.25 | "-0/0.5" | "1-1" | SPLIT_HALF_LOSE |
| 半球盘 | -0.50 | "-0.5" | "1-1" | DIRECT_SETTLE |
| 半球/一球 | -0.75 | "-0.5/1" | "1-1" | SPLIT_HALF_WIN |
接口默认返回欧洲盘（Decimal）与香港盘（HK），同时支持按请求参数自动下发马来盘（MY）与印尼盘（ID），底层保留 4 位小数精度防止跨制式套利计算舍入误差。
| 枚举代码 | 低水示例 | 高水示例 | 含本金 |
|---|---|---|---|
| DECIMAL (欧盘) | 1.8500 | 2.0800 | 是 |
| HK (香港盘) | 0.8500 | 1.0800 | 否 (净利) |
| MALAY (马来盘) | 0.8500 | -0.9259 | 正负双向 |
| INDO (印尼盘) | -1.1765 | 1.0800 | 正负双向 |
一场标准足球赛事的盘口生命周期跨越开赛前 14 天至终场结算。接口通过严格的阶段标记（stage_status）与毫秒级风控锁盘信号（market_status），保障业务系统在进球、红牌、VAR 介入等高敏时刻的数据安全。
机构首次开盘即刻归档为 is_opening: true 快照。此数据永不覆盖，作为赛前盘路走势分析与初盘水位对比的不可变基准线。
赛前 1 小时首发名单公布后进入密集调水期。裁判吹响开场哨瞬间，系统自动冻结并标记最后一条有效赛前盘为赛前终盘（Closing Pre-match Odds）。
滚球亚盘基于当前比分（如 1-0）重新计算让球有效责任。一旦出现前场任意球、点球、单刀或 VAR 核查，20ms 内下发全局 SUSPENDED 锁盘指令。
90分钟完场（含伤停补时）后所有常规盘状态转为 SETTLED，同步输出每个盘口线的结算因子（全赢、赢半、走水、输半、全输）。
RESTful 快照接口与 WebSocket 实时增量流共享同一套强类型数据契约。以下为足球盘口对象（FootballMarketOdds）的核心字段规范说明。
| 字段名 (Field Key) | 数据类型 | 必填 | 示例值 | 技术定义与业务处理规则 |
|---|---|---|---|---|
| match_id | Int64 | Yes | 9482014 | 平台全局唯一足球比赛 ID，关联赛程、动画直播与映射表主键。 |
| provider_id | Int32 | Yes | 104 (Pinnacle) | 盘口数据源机构编码（如 101=Bet365, 102=皇冠Crown, 104=平博Pinnacle, 108=沙巴）。 |
| market_type_id | Int32 | Yes | 101 | 玩法类型编码：101=全场亚盘, 201=全场独赢1X2, 301=全场大小球, 402=角球大小。 |
| stage_status | String | Yes | "IN_PLAY" | 盘口所处赛程阶段：PRE_MATCH（赛前盘）或 IN_PLAY（滚球即时盘）。 |
| line_id | Int64 | Yes | 883920194 | 单条盘口线的唯一标识，用于在同玩法多档位（主盘+副盘）中精准定位更新。 |
| is_main_line | Boolean | Yes | true | 标识是否为当前机构的主盘口线（水位最接近均水 1.92 的核心盘口）。 |
| handicap_value | Decimal | Nullable | -0.75 | 数值型盘口线（以主队视角为基准，负数代表主让客，大小球为正浮点数如 2.75）。 |
| handicap_display | String | Nullable | "-0.5/1" | 前端可直接渲染的复合盘字符串格式，免除客户端二次格式化计算。 |
| base_score | String | Nullable | "1-1" | 滚球亚盘成盘瞬间的场上基准比分；赛前盘固定为 "0-0"。 |
| market_status | Int32 | Yes | 1 | 交易风控状态：1=OPEN(开盘), 2=SUSPENDED(临时封盘/危险球), 3=CLOSED(下线), 4=SETTLED。 |
| bet_stop_reason | String | Nullable | "VAR_CHECK" | 当 market_status=2 时返回原因枚举：GOAL_PENDING, PENALTY_RISK, RED_CARD_RISK, VAR_CHECK。 |
| selections[] | Array<Obj> | Yes | [Home, Away] | 投注项集合，包含 selection_key (HOME/AWAY/DRAW/OVER/UNDER)、odds_hk、odds_dec 及涨跌趋势 trend。 |
| sequence_id | Int64 | Yes | 109482716 | 单场比赛严格单调递增的盘口变更序列号，用于客户端检测丢包与保障幂等更新。 |
| updated_at_ms | Int64 | Yes | 1741529402819 | 网关生成该条水位变动的 UTC 毫秒级时间戳。 |
在实际接入中，开发者最耗费精力的往往不是解析 JSON，而是不同赔率供应商对同一场足球比赛、联赛、主客队名称编码各异（例如中立场地主客颠倒、青年联赛译名不一）。锐矩盘口API提供毫秒级多源赛事 ID 映射引擎（Cross-Provider ID Mapping），在网关层完成实体对齐。
综合开赛 UTC 时间窗口（±15分钟容差）、联赛别名知识图谱、主客队 FIFA 标准化编码以及主客场反转自动校准标记（is_team_swapped），映射准确率达 99.98%。
支持通过平台 match_id 直接反查 Sportradar、Opta、Genius Sports 等赛果统计源 ID，以及 Bet365、Pinnacle、Crown（皇冠）、SBO（沙巴）的原生盘口房间号。
{
"match_id": 9482014,
"kickoff_utc": "2025-04-12T16:30:00Z",
"canonical_league": { "league_id": 39, "code": "ENG_PR", "name_zh": "英格兰超级联赛" },
"canonical_teams": {
"home": { "team_id": 10042, "name_zh": "阿森纳", "name_en": "Arsenal" },
"away": { "team_id": 10040, "name_zh": "利物浦", "name_en": "Liverpool" }
},
"external_mappings": {
"sportradar_id": "sr:match:51948204",
"opta_uuid": "g2491048",
"bookmaker_Fixtures": {
"bet365": { "ext_event_id": "169482011", "is_team_swapped": false },
"pinnacle": { "ext_event_id": "1599402841", "is_team_swapped": false },
"crown": { "ext_event_id": "CW_4829104", "is_team_swapped": false },
"sbobet": { "ext_event_id": "SBO_7748192", "is_team_swapped": false }
}
}
}我们将全球 1,280+ 个足球赛事按流动性、玩法丰富度与更新频率划分为四个等级（Tier 1 ~ Tier 4），支持开发者按联赛等级灵活配置订阅通道与本地缓存策略。
涵盖英超、西甲、意甲、德甲、法甲、欧冠、欧联、中超、日职联（J1）、韩K联及南美解放者杯。支持赛前 14 天开盘、5 档同屏深度盘口线、角球、罚牌、球员特殊数据盘及 20ms 级滚球极速推送。
涵盖荷甲、葡超、土超、苏超、比甲、英冠、德乙、西乙、意乙、日职乙（J2）、澳超、美职联（MLS）、巴甲、阿甲及墨超。完整支持全场/半场亚盘、欧赔、大小球、角球盘及波胆。
涵盖英甲、英乙、德丙、法丙、北欧各国联赛（瑞超、挪超）、中甲、东南亚各国联赛及欧洲女足冠、英女超等。保障核心亚盘、大小球、独赢 1X2 与半场基础盘口稳定供给。
针对非主流时段（如工作日下午、休赛期）填补赛事空白，提供经过严格真实性校验的青年联赛与俱乐部友谊赛初盘及滚球核心盘口，配备异常水位波动自动熔断保护。
切换下方典型业务场景，查看足球盘口接口在赛前多档位快照拉取、滚球毫秒级 WebSocket 水位增量推送以及进球瞬间危险球封盘（Bet Stop）时的真实 JSON 报文结构。
支持英超与欧冠历史滚球回放测试流
技术团队提供 7×24 小时生产环境网关监控，协助完成亚盘分盘逻辑验证、断线重连补偿与本地内存缓存架构设计。