Bitget 的 API 在 2026 年已经以统一交易账户（UTA）的 V3 接口为主，经典账户进入维护模式。这篇依 Bitget 官方 API 文档与说明中心整理（核实日 2026-09-28），照对接顺序走一遍：先选账户模式、创建含三组密钥的 API Key、设置权限与 IP、看懂签名与限速数字、在模拟盘跑通，最后把最常被忽略的一段讲清楚——Bitget 官方写明，API 占比高的大户在某些条件下不适用平台返佣。用邀请码 NOVA888 绑定 Quant Nova，Bitget 新用户 Lv.1 合约返佣 40%，是市面常见 20% 邀请码的 2 倍，对成交笔数多的程序交易，这是每个月都在累积的差额。
先选账户模式：统一账户还是经典账户
Bitget 现在有两套 API 文档。官方在经典账户文档开头就写明建议使用统一交易账户，并表示经典账户处于维护模式、只做必要更新（Classic Introduction）。两者差在：
- 统一交易账户（UTA）：现货、杠杆、USDT／USDC／币本位合约共用一个保证金池，一套 V3 接口（路径
/api/v3/...）下单时用category区分产品。 - 经典账户：资产分放在现货、合约等不同账户，例如合约要把 USDT 放在合约账户，用的是 V2 接口。
新写的策略直接用 UTA；已经在经典账户跑 V2 的程序可以继续用，但经典账户只做必要更新，部分功能（例如下面提到的断线自动撤单）只支持 UTA。对接方式不影响返佣：绑定只需要 UID，不用把 API Key 交给任何人。
一把 Bitget API Key 有三组密钥
在网页登录后进“API Key 管理”创建。依官方快速入门（Quick Start），创建后你会拿到三样东西：
| 名称 | 是什么 | 要注意 |
|---|---|---|
| APIKey | API 交易的身份识别，系统随机产生 | 会出现在每个请求的标头 |
| SecretKey | 系统产生的私钥，用来算签名 | 不要传给任何人 |
| Passphrase | 你自己设置的 API 密码 | 设置后不能修改；忘记只能删掉 Key 重建 |
官方的风险提醒写得很直接：三组密钥任何一组外泄都可能造成资产损失，发现外泄要尽快删除 API Key。每个 UID 最多可以创建 50 组 API Key，每组可以设置只读或读写。
子账户的 Key：子账户（虚拟子账户与一般子账户）可以自己创建和管理 API Key，前提是主账户在子账户权限设置里打开“API Key 管理”，这个设置默认是关闭的；主账户随时可以查看、修改或删除子账户的 Key。一支策略配一个子账户，出事时只要处理那一个。
权限与 IP 绑定
官方快速入门列出的统一账户权限分成交易、管理两大类，各有只读与读写；提币另由提币端点标示所需权限：
| 权限 | 能做什么 | 跑策略的建议 |
|---|---|---|
| 统一账户交易（只读） | 查询交易信息 | 只做监控、记账时用 |
| 统一账户交易（读写） | 下单、撤单等 | 下单策略需要 |
| 统一账户管理（只读） | 查询账户信息、费率 | 查余额、查费率需要 |
| 统一账户管理（读写） | 调整杠杆、切换持仓模式等账户设置 | 策略要自动调杠杆才开 |
| 统一账户提币 | 调用提币端点（链上提币与站内转账） | 不要开 |
提币权限的依据是官方提币端点 /api/v3/account/withdrawal 标示的“Permission: UTA withdrawal”（Deposit/Withdrawal 文档）。跑策略从头到尾用不到提币，这个权限一开，Key 外泄的后果就从“乱下单”变成“资产被提走”。
IP 绑定：官方快速入门在安全提示与风险警告里两度写到“强烈建议创建 API Key 时绑定 IP 地址”。依子账户 Key 端点的说明，一把 Key 最多绑 30 个 IP，只支持 IPv4。至于没绑 IP 的 Key 会不会到期，截至 2026-09-28 我们在 Bitget 官方 API 文档与说明中心没有找到明文，创建时以页面显示为准；不论有没有期限，有固定出口 IP 的主机就一定要绑。
签名、时间戳与一段范例
每个 REST 请求都要带 ACCESS-KEY、ACCESS-SIGN、ACCESS-TIMESTAMP、ACCESS-PASSPHRASE 四个标头。签名内容是“时间戳＋大写的请求方法＋请求路径＋（有查询字符串时加 ? 与查询字符串）＋请求本文”，用 SecretKey 做 HMAC-SHA256 后再 Base64 编码；也支持 RSA 签名。WebSocket 登录的时间戳 30 秒后过期，官方建议主机时间和服务器对时。
下面这段用只读的管理权限查询自己的合约费率，顺便确认签名正确；Key 从环境变量读：
import base64, hmac, os, time, requests
KEY = os.environ["BITGET_KEY"]
SECRET = os.environ["BITGET_SECRET"]
PASSPHRASE = os.environ["BITGET_PASSPHRASE"]
path = "/api/v3/account/fee-rate"
query = "category=USDT-FUTURES&symbol=BTCUSDT" # keys sorted A-Z
ts = str(int(time.time() * 1000))
prehash = ts + "GET" + path + "?" + query
sign = base64.b64encode(
hmac.new(SECRET.encode(), prehash.encode(), "sha256").digest()
).decode()
r = requests.get("https://api.bitget.com" + path + "?" + query, headers={
"ACCESS-KEY": KEY, "ACCESS-SIGN": sign, "ACCESS-TIMESTAMP": ts,
"ACCESS-PASSPHRASE": PASSPHRASE, "Content-Type": "application/json",
})
print(r.json(), r.headers.get("x-mbx-used-remain-limit"))回应标头 x-mbx-used-remain-limit 是这个端点目前剩下的额度，程序可以据此放慢。要改测模拟盘，见下面“模拟盘”一节。
限速数字：REST 与 WebSocket 共用额度
官方快速入门写明的总规则：请求太频繁会回 429 Too Many Requests；每个端点的额度标在各自的文档页、分开计算；REST 和 WebSocket 共用同一份限速额度；一般域名的整体上限是每个 IP 每分钟 6,000 次。常用的交易端点（统一账户，Order Management 文档，核实日 2026-09-28）：
| 端点 | 用途 | 额度 | 备注 |
|---|---|---|---|
| /api/v3/trade/place-order | 下单 | 10 次／秒／UID | 美股代币（rToken）另计 5 次／秒 |
| /api/v3/trade/place-batch | 批量下单 | 5 次／秒／UID | 每批最多 20 笔 |
| /api/v3/trade/modify-order | 改单 | 10 次／秒／UID | 结果回来前不能重复送 |
| /api/v3/trade/cancel-order | 撤单 | 10 次／秒／UID | |
| /api/v3/trade/cancel-batch | 批量撤单 | 5 次／秒／UID | 每批最多 20 笔，可部分成功 |
| /api/v3/trade/cancel-symbol-order | 依交易对全部撤单 | 5 次／秒／UID | |
| /api/v3/trade/unfilled-orders | 查询未成交挂单 | 20 次／秒／UID | 合约、现货各最多 400 张挂单 |
| /api/v3/account/fee-rate | 查询费率 | 3 次／秒／UID | |
| /api/v3/account/withdrawal | 提币 | 1 次／秒／UID | 需要提币权限 |
WebSocket 连接规则（UTA 与经典账户文档写法相同）：
- 每个 IP 每 5 分钟最多 300 次连接请求，同时最多 100 条连接。
- 每条连接每小时最多 240 次订阅请求、最多订阅 1,000 个频道；官方强烈建议每条连接订阅少于 50 个频道，比较稳定。
- 每 30 秒送一次字符串 "ping"，收不到 "pong" 就重连；服务器 2 分钟没收到 ping 会断线。
- 每条连接每秒最多收 10 则消息（含 ping、登录、订阅），超过会被断线，反复被断的 IP 可能被封锁。
官方最佳实务文档建议下单前先用 WebSocket 订阅订单频道，并在下单时填自订订单号 clientOid；下单成功只代表交易所收到请求并给了订单号，是否进入撮合要看订单频道推送的状态。
给大户的额外选项：断线自动撤单（countdown-cancel-all，倒数 5～60 秒内没收到心跳就撤掉账户所有挂单）只支持统一账户，要向 Bitget 商务窗口申请；VIP 专线与低延迟的 Lo-La 线路也是给 VIP 与机构用户申请。2026-09-03 起，做市商与 PRO 用户的统一账户改用新的机构限速：单一账户最高 600 次／秒、主子账户合计最高 120,000 次／秒，经典账户不变（官方公告）。
模拟盘：用 Demo API Key 先跑
Bitget 模拟盘用虚拟资金在真实行情下交易，说明中心以 50,000 USDT 为例，支持 BTCUSDT、ETHUSDT 等 USDT 永续，以及 BTCUSD、ETHUSD 币本位与 BTCUSDC、ETHUSDC 等合约；虚拟资金不能提领、也不能转到真实账户，所有用户默认都可以用（What Is Demo Trading on Bitget Futures）。用 API 跑模拟盘的步骤（官方快速入门）：
- 登录账号，切换到模拟（Demo）模式。
- 进个人中心 → API Key 管理，创建 Demo API Key。
- REST 请求照常打 api.bitget.com，但要用 Demo Key，并在标头加上
paptrading: 1。 - WebSocket 改连
wss://wspap.bitget.com/v3/ws/public与wss://wspap.bitget.com/v3/ws/private。
和 Bybit 用独立域名不同，Bitget 模拟盘的 REST 和正式环境是同一个域名，差别只在 paptrading 标头，所以程序里最好把 paptrading 做成明确的设置开关，避免测试程序误打到正式账户。说明中心也提醒，模拟盘的行情同步真实市场，但可能因网络有些微延迟。
API 交易的手续费与返佣条款
费率：Bitget 官方费率表按 VIP 等级区分，VIP0 现货 0.1%／0.1%、合约 maker 0.02%／taker 0.06%，没有另列 API 费率；自己实际的费率可以用上面的 /api/v3/account/fee-rate 查。VIP 门槛与各级费率见 Bitget VIP 等级。
返佣：Bitget 联盟计划写明返佣＝净手续费 × 返佣比例，净手续费是扣除抵扣后实付的手续费，没有单独提到 API 下单；一般用户用 API 下单产生的手续费是否计入，以结算明细为准。但官方有三条和 API 直接相关的例外：
- 高交易量＋API 占比 ≥ 20% 的 VIP：Bitget 费率页写明，VIP 用户 30 天现货量 ≥ 5,000 万 USDT 或合约量 ≥ 1 亿 USDT，且 API 交易占总量 ≥ 20%，不适用平台返佣（Bitget 费率页）。
- PRO 用户：PRO 等级要同时符合交易量与 API 占比 ≥ 20%，PRO1 为 30 天现货量超过 5,000 万或合约量超过 1 亿 USDT；API 占比＝（API 现货量＋API 合约量）÷（总现货量＋总合约量）。PRO 规则写明 PRO 用户“No upstream commission”，推荐人拿不到该用户的手续费分润；PRO 与做市商也不适用平台其他手续费折扣或返佣（Bitget PRO 说明）。
- 机构用户：官方写明 VIP 制度与规则只适用非机构用户。
API 交易量冲到 PRO 门槛，挂牌费率会更低、限速更高，但平台返佣就停了。月量接近 1 亿 USDT、又以 API 为主的账户，先算清楚 PRO 费率和“VIP 费率＋返佣”哪一个实付比较低。
没有碰到上面门槛的量化用户，返佣照一般规则：Quant Nova 的 Bitget 合约返佣新用户 Lv.1 40%、靠交易量可达的 SVIP 45%，最高 50% 为邀请制；现货 40%／45%／45%。换成金额：月合约量 300 万 USDT、全部吃单，手续费约 1,800 USDT，已达 Lv.4（近 30 天手续费 1,000 USDT）的 43%，每月退回约 774 USDT；常见 20% 码只退 360 USDT。完整攻略见 Bitget 手续费返佣攻略，已有账号见 Bitget 换绑教学，多家交易所的量化试算见 量化交易手续费返佣。
已经是其他交易所 VIP、或月交易量大的量化用户，欢迎联系 Quant Nova 客服：我们会直接对接交易所官方窗口，帮你争取 VIP 等级试用等福利，实际福利以交易所核定为准。
Telegram · @quant_nova
LINE · @238pqnkj
