如何使用 API

3 小時 51 分 32 秒之前
627,678 閱讀
130

1. 登入 Gate 個人帳戶,點擊右上角 “頭像”—“API管理”。

1

2. 在“API Key 管理”頁面,點擊“創建 API Key”。

1

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 文檔可在網頁端首頁底部“服務”——“開發者中心”獲取。

1

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

注意:
觸發限速上限後,如果:

  • 頻率沒有超過突發上限,請求會被延遲處理
  • 超過突發上限,請求會被拒絕
立即註冊,最高可領 $10,000 迎新獎勵!
signup-tips