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
