Ourbit 可以建 API Key，但能用 API 交易的範圍很窄：查詢當天，官方公開端點 /api/v3/defaultSymbols 只列出 BTCUSDT、ETHUSDT 兩個現貨交易對開放 API 交易，而 Ourbit 現貨本來就是 0 手續費。API 管理頁寫明每個帳號最多 5 把 Key、每把最多綁 4 個 IP，沒綁 IP 的 Key 有效期 90 天，到期前 5 天可以續 90 天。API 單會不會計入返佣，Ourbit 的推廣規則沒有寫（依 Ourbit 官網 API 管理頁、推廣規則與公開 API，查詢日 2026-10-17）。
這篇整理 Ourbit 官方頁面寫明的 API Key 規則、權限、可交易幣對設定與續簽，用公開 API 查到的費率與 API 可交易清單，一段不需要簽名就能跑的查詢程式，以及官方沒有回答的部分。想用程式在 Ourbit 跑合約策略，先看完「官方沒寫清楚的地方」再決定。
快速結論
- API 可交易的現貨只有兩個：查詢當天
defaultSymbols回傳 BTCUSDT、ETHUSDT；API 管理頁也寫，要申請其他幣種的 API 交易要聯繫客服。 - Key 的上限與效期：每個帳號最多 5 把；每把最多 4 個 IP；沒綁 IP 的 Key 90 天失效，到期前 5 天可續簽 90 天。
- 四種權限：基礎、現貨、槓桿、合約，管理頁沒有提幣權限選項，另外建議開啟提幣白名單。
- 手續費：現貨 883 個交易對 maker、taker 全部 0；永續 753 個合約全部 maker 0.02%、taker 0.04%。
- 返佣：手動交易用邀請碼 FEEOTTER 註冊並綁定，合約返佣 70%；API 單是否計入，官方沒寫，以返佣明細為準。
API 管理頁寫明的規則
以下取自 Ourbit 官網「API 管理／創建新 API Key」頁面的官方說明文字，查詢日 2026-10-17：
- 數量：每個帳號最多建立 5 個 API 密鑰；名稱 1～40 個字元。
- IP：綁定 IP 為選填，最多 4 個。頁面寫「未綁定 IP 地址的密鑰有效期為 90 天（不推薦）」。
- 續簽：到期前 5 天，在「我的 API Key → 操作 → 續簽」把效期延長 90 天。
- 可交易幣對：可以在「我的 API Key → 設置可交易幣對」限定這把 Key 能交易的交易對，最多 30 個；沒有設定就是全部可交易（仍受 API 開放清單限制）。
- Secret：只顯示一次，遺失後找不回來。
- 風險提示：建立前要勾選同意「API 用戶風險提示」；頁面另建議開啟提幣白名單。
- 子帳號：可以建「僅通過 API 交易、無登入權限」的子帳號，並替子帳號建 API。
同一頁有一句和上面不一致：「API 密鑰建立後有效期為 180 天。允許讀取的權限包括：現貨委託記錄、現貨成交記錄、合約委託記錄、合約成交記錄。」綁了 IP 的 Key 到底是 180 天還是不會到期，頁面兩處寫法對不上。建 Key 後請直接看列表上的「剩餘有效期（天）」欄位，到期前 5 天記得續簽。
權限怎麼勾
| 權限 | 用途 | 跑策略要不要勾 |
|---|---|---|
| 基礎 | 讀取帳戶與委託、成交紀錄 | 預設就有 |
| 現貨 | 現貨下單、撤單 | 跑現貨策略才勾 |
| 槓桿 | 槓桿交易 | 用到才勾 |
| 合約 | 合約交易 | 跑合約策略才勾，先確認合約 API 可用 |
API 管理頁沒有列出提幣權限。就算 Key 本身不能提幣，提幣白名單還是要開，帳號被盜時多一道關卡。Ourbit 帳號安全與 KYC 額度見 Ourbit KYC 教學。
API 能交易什麼：公開端點實測
| 項目 | 查詢當天的結果 | 來源端點 |
|---|---|---|
| 開放 API 交易的現貨 | BTCUSDT、ETHUSDT | api.ourbit.com/api/v3/defaultSymbols |
| 現貨交易對與費率 | 883 個，maker、taker 全部 0 | api.ourbit.com/api/v3/exchangeInfo |
| BTCUSDT 支援的單別 | LIMIT、MARKET、LIMIT_MAKER | 同上 |
| 永續合約與費率 | 753 個，全部 maker 0.02%、taker 0.04% | futures.ourbit.com/api/v1/contract/detail |
| BTC_USDT 最高槓桿 | 500 倍 | 同上 |
API 能交易的兩個現貨交易對都是 0 手續費，現貨用 API 沒有手續費，也就沒有返佣可談。真正有手續費的是合約。合約的私有端點（例如帳戶資產）在未帶簽名時回傳「No authority!」，代表端點存在，但我們沒有找到 Ourbit 目前公開的合約 API 文件，無法確認一般用戶能不能用 API 下合約單。
下面這段不需要 Key，可以自己查最新清單與費率：
import requests
spot = requests.get("https://api.ourbit.com/api/v3/defaultSymbols").json()
print("API spot pairs:", spot["data"])
info = requests.get("https://api.ourbit.com/api/v3/exchangeInfo?symbol=BTCUSDT").json()
s = info["symbols"][0]
print(s["symbol"], "maker", s["makerCommission"], "taker", s["takerCommission"])
fut = requests.get("https://futures.ourbit.com/api/v1/contract/detail?symbol=BTC_USDT").json()["data"]
print(fut["symbol"], "maker", fut["makerFeeRate"], "taker", fut["takerFeeRate"], "max", fut["maxLeverage"])官方沒寫清楚的地方
- 目前的 API 文件：官網的 API 管理頁有「API 文檔」入口，但我們沒能從公開頁面讀到現行文件。GitHub 上找得到一份署名 Ourbit 的舊版 V2 文件，官網沒有連到它，內容也只到現貨，本文不採用。
- 限速：沒有找到現行的官方限速數字。
- 合約 API：API 權限有「合約」，但能不能下單、限速多少，官方公開頁面沒有說明。
- API 單是否計入返佣：Ourbit〈邀請好友〉頁的推廣規則寫返佣按「系統實收的手續費」計算，合約贈金支付的手續費與異常交易不計入，沒有提到 API。
上線前直接問 Ourbit 客服，或先用最小下單量測一筆，再看返佣明細有沒有這筆。
返佣怎麼算：手動合約單 70%
用我們的邀請碼 FEEOTTER 註冊，並到 Fee Otter 綁定 UID，Ourbit 合約返佣 70%（50% 交易所自動返佣＋20% 額外返佣）。50% 由 Ourbit 直接退回帳戶；20% 由 Fee Otter 每日結算，申請提領時以 USDT 走 BEP20 鏈上發放，每次最低 1 USDT，網路費 0.015 USDT 由用戶負擔。返佣只算交易手續費，不含資金費與強平；API 單是否計入，Ourbit 官方沒有寫明，以返佣明細為準。
用數字看。每月合約吃單成交 200 萬 USDT，以 taker 0.04% 計：
| 情況 | 月手續費 | 返佣 | 實付 |
|---|---|---|---|
| 手動下單，用我們的邀請碼並綁定（70%） | 800 USDT | 560 USDT | 240 USDT |
| 同樣成交量，如果 API 單不計返佣 | 800 USDT | 0 | 800 USDT |
第二列是假設情境，因為官方沒有寫。對照：MEXC 官方寫明 API 單不計佣金，見 MEXC API 交易設定；兩家合約費率與返佣的比較見 Ourbit 與 MEXC 返佣比較。結算方式見 返佣怎麼結算。
想自動跟著別人下單、又保留返佣，可以看 Ourbit 平台內建的 Ourbit 跟單教學。主要靠 API 的人，各家 API 規則見 交易所 API 比較。
Telegram · @feeotter
