POST /v1/orders 既用于预览,也用于下单。mode 为必填且没有默认值,因此请求绝不会意外下单。
请求
投注额如何拆分
投注额会在所请求的博彩公司之间拆分,只选取报价不低于minPrice 的那些,并遵守各自的限额。每一部分成为一笔注单。因此一个订单可以包含多笔不同价格的注单;averageFilledPrice 是它们按投注额加权的平均值。
部分成交与到期
带
expiresAt 的订单会一直保持进行中,直到成交或到期。可通过 POST /v1/orders/{id}/cancel 提前撤单。部分环境尚未提供到期功能:它们会返回 503 EXPIRY_NOT_AVAILABLE,而去掉 expiresAt 的同一订单可以正常下单。
博彩公司
- 您的博彩公司。
GET /v1/me列出您账户的博彩公司。请求其他博彩公司会返回403 BOOKMAKER_NOT_AVAILABLE。 - 对 API 关闭的博彩公司。 某个博彩公司即使已在您的账户上启用,也可能对 API 关闭,
GET /v1/me不会列出它。请求它会返回400 BOOKMAKER_NOT_AVAILABLE_VIA_API,且省略bookmakers时也绝不会使用它。
先预览
预览返回当前会下达的内容:bets 中每个博彩公司对应一项,包含其状态、投注额和价格。
GET /v1/betslip 读取投注单:参见行情赔率与投注单。
拒绝
在向博彩公司发送任何内容之前,会先检查订单:您的余额、每场赛事的限额、账户规则、价格和流动性。检查失败时,请求返回错误,不记录任何内容;参见错误。 订单记录之后,博彩公司仍可能拒绝其负责的那一部分。这不是错误:订单照常返回,被拒绝的注单带有status: "REJECTED" 和 declineReason。参见订单与注单生命周期。