Skip to content

更新日志 ​

本站文档基于 BFX · API Integration Documentation 维护。

v1.1.0 · 2026 ​

  • 新增 Prediction 产品。01 / 对接流程 新增「产品说明」:两项产品共用 API 凭证与钱包余额。
  • 站点名称由「BFX Exchange」改为「BFX」。
  • 2.4 余额查询、2.5 钱包转入 / 转出 改用不带产品前缀的通用路径:/api/v1/user/wallets/{external_player_id}/balance、/deposit、/withdrawal,适用 Exchange 与 Prediction;原 /api/v1/user/exchange/wallets/... 路径仍可使用。
  • 2.3 登录 新增两个入口:/api/v1/user/sso/getkey(大厅选单,由玩家选择产品)、/api/v1/user/prediction/sso/getkey(直接进入 Prediction);原 /api/v1/user/exchange/sso/getkey 直接进入 Exchange。
  • 03 / 查询 APIs 重新分组为「共用」「Exchange」「Prediction」,错误对照表移至末尾,章节重新编号(3.1 – 3.10)。
  • 3.1 钱包交易记录(原「查转账钱包记录」)路径变更为 GET /api/v1/wallet/report/ledger,适用 Exchange 与 Prediction。
  • 3.2 交易状态查询 路径变更为 POST /api/v1/wallet/transfer-wallet-transaction/status,适用 Exchange 与 Prediction;原 /api/v1/user/exchange/transfer-wallet-transactions/status 路径仍可使用。
  • 新增 Prediction 查询 API:3.7 委托单明细、3.8 成交明细、3.9 持仓明细。
  • 2.5 钱包转入 / 转出 amount 精度由最多 8 位小数调整为最多 2 位小数。
  • 3.1 钱包交易记录 新增 kind、source_id_type 枚举,注明 items[] 按 created_at 倒序排列。
  • 3.2 交易状态查询 补上 id、source_id、source_id_type、order_ids、kind 响应字段。
  • 3.3 注单查询 trades[] 补上 account_external_id、counter_party;修正 trades[].usd_stake 说明为本笔撮合金额;注明 usd_unmatched 于订单取消后归零;下单时间区间必填栏改为条件必填。
  • 新增 3.4 注单查询(增量同步) GET /api/v1/exchange/report/bets/changes:依变动时间(含回滚、作废等后续变动)返回订单,游标分页,供商户增量同步注单;原 3.4 – 3.9 顺延为 3.5 – 3.10。

v1.0.8 · 2026 ​

  • 2.1 通用约定 新增「时间格式」:RFC3339 小数秒位数不固定,须用通用 parser 解析;空值输出 null。
  • 2.5 钱包转入 / 转出 新增错误码 10040(同 ticket_id 请求处理中)与 10050(同 ticket_id 带入不同金额 / 币种)。
  • 2.5 钱包转入 / 转出 新增「幂等与去重规则」:去重键含交易类型、金额与币种须完全一致、X-Idempotency-Key 不参与转账幂等判定。
  • 2.6 常见对接错误对照表、3.6 查询 APIs 错误对照表 补入 10040、10050。
  • 3.1 注单查询 补全 settled_time 与 updated_at 语义,新增「订单层与成交层」区块及作废注单查询方式。
  • 3.2 查转账钱包记录 补上 id、source_id、source_id_type、kind、order_ids 五个响应字段,新增「order_ids 行为」与「增量对账」区块。
  • 3.2 查转账钱包记录 交易类型枚举修正 BET_CANCEL_VOID_REFUND 为 BET_CANCEL_REFUND,补入 ADMIN_CANCEL_REFUND、ADMIN_CANCEL_CLAWBACK,并标注 RE_SETTLEMENT_PAYOUT、MARKET_SUSPEND_REFUND 为保留值。
  • 3.3 交易状态查询 说明 10030 同时代表「不存在」与「尚未入账」,并补上限流说明。
  • 各查询 API 限流说明改为明确标示额度按 api_key × 接口独立计算。
  • 05 / 常见问题 新增 5.10「回滚后多久会重新结算」、5.11「赛事最终被取消时注单的最终状态」。

v1.0.7 · 2026 ​

v1.0.6 · 2026 ​

v1.0.5 · 2026 ​

  • 扩充 1.1 提交申请:补充总代 / 代理信息、钱包类型、货币、IP 白名单与开户资料回覆方式等完整申请资料清单。
  • 新增 1.1.1 IP 白名单说明:区分前台(机器对接)与后台(人员登入)白名单及 CIDR 格式说明。

v1.0.4 · 2026 ​

  • 扩充 支援币种列表(新增 LKR、PKR、KES、INR、ZAR、HKD、PGK、AUD、CAD、NZD、SGD、EUR、GBP 等)。

v1.0.3 · 2026 ​

  • 登录 + 钱包 APIs(登录、余额查询、转入 / 转出)。
  • HMAC 验证流程(JCS + SHA-256 + HMAC-SHA256)。
  • 对接流程、币种文档与 F&Q。

BFX · BE THE GAME CHANGER