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
