速览 —**订单(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)
在内部,每个定价选项都由一个复合键寻址: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。requestUuid 在入库前会被规范化。 ABP 会解析该值并改写为标准的小写带连字符形式,因此订单上
回传的值(以及 WebSocket orders 负载中的值)在拼写上可能与你发送的不同。
{EB45B192-317B-42D5-9F65-AF497B9FA8C1}、EB45B192317B42D59F65AF497B9FA8C1 和
urn:uuid:eb45b192-… 都会落到同一个键上——这正是目的所在:仅大小写不同的重试仍会被识别为同一个
订单,而不会变成第二笔真实投注。请按规范化后的形式匹配订单,不要与你发送的原始字符串做逐字节比较。订单生命周期
投注生命周期
结算生命周期
投注CONFIRMED 后,结算追踪资金结果:
结算变更通过
settlements WebSocket 频道推送。参见订单下注与 WebSocket。
账户优先级与额度级联
每个博彩商账户都有priority(越高越优先)。路由时,ABP 会为每家博彩商优先选择优先级最高的活跃账户。
下注额度按优先顺序解析——账户额度 > 博彩商额度 > 赔率额度——取第一个非空值:
术语表
后续步骤
订单下注
成交、定价与额度级联的运作方式。
币种与额度
计价、换算与额度详解。
快速开始
5 步完成首次下注。
博彩商
全部 36 家博彩商的能力矩阵。