NOCTURN SPORT

体育投注API:赔率流、下注与风控接口

面向有自研前端的运营商,用一组清晰的接口把体育赔率和下注能力接进自己的平台。

更新于 2026年10月27日

Nocturn Sport的体育投注API为运营商提供赔率(赛前与滚球)、下注、注单和余额四类核心接口。所有赔率均由我们的模型生成,API交付的是模型算出的价格,而不是转发的第三方数据。

赔率流:快照加版本化增量

首次接入时,客户端拉取一次全量快照,获得当前所有开放的运动、赛事、比赛、盘口和选项。之后,客户端带上自己最后收到的版本号定期轮询(大约每10秒一次),服务器只返回自该版本以来的变化:新开的比赛、价格变动、暂停或关闭的盘口。这种方式数据量小、容易对账,断线后用最后版本号即可补齐。

下注接口

  • 单关与串关:串关最多10个选项,每场比赛只能选一个。
  • 请求ID:每次下注带唯一请求ID,网络重试时不会重复下单。
  • 价格校验:下注时校验当前价格与盘口状态,变动或暂停时返回明确结果。
  • 注单历史:按玩家查询注单及结算状态。
  • 玩家余额:查询和同步玩家余额。

币种与加密货币

每位玩家只用一种货币下注,余额、投注额和派彩都以这一货币计算。目前共支持73种货币:60种法定货币,外加13个加密货币单位,即USDT、USDC、BTC(也可按mBTC和SATS显示)、ETH、LTC、TRX、DOGE、SOL、XRP、BNB和TON。汇率每小时刷新一次。运营商以欧元设置的投注限额会自动换算成每种货币,因此用USDT的玩家和用人民币的玩家面对的是同样的上限。最新币种清单公开在 nocturnsport.com/api/currencies。

后台风控参数

通过后台,运营商可以暂停赛事、覆盖任意价格、结算赛果、查看敞口(liability),并设置最低和最高赔率、单注最高投注、最高派彩、每张注单的最多选项数、开赛前的关盘时间以及抽水水平。这些参数直接作用于API返回的赔率和下注校验。

一次典型的下注流程

  1. 玩家在运营商前端选中选项,前端组装注单(单关或串关)。
  2. 前端带上请求ID、玩家标识、选项和投注额调用下注接口。
  3. 服务器校验盘口是否开放、价格是否变化、是否超出最高投注、最高派彩和选项数量等限制。
  4. 通过则返回注单号并扣减余额;不通过则返回具体原因,前端提示玩家确认新价格或调整注单。
  5. 比赛结束结算后,注单状态和玩家余额同步更新,可在历史接口中查询。

开发团队关心的细节

接口返回结构固定,盘口与选项都有稳定的标识,便于运营商在本地建立映射;价格以十进制赔率表示,前端可自行换算成香港盘、马来盘等格式展示。关盘时间、赔率上下限等参数调整后,会直接体现在后续的增量和下注校验中,无需前端额外处理。

对接方式

可以直接对接Nocturn Sport API,也可以通过 softaggregator.com 聚合平台接入,一次集成同时获得娱乐场内容和体育板块。若想要现成界面,请看白标方案;赔率结构细节见赔率数据流页面。

需要接口文档或测试账号,请发邮件到 [email protected],或在联系我们页面找到Telegram方式。价格按需报价。

Nocturn Sport 新功能

  • 滚球投注:足球、篮球、网球和板球
  • 开赛前提前兑现
  • 球员盘口
  • 角球、罚牌与比赛数据
  • 丰富的足球玩法
  • 赔率加成
  • 其他项目同样深入
  • 诚信预警
  • 按运营商单独设置

查看全部盘口与功能 →

常见问题

赔率更新多久一次?

客户端大约每10秒带上最后版本号轮询一次,服务器返回此后的所有变化。

网络超时后重复提交会产生两张注单吗?

不会。每次下注使用唯一请求ID,相同ID的重复请求只会处理一次。

串关有什么限制?

默认最多10个选项、每场比赛一个选项,运营商还可以在后台设置更低的上限。

玩家可以用加密货币投注吗?

可以。稳定币、比特币、以太坊、波场、Toncoin等主流币种与法币并列可选,接入方式完全不变:只需传入玩家的币种代码,其余由API处理。

体育投注API包含滚球赔率吗?

包含。足球、篮球、网球、板球的滚球赔率走同一条数据流,附带比分、比赛时钟和暂停状态。球员、角球、罚牌等细分盘口按场次按需提供,每个运营商也可以自行设置滚球投注延迟。

API的使用费用怎么算?

费用按运营商规模和需求单独报价,请联系 [email protected]。

相关页面