更新日志
本站文档基于 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
- 3.1 注单查询 补全 items[] 及 trades[] 响应字段,新增金额计算公式区块。
- 2.1 登录 新增
lang请求参数(指定游戏界面初始语言)。 - 2.5 钱包转入 / 转出 新增「交易失败与退款处理」说明。
- 01 / 对接流程 明确代理绑定单一货币且开户后不可更改。
- 05 / 常见问题 新增 5.1「目前支持哪些语系」。
- 05 / 常见问题 新增 5.9「体育预测市场规则」(价格与概率、结算方式、交易三步骤、佣金计算)。
v1.0.6 · 2026
- 新增 03 / 查询 APIs(选用):注单查询、转账钱包记录查询、交易状态查询,含独立错误对照表。
- 修正 3.1 注单查询
mid_rate汇率方向定义(1 USD = mid_rate 玩家货币)。 - 币种文档 移除重复的主要币种表,整并为单一完整列表。
- 登录、余额查询、钱包转入 / 转出 货币说明改为连结至币种文档。
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。