更新日志
本站文档基于 BFX Exchange · API Integration Documentation 维护。
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。