1. 登入 Gate 個人帳戶,點擊右上角 “頭像”—“API管理”。
2. 在“API Key 管理”頁面,點擊“創建 API Key”。
3. 創建 API Key
APIv2 Key 創建:
① 輸入 IP 地址權限:可選擇綁定/不綁定 IP。注意:不綁定 IP 將允許任何地址訪問,有效期爲 90 天。
② API Key 類型:選擇API v2 Key。每個用戶只可創建 1 組,新創建的將覆蓋之前。權限可選擇讀寫/只讀。
③ 核實無誤後,點擊“提交”。

注:新的API Keys產生後,舊的API Keys將立即失效。
使用API Keys 可以通過程序查詢該帳號信息、進行交易操作/提現操作等,請妥善保管,切勿泄露API Keys給他人!避免造成不必要的損失。
APIv4 Key 創建:
① API Key 備注: 助於辨別和記憶。
② 輸入 IP 地址權限:可選擇綁定/不綁定IP。注意:不綁定IP將允許任何地址訪問,有效期爲90天。
③ API Key類型:選擇 API v4 Key。
④ 帳戶類型:可選擇經典/統一/模擬帳戶。
⑤ 權限:可選擇讀寫/只讀。注意:幣對信息不能爲空,添加交易後方可保存。
⑥ 核實無誤後,點擊“提交”。

4. 提交後會彈出風險提示,請仔細閱讀,勾選並點擊“我已知曉”或點擊“取消”。

輸入資金密碼,選擇二次驗證方式後輸入驗證碼,點擊“確認”。

5. 創建完成,可對創建的API進行管理。

6. 注意事項:
① APIv2/4 目前支持提幣、充值操作。使用API進行提現,必須要是手動提現過一次的地址,並且經過24小時才可以操作提現;
② APIv2 與 APIv4 的區別:
- 兩者的 API Key 是獨立的;
- APIv2 在交易操作上只支持現貨交易,APIv4 支持現貨、槓杆和合約的完整交易操作;
- APIv2 在個人帳戶的 “APIv2 Keys” 入口申請,APIv4 在個人帳戶的 “APIv4 Keys” 頁面申請。
請根據個人當前狀況自行選擇,更新情況請注意文檔的更新。
如文檔說明中未能爲您遇到的問題提供幫助,請您提交工單進行反饋。提交問題中請寫明以下信息,以便快速定位您的問題並爲您解決。
請盡可能提供以下相關信息: ID,原始的請求 URL、請求參數和請求具體內容、使用的 API Key 是現貨/槓杆,合約模擬/合約實盤、編程語言(最好提供一段發送請求的代碼片段)、 是否使用了 SDK(如使用 SDK ,請說明調用方式或可通過 Github 留言)。
7. API 文檔可在網頁端首頁底部“服務”——“開發者中心”獲取。
8. 限頻規則
| 市场 | 入口 | 限速 | 依据 | 包含 |
|---|---|---|---|---|
| 公共接口 | 公共接口 | 单个接口 200r/10s | IP | 深度、K线、交易对信息等 |
| 钱包 | 私有接口 | 提现接口(POST /withdrawals) 1r/3s 提现uid转账接口(POST /withdrawals/push) 1r/10s 交易账户互转接口 (POST /wallet/transfers) 80r/10s 主子账号互转 (POST /wallet/sub_account_transfers) 80r/10s 子账号与子帐号互转 (POST /wallet/sub_account_to_sub_account) 80r/10s 查询个人账户总额 (GET /wallet/total_balance) 80r/10s 查询子账号余额信息 (GET /wallet/sub_account_balances) 80r/10s 查询子账号逐仓杠杆账户余额信息 (GET /wallet/sub_account_margin_balances) 80r/10s 查询子账号永续合约账户余额信息 (GET /wallet/sub_account_futures_balances) 80r/10s 查询子账号全仓杠杆账户余额信息 (GET /wallet/sub_account_cross_margin_balances) 80r/10s 钱包其他单个接口 200r/10s |
UID | 提现 个人账户余额查询 子账户余额查询 |
| 现货 | 私有接口 | 现货批量/单个下单/单个修改接口一共订单数 10r/s (uid+市场) 现货批量/单个撤单接口一共 200r/s 现货其他单个接口 200r/10s |
UID | 现货下单、撤单 成交历史、费率查询等 |
| 永续合约 | 私有接口 | 合约批量/单个下单/修改单个订单接口一共 100r/s 合约批量/单个撤单接口一共 200r/s 永续合约其他单个接口 200r/10s |
UID | 合约下单、撤单 成交历史、费率查询等 |
| 交割合约 | 私有接口 | 单个下单接口 500r/10s 单个撤单接口 500r/10s 交割其他单个接口 200r/10s |
UID | 下单、撤单 |
| 期权合约 | 私有接口 | 单个下单接口 200r/s 单个撤单接口 200r/s 期权其他单个接口 200r/10s |
UID | 下单、撤单 |
| 子账户 | 私有接口 | 单个子账户相关接口 80r/10s | UID | 创建普通子账户 查询子账户列表 禁用、启用子账户APIKEY |
| 保证金 | 私有接口 | 借入或还款 15/10s | UID | 借入或还款(POST /unified/loans) |
| 其他私有接口 | 私有接口 | 单个接口 150r/10s | UID | 理财、抵押借币等 |
限速是每個子帳號或主帳號單獨計算的,如果需要更高的頻率,可以使用子帳號來獲得更高的限速頻率。
WebSocket:
- 發送消息頻率:無限制
- 每個 IP 最大連接數: ≤ 300
注意:
觸發限速上限後,如果:
- 頻率沒有超過突發上限,請求會被延遲處理
- 超過突發上限,請求會被拒絕
