Bitget Reality API 8/11 開放：1/sec/UID 接 webhook

Bitget Reality API 在 8 月 11 日悄悄變天：changelog 把 Reality Order 的下單／撤單 endpoint 從白名單改成全用戶開放。任何 UTA（Unified Trading Account）帳戶都能程式化下 rToken 代幣化美股的單，這件事現在真的不難。

沒有人先跟你講的是：同一則 changelog 底下藏了一行「default rate limit: 1/sec/UID」。webhook——也就是 TradingView 把 alert 自動轉發到你伺服器的那條通道——一有並發訊號，第 2 筆就會撞 429，訊號會安靜地被丟掉。

這篇不評論 rToken 適不適合買（那是投資判斷，本文不做），也不比較誰家的代幣化股票更好——目前只有 Bitget 開這條 API。我們只講兩件事：changelog 這行字到底改了什麼、以及 1/sec/UID 這個門檻對 webhook 自動化系統的實際影響。

Bitget Reality API 的 changelog 這一條到底寫了什麼

Bitget UTA API 的 changelog 頁面 2026-08-11 這一條標題是「Place/Cancel Reality Order: Now open to all users」。改動的兩個 endpoint 是 /api/v3/trade/place-reality-order 與 /api/v3/trade/cancel-reality-order。內文的關鍵句只有兩行。

第一行：「These endpoints no longer require whitelist access.」——這兩支 endpoint 不再需要白名單。第二行：「Default rate limit: 1/sec/UID; whitelisted users: 30/sec/UID (users can contact your BD/RM to apply).」——預設限速是 1/sec/UID，白名單用戶 30/sec/UID，要申請請聯絡 BD 或客戶經理。

rToken 是什麼、能交易哪些

Reality 是 Bitget 生態系裡的 RWA（real-world assets，真實世界資產）發行平台，第一階段主要做的是代幣化美股與 ETF。Bitget Academy 的原文寫「Each rToken is linked to a corresponding underlying asset, such as a publicly traded U.S. stock or ETF」——rToken 代表對某支美股或 ETF 的「economic exposure」（經濟敞口），不是股東權利。

命名規則是原本的美股代號前面加 r，例如 rAAPLUSDT（Apple）、rMUUSDT（Micron）。/api/v3/market/instruments 每筆 instrument 的回應都有 isReality 欄位（值是 "yes" 或 "no"）——它是 response 欄位、不是 query 參數，抓整份清單回來後自己在 client 端篩 isReality === "yes"。名單會隨 Bitget 上下架調整，本文不列固定清單。

拿掉白名單的只有 place 跟 cancel，其他都還鎖著

1/sec/UID 這條門檻的意思

rate limit 這件事每個交易所都有，Bitget 這條的計算單位是 UID。不是每支 API key 各 1 次、不是每個 IP 各 1 次，也不是每個 symbol 各 1 次——同一個 UTA 帳戶產生的所有 place-reality-order 請求，全部共用這 1/sec 的預算。

對 webhook 自動化的實際後果：假設你有 3 條 Pine 策略跑在 1 分鐘 K 棒上，某根 K 棒收線時同時觸發，三筆 place-reality-order 幾乎同時到達 Bitget 端。第 1 筆會成功，第 2 與第 3 筆會拿到 429 錯誤，訊號就這樣消失。這種錯不會吵——log 裡就一行 429，你的策略以為單下出去了，實際上什麼都沒發生。

訊號進來後該怎麼分流

你在自己的 webhook 端該做什麼

• webhook 收到訊號後先過本地 token bucket（容量 1、每秒補 1）再丟給 Bitget，寧可讓策略延遲 1 秒也不要讓訊號被 Bitget 端擋回 429
• Bitget 回 429 時等 1 秒後重送，最多 3 次；仍失敗就明確 log 出來——這是 webhook 系統的常態，不是要修的 bug
• 多策略共用同一個 UTA key 時，把「策略 ID」寫進 Bitget 的 clientOid 欄位，事後對帳才分得清楚是哪條策略的單
• 不要讓多個 K 週期同時觸發同一支策略；真的無法避免，考慮拆到不同 UTA sub-account 各自跑

Reality Order 的下單欄位長什麼樣

{
          "category": "SPOT",
          "symbol": "rAAPLUSDT",
          "side": "buy",
          "orderType": "limit",
          "qty": "1",
          "price": "180.50",
          "clientOid": "strategy-42-signal-001"
        }

TVSBot 目前的位置

先講清楚：TVSBot 目前的 7 家交易所整合裡，Bitget 是有的，但範圍只到 spot 與 perpetual futures——Reality Order 還沒接。Reality 是這個月才拿掉白名單的 endpoint，我們也還沒把它排進更新。這篇的目的不是宣布 Reality 是 TVSBot 現有功能，是把這個新 API 的機制講清楚，因為讀者裡有些人會自己接。

對於已經用 TVSBot 接 Bitget spot/perp 的讀者，rate limit 這件事我們在 webhook 收訊端有做：收到 alert 之後同 token 60 秒內最多 60 條、同 IP 30 秒 30 條（backend/app/services/rate_limit.py）。這是收訊端的 throttle，跟 Bitget 端的 1/sec/UID 是兩層獨立的限速。要手動接 Reality 的話，Bitget 那層的 rate limit 還是要自己在下單模組處理。

誠實的一段：我們沒有實測 Reality 的成交行為

這篇描述的是 API 白紙黑字的部分：changelog 原文、endpoint 的 spec、rate limit 的官方數字。但實際下 rToken 單的成交深度、滑點、非美股交易時段的行為，我們沒有實測。Reality 是新產品，代幣化美股在亞洲時段的流動性通常較差，這幾件事只能你自己下小單試——文件不會告訴你當下的 order book 長什麼樣子。

常見問題