跳转到主要内容
速览 —**订单(order)**是你的指令;**投注(bet)**是在博彩商处实际成交的下注。标识符(fixtureId、outcomeId、playerId、participantId)与 OddsPapi v5 共享。每个订单都带有唯一的 requestUuid 用于幂等。三条独立的生命周期分别追踪订单、它的每个投注,以及每个投注的结算。

标识符

ABP 与 OddsPapi v5 共享标识符空间——你通过 OddsPapi 发现的 fixtureId 和 outcomeId 就是发送给 ABP 的值,无需任何转换层。 两套标识符词汇互不混用:/fixtures/* 端点会拒绝 futureId、futureOutcomeId 和 participantId;/futures/* 端点会拒绝 fixtureId、outcomeId 和 playerId。两者都返回 422,并在错误信息中指明应改用哪个端点。

期货盘口的两种形态

期货选项是 (futureOutcomeId, participantId) 这一对值,恰好有两种形态: futureOutcomeId=0 且 participantId=0 没有指向任何选项,会被拒绝。注意期货没有 playerId——participantId 同时承担球队与球员的指代——也没有 period。

盘口键(Market keys)

在内部,每个定价选项都由一个复合键寻址:
请把 oddsId 当作不透明字符串。 保存投注单响应或 WebSocket 增量推送给你的值,并原样回传—— 不要拆分、拼接或自行重建。ABP 始终发布实际命中的那个键,因此保存 oddsId 的客户端完全不受格式 变更影响,而解析它的客户端会受影响。(OddsPapi 正在迁移其期货标识符方案,这也正是整套 /futures/* 端点目前返回 501 的原因——参见概览 → 期货。)
你很少需要手动构造它们——GET /fixtures/betslip 和 GET /futures/betslip 会返回已键入、可直接 使用的结构——但理解其形态有助于阅读 WebSocket 的 betslip 负载。

订单与投注

这是最重要的一个区分。 当涉及部分成交或多博彩商路由时,一个订单可能产生多个投注。例如,一个 5,000 USD 的订单可能在两家博彩商处成交为三笔投注。详见订单下注。

幂等性与请求去重

网络重试不可避免,而重试的下单绝不能造成重复下注。ABP 通过请求去重来保证这一点。
1

为每个订单分配唯一的 requestUuid

POST /fixtures/place-orders 批次中的每个订单都带有自己的 requestUuid(标准 8-4-4-4-12 UUID)。在客户端生成一次,并在每次重试该订单时复用同一个值。
2

服务端进行指纹识别

服务端会以 30 分钟 TTL 记录已见过的每个 requestUuid。在该窗口内,重复出现的相同 requestUuid 会被识别为重复。
3

重复项被静默跳过

重复的订单不会再次下注,也不会作为被拒原因返回,只是被跳过,批次中的其余订单照常处理。
4

整批均为重复时返回 409

如果请求中的每个订单都是重复项,则无事可做,请求返回 409 Conflict 并附上相关 UUID。
在 30 分钟内将某个 requestUuid 复用于不同的订单,会导致该订单被跳过。请始终为每次不同的下单生成新的 UUID,仅在重试同一次下单时原样复用它。
requestUuid 在入库前会被规范化。 ABP 会解析该值并改写为标准的小写带连字符形式,因此订单上 回传的值(以及 WebSocket orders 负载中的值)在拼写上可能与你发送的不同。 {EB45B192-317B-42D5-9F65-AF497B9FA8C1}、EB45B192317B42D59F65AF497B9FA8C1 和 urn:uuid:eb45b192-… 都会落到同一个键上——这正是目的所在:仅大小写不同的重试仍会被识别为同一个 订单,而不会变成第二笔真实投注。请按规范化后的形式匹配订单,不要与你发送的原始字符串做逐字节比较。

订单生命周期

投注生命周期

结算生命周期

投注 CONFIRMED 后,结算追踪资金结果:
结算变更通过 settlements WebSocket 频道推送。参见订单下注与 WebSocket。

账户优先级与额度级联

每个博彩商账户都有 priority(越高越优先)。路由时,ABP 会为每家博彩商优先选择优先级最高的活跃账户。 下注额度按优先顺序解析——账户额度 > 博彩商额度 > 赔率额度——取第一个非空值:
完整细节与示例见币种与额度。

术语表

后续步骤

订单下注

成交、定价与额度级联的运作方式。

币种与额度

计价、换算与额度详解。

快速开始

5 步完成首次下注。

博彩商

全部 36 家博彩商的能力矩阵。