一个盘口如何被寻址
有两个后果值得在设计时考虑:
- 每个不同的线值都是独立的
marketId。“大 2.5”与”大 3.5”是不同盘口,而非同一盘口的两个选项。单个marketId内的选项只是该确切线值的各个方向。 marketId等于该盘口的第一个outcomeId,marketLength是方向数量 —— 因此单个marketId下的选项无需任何额外元数据即构成完整的概率空间。
盘口类别
marketType 是开放词汇表 —— 每个值稳定,但整体会随时间增长。代表性类型:
这并非完整图谱 —— 随着覆盖增长会追加新类型,且各运动可用的类型不同。请用
GET /markets 枚举真实图谱,而不要硬编码。
赛段范围
盘口通过period 限定到某个赛段,所有运动共用同一套词汇:fulltime、result、overtime、penalties、编号赛段 p1…p12、组合赛段(p1+p2、fulltime+overtime 等),以及盘内局的子赛段键(p1g1…p5g13、currentgame)。
赛段的含义取决于运动 —— p1 在足球中是半场,在 NBA 篮球中是一节,在网球中是一盘,在电竞中是一张地图。请用赛事的 expectedPeriods 与 periodLength 来解读。完整列表参见枚举 → period。
球员盘
盘口携带playerProp 标记,球员盘的价格携带非零 playerId:
outcomeId 编码了除球员之外的一切 —— 市场类型、赛段、线值与方向 —— 因此同一项球员盘在两名球员上共享 outcomeId,仅 playerId 不同。阵容可通过 GET /players 发现。
枚举图谱
marketName / marketNameShort 跟随请求的语言前缀,仅用于展示 —— 逻辑请基于 marketId、outcomeId、marketType 与 period 分支。
某场赛事实际有哪些盘口
GET /markets 描述某运动存在哪些盘口;某场赛事此刻被定价的盘口来自赔率本身。拉取 GET /fixtures/odds(或仅主盘的 /fixtures/odds/main)并按 marketId 分组。各博彩商提供的盘口与线值不同,mainLine 标记各家的头部线值。
marketType 只增不改:新值随覆盖增长出现,含义永不改变。请匹配您支持的类型并忽略其余,而不要在遇到未知值时失败。结算
评级遵循同一套坐标。亚洲四分之一盘在WIN / LOSE / PUSH 之外结算为 HALFWIN / HALFLOSS,且评级基于与博彩商无关的选项键 {fixtureId}:{outcomeId}:{playerId}。参见枚举 → settlementStatus与支撑体育博彩。