跳转到主要内容
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。参见订单与注单生命周期。