BingX 的 API Key 在网页或 App 的“API 管理”页创建，创建后会拿到 API Key 和 Secret Key 两组信息；官方建议设置 IP 白名单，Key 外泄就立刻删除重建。权限分现货交易、读取、永续合约交易、万向划转和子账号内部转账，现货和 U 本位合约共用同一把 Key、权限分开设置。每个主账号最多 20 组 Key，请求的时间戳要在服务器时间 5 秒以内，行情接口的 IP 限速是每 10 秒 500 次（BingX 官方 API 文件，查询日 2026-10-17）。
这篇依 BingX 官方 API 文件与 API 常见问题整理：创建与权限、IP 白名单、签名与时间戳、限速与风控、模拟盘测试，以及 API 下单的手续费与返佣。用我们的邀请码 FEEOTTER 注册 BingX，手续费返 45%（全部是 BingX 自动返佣），不需要绑定 UID，也不需要把 API Key 交给 Fee Otter。
快速结论
- 在哪创建：BingX 网页或 App 的“API 管理”页；官方常见问题写明 App 也支持管理 API Key。
- 权限：现货交易、读取、永续合约交易、万向划转、子账号内部转账；官方 API 文件也列了子账号 Key 的“提币”权限。
- 数量：每个主账号最多 20 组 Key、20 个子账号，每个子账号也能建 20 组。
- 签名：HMAC SHA256，Header 带 X-BX-APIKEY，时间戳和服务器差距不能超过 5 秒。
- 限速：依 UID 逐个接口限速，行情接口另有每 10 秒 500 次的 IP 限速；触发后约 5 分钟恢复。
- 模拟盘：合约模拟盘域名 open-api-vst.bingx.com，用虚拟 USDT（VST）。
创建步骤
官方 API 文件《Generate an API Key》写的流程很简短：先到 BingX 的 API 管理页创建 Key，创建后会得到 API Key 和 Secret Key，两者都要记下来、不要告诉任何人；设置时建议同时设 IP 白名单；Key 意外外泄就立刻删除，重新生成一组。
- 登录 BingX，进入账户的“API 管理”页，按创建 API。
- 填备注名称，勾选需要的权限，能绑 IP 就填 IP 白名单。
- 完成安全验证后，复制 API Key 和 Secret Key 存在安全的地方。
创建前要先完成哪些设置（KYC、双重验证），以及 Secret Key 是否只显示一次，这次在 BingX 官方说明中心没有找到逐步教学，以创建页面的提示为准。来源：BingX API 文件、BingX API 常见问题（2026-10-14 更新）。
权限：每一组该不该开
| 权限 | 做什么 | 建议 |
|---|---|---|
| 读取 | 查询余额、仓位、订单 | 记账、报税工具只开这个 |
| 现货交易 | 现货下单、撤单 | 只跑现货策略才开 |
| 永续合约交易 | U 本位永续下单、撤单、调杠杆 | 合约策略需要 |
| 万向划转 | 在现货、合约等账户之间搬资金 | 策略需要自动调度资金才开 |
| 子账号内部转账 | 允许子账号之间内部转账 | 只在主账号管理子账号时用 |
权限代码见官方 API 文件的“创建子账号 API Key”接口：1 现货交易、2 读取、3 永续合约交易、4 万向划转、7 允许子账号内部转账；文件更新记录另写明子账号 Key 新增了 5“提币”。官方常见问题也说明，U 本位合约和现货用的是同一把 API Key，但两边的交易权限要分开设置。给第三方机器人或跟单工具的 Key，只开交易权限，不要开提币，也不要开万向划转。
IP 白名单
官方文件建议创建 Key 时设置 IP 白名单；从不在白名单上的 IP 提交请求，会收到错误码 100419“IP does not match IP whitelist”。一把 Key 最多能绑几个 IP、能不能填 IP 段，以及没绑 IP 的 Key 会不会过期，这次在官方文件与说明中心没有找到，以创建页面显示为准。BingX 服务器架在 AWS 新加坡区（ap-southeast-1），延迟敏感的策略可以把主机放在附近。
签名、时间戳与域名
- 签名：用 Secret Key 对请求参数做 HMAC SHA256，结果放在 signature 参数。参数放在 query string 时直接照原顺序拼接、不需排序；放在 request body 时要依 a～z 排序后拼接。
- Header：请求要带 X-BX-APIKEY: 你的 API Key。
- 时间戳：毫秒，必须在 API 服务器时间的 5 秒以内，否则视为过期拒绝；本机时间偏差大时，先查 /openApi/swap/v2/server/time 校正。
- 域名：实盘 open-api.bingx.com，合约模拟盘 open-api-vst.bingx.com。
下面是查询 USDT 永续合约账户余额的最小示例（Python，仅供示意）：
import time, hmac, hashlib, requests
API_KEY = "你的 API Key"
SECRET = "你的 Secret Key"
HOST = "https://open-api.bingx.com" # 模拟盘改用 https://open-api-vst.bingx.com
path = "/openApi/swap/v3/user/balance"
params = f"timestamp={int(time.time() * 1000)}"
sign = hmac.new(SECRET.encode(), params.encode(), hashlib.sha256).hexdigest()
r = requests.get(f"{HOST}{path}?{params}&signature={sign}",
headers={"X-BX-APIKEY": API_KEY})
print(r.json())Key 和 Secret 不要写死在代码里，正式使用时改用环境变量。
限速与风控
依官方 API 文件的“Rate limit”与 API 常见问题：
- 依 UID 限速：每个接口各自独立计算，互不影响，各接口的额度写在该接口文件里；回应 Header 的 X-RateLimit-Requests-Remain（剩余次数）和 X-RateLimit-Requests-Expire（窗口到期时间）可以用来动态调整频率。
- IP 限速：行情接口每 10 秒 500 次。2025-12-16 起，账户类接口第 2、3 组原本的 IP 限速（每组每 10 秒 2,000 次、单一接口 300 次）已经取消。
- 触发后：请求太频繁会被自动限制，约 5 分钟后恢复；收到 429 还继续送，IP 可能被自动封锁（418）；收到 403 代表触发防火墙，多数情况暂停 5 分钟，被判定恶意可能更久甚至永久。
- 同一笔单：同一张订单每秒只能提交一次；撤单接口对同一个 orderId 每秒限一次。
BingX 官方 API 常见问题：交易行为若与一般用户差异很大，可能被禁止交易，期限不定；经常霸占最优买卖价、频繁下单撤单却没有成交、成交率或成交权重很低，以及收到 429 后仍持续频繁请求，都会延长禁止交易的时间。（BingX API FAQ-08）
官方文件没有在这份说明里列出合约下单接口的 UID 次数上限，以回应 Header 的剩余次数为准。
先在模拟盘跑
官方 API 文件写明，合约模拟盘的下单域名是 open-api-vst.bingx.com，保证金和盈亏都以 VST（虚拟 USDT）计；VST 不够时可以呼叫 /openApi/swap/v2/trade/getVst 申请（2025-12-18 起升级为 v2，可增加或减少自订金额）。另有 /openApi/swap/v2/trade/order/test 测试下单接口：参数和回传与正式下单相同，但不会真的下单、也不扣资金，适合先验证签名和参数。网页与 App 的模拟交易规则见《永续合约模拟交易上线》。
其他官方限制：API 目前不支持标准合约；股票、外汇、商品、指数等 TradFi 永续交易对可以用 API 交易。下单的价格和数量精度、最小下单量可以从 /openApi/swap/v2/quote/contracts 取得，超出精度的部分会被截断。
API 下单的手续费与返佣
API 下单的手续费和手动下单一样，照你的 VIP 等级收：一般用户永续合约 maker 0.02%、taker 0.05%。BingX 的 VIP 4 以上，成交量路线要求 API 成交占比不超过 20%，量化账户要升高等级，通常得走资产路线。
返佣方面，BingX 官方公开页面这次没有找到“API 成交不给推荐返佣”的规定，实际以你 BingX 账户的返佣记录为准；这点和 MEXC 不同，MEXC 的联盟常见问题写明 API 成交不计佣金。以每月 API 合约成交 500 万 USDT、六成挂单四成吃单估算，混合费率 0.6 × 0.02%＋0.4 × 0.05%＝0.032%，月手续费约 1,600 USDT，45% 返佣约退回 720 USDT。各家 API 规则比较见 交易所 API 比较，量化交易者的返佣算法见 量化交易的手续费返佣。
用我们的邀请码 FEEOTTER 注册 BingX，45% 由 BingX 直接退回你的 BingX 账户，不需要到 Fee Otter 绑定 UID，Fee Otter 也从来不需要你的 API Key、密码或提币权限。比例依 Fee Otter 与 BingX 的合作条件设置、可能调整。
Telegram · @feeotter