什么是 ABP？
自动投注（ABP） API 由 55 Tech 提供，让您通过单一集成在30家博彩公司进行投注。无需构建和维护各个博彩公司的连接器，ABP 处理从投注到结算的全部生命周期。 核心能力：- 账户管理 — 博彩公司账户的完整CRUD操作，支持优先级选择、每账户投注限额和多币种
- 投注单获取 — 在下注前获取所有已配置博彩公司的任何赛事/结果的实时赔率和限额
- 期货支持 — 使用
futureId和participantId在冠军/期货市场下注（即将推出） - 智能订单路由 — 下达单个或批量订单；ABP 自动按赔率和限额选择最佳博彩公司
- 投注跟踪 — 从下注到确认和结算，完整审计追踪监控每一注
- 持仓和盈亏分析 — 按博彩公司、账户或用户引用分组的汇总敞口和盈亏视图
数据流
通过 OddsPapi v5 发现赛事和赔率
您的应用使用 OddsPapi v5 API 发现赛事、市场、结果和实时赔率。OddsPapi 是数据层 — ABP 是建立在其之上的执行层。两个 API 共享赛事ID和结果ID。
从 ABP 获取投注单
下注前，调用
GET /betslip?fixtureId=...&outcomeId=...&playerId=... 获取所有已配置博彩公司账户的汇总赔率和限额。对于期货市场，使用 futureId 替代 fixtureId，并添加 participantId。ABP 解析投注限额（账户 > 博彩公司 > 赔率）并返回每个博彩公司的有效最小/最大值。通过 ABP 下单
发送
POST /place-orders 包含一个或多个订单。每个订单针对赛事（fixtureId）或期货（futureId）。ABP 根据价格、可用限额和账户优先级将每个订单路由到最佳博彩公司。每个博彩公司集成下注并回报确认或拒绝。基础URL
关键概念
订单 vs 投注
订单是您的下注指令。投注是在博彩公司实际放置的注单。使用部分成交或多博彩公司路由时，一个订单可能产生多个投注。请求去重
每个订单需要唯一的requestUuid（UUID格式）。ABP 使用服务端去重（30分钟TTL）防止重复下注。重复请求返回 409 Conflict。
订单生命周期
- PENDING — 订单已接收并排队
- PROCESSING — 正在路由到博彩公司
- FILLED — 全部投注额已成功下注
- PARTIALLY_FILLED — 部分投注额已下注，剩余已过期或无容量
- REJECTED — 验证失败（赔率不对、赛事无效等）
- EXPIRED — 订单
expiresAt时间已到（默认：5秒，最长：24小时） - CANCELLED — 客户端显式取消
- FAILED — 下注过程中出现内部错误
投注生命周期
- PENDING — 投注已创建，等待博彩公司响应
- PLACED — 已发送到博彩公司，等待确认
- CONFIRMED — 博彩公司已接受投注
- REJECTED — 博彩公司拒绝了投注
- CANCELLED — 确认前投注已取消
- FAILED — 下注过程中出现内部错误
- VOID — 博彩公司取消了投注
结算生命周期
- UNSETTLED — 投注进行中，等待结果
- WON — 全赢
- LOST — 全输
- VOID — 投注作废（退还投注额）
- HALF_WON — 亚洲盘部分赢
- HALF_LOST — 亚洲盘部分输
- PUSH — 退还投注额（平局）
- CASHOUT — 以协商价格提前提款
账户优先级
每个博彩公司账户有一个priority 字段（值越高越优先）。下单时，ABP 为每个博彩公司优先选择最高优先级的活跃账户。
限额级联
投注限额按优先级顺序解析：账户限额 > 博彩公司限额 > 赔率限额。 例如，如果账户minStake: 10，博彩公司默认 minStake: 1，赔率条目显示 limitMin: 5，有效最低值为 10（来自账户覆盖）。
期货（即将推出）
ABP 支持期货（冠军）市场以及标准的赛事市场。期货使用futureId 标识冠军市场，使用 participantId 指定选择（例如赢得联赛/锦标赛的球队或球员）。
与赛事订单的主要区别：
| 赛事订单 | 期货订单 | |
|---|---|---|
| 标识符 | fixtureId | futureId |
| 选择 | outcomeId + playerId | outcomeId + playerId + participantId |
| 投注单 | GET /betslip?fixtureId=... | GET /betslip?futureId=... |
| 市场键格式 | fixtureId:bookmaker:outcomeId:playerId | futureId:bookmaker:outcomeId:playerId:participantId |
501 Not Implemented。将在即将发布的版本中启用。
博彩公司标识
博彩公司通过标识字符串识别（例如pinnacle、betfair-ex、polymarket）。使用 GET /bookmakers 列出所有30家支持的博彩公司及其默认投注限额。
端点一览
| 类别 | 端点 | 描述 |
|---|---|---|
| 账户 | GET/POST/PATCH/DELETE /accounts | 管理博彩公司账户（凭证、余额、优先级、限额） |
| 投注单 | GET /betslip | 下注前获取实时赔率和限额（赛事和期货） |
| 订单 | POST /place-orders, POST /cancel-orders, POST /cancel-all-orders, GET /orders | 下单、取消和跟踪订单 |
| 投注 | GET /bets, GET /bets/{bet_id} | 查看单个投注结果 |
| 分析 | GET /positions, GET /pnl | 汇总敞口和盈亏 |
| 博彩公司 | GET /bookmakers | 列出所有支持的博彩公司 |
| 市场 | GET /markets | 可用市场和赔率类型 |
| WebSocket | WS /ws | 实时更新 |
支持的博彩公司
传统体育博彩： pinnacle, pinnacleb2b, betamapola, betcris, bookmaker.eu, cloudbet, cloudbetb2b, justbet, kaiyun, monkeyline.vip, novig.us, 198bet, paradisewager, sharpbet, singbet, sports411.ag, 3et, vertex 博彩交易所： betfair-ex, limitless-ex, matchbook, smarkets 预测市场： 4casters, kalshi, polymarket, polymarket.us, predict.fun, prophetx, sx.bet Punter平台： punter.io可靠性
ABP 包含生产级可靠性功能：- 熔断器 — 每博彩公司熔断器防止级联故障并自动恢复
- 指数退避重试 — 用于瞬态故障
- 紧急控制 — 在系统维护期间订单可能会被临时暂停
- 速率限制 — 每API密钥的速率限制（每客户可配置）
数据源
ABP 从 OddsPapi v5 获取实时赔率数据。ABP 中的赛事ID和结果ID直接对应 OddsPapi 标识符。您的应用应使用 OddsPapi 发现赛事和市场，然后使用 ABP 执行投注。下一步
身份验证
设置您的API密钥。
快速入门
5步完成您的首次投注。