適用說明
- 本文適用於：Gate 網頁端
- 操作前準備：已完成 Gate 帳戶註冊與登入
- 預計用時：5 分鐘
操作目標
本文將指引你如何在 Gate 網頁端完成 API Key 的建立與管理。
操作步驟
第一步：進入 API 管理頁面
- 登入 Gate 個人帳戶
- 點擊頁面右上角的「頭像」圖示
- 在下拉選單中選擇「API 管理」
第二步：開始建立 API Key
在「API Key 管理」頁面，點擊「建立 API Key」按鈕。
第三步：選擇並設定 API Key 類型
建立 API v2 Key：
- 設定 IP 位址權限：
- 可選擇綁定特定 IP 位址或不綁定 IP
- 不綁定 IP 將允許任何位址存取，有效期為 90 天
- 選擇 API Key 類型：API v2 Key
- 設定權限：選擇「讀寫」或「只讀」
- 核對資訊無誤後，點擊「提交」
建立 API v4 Key：
- 填寫 API Key 備註：方便辨識與記憶
- 設定 IP 位址權限：可選擇綁定或不綁定 IP（不綁定 IP 有效期為 90 天）
- 選擇 API Key 類型：API v4 Key
- 選擇帳戶類型：經典帳戶／統一帳戶／模擬帳戶
- 設定權限：選擇「讀寫」或「只讀」，並新增交易幣對資訊
- 核對資訊無誤後，點擊「提交」
第四步：確認安全驗證
- 系統會跳出風險提示視窗，請仔細閱讀後勾選「我已知悉」或點擊「取消」
- 輸入資金密碼
- 選擇二次驗證方式並輸入驗證碼
- 點擊「確認」完成建立
第五步：管理已建立的 API Key
建立完成後，可於 API 管理頁面檢視與管理所有已建立的 API Key。
注意事項
-
安全提醒：
- 新建立的 API v2 Key 會立即使舊的 API v2 Key 失效（每個用戶僅能建立 1 組 API v2 Key）
- API Key 可用於查詢帳戶資訊、交易操作及提現操作，請妥善保管，切勿洩漏給他人
-
提現限制：
- 使用 API 進行提現時，必須是已手動提現過一次的地址
- 地址需經過 24 小時後才可透過 API 操作提現
-
IP 綁定建議：
- 建議綁定固定 IP 位址以提升帳戶安全性
- 不綁定 IP 的 API Key 有效期為 90 天
-
API v2 與 API v4 的差異：
| 對比項 | API v2 | API v4 |
|---|---|---|
| API Key 獨立性 | 獨立管理 | 獨立管理 |
| 交易支援 | 僅支援現貨交易 | 支援現貨、槓桿與合約的完整交易操作 |
| 申請入口 | 個人帳戶「API v2 Keys」頁面 | 個人帳戶「API v4 Keys」頁面 |
| 數量限制 | 每個用戶僅能建立 1 組 | 可建立多組 |
- API 限頻規則：
| 市場 | 入口 | 限速 | 依據 | 包含 |
|---|---|---|---|---|
| 公共介面 | 公共介面 | 單一介面 200r/10s | IP | 深度、K 線、交易對資訊等 |
| 錢包 | 私有介面 | 提現介面 1r/3s；uid 轉帳介面 1r/10s；交易帳戶互轉 80r/10s；其他單一介面 200r/10s | UID | 提現、個人帳戶餘額查詢、子帳戶餘額查詢 |
| 現貨 | 私有介面 | 批量／單一下單／修改介面 10r/s；批量／單一撤單介面 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 | 建立子帳戶、查詢子帳戶列表、禁用／啟用子帳戶 API Key |
| 保證金 | 私有介面 | 借入或還款 15r/10s | UID | 借入或還款操作 |
| 其他私有介面 | 私有介面 | 單一介面 150r/10s | UID | 理財、抵押借幣等 |
WebSocket 限制：
- 發送訊息頻率：無限制
- 每個 IP 最大連線數：≤ 300
限速觸發說明：
- 頻率未超過突發上限：請求會被延遲處理
- 超過突發上限：請求會被拒絕
- 子帳戶使用：
- 限速為每個子帳號或主帳號單獨計算
- 若需更高頻率，可使用子帳號以獲得更高的限速頻率
常見問題
Q1：如何獲取 API 文件？
A：可於 Gate 網頁端首頁底部「服務」——「開發者中心」獲取完整的 API 文件。
Q2：若遇到 API 文件中未說明的問題怎麼辦？
A：請聯繫客服並提供以下資訊以便快速定位問題：
- 帳戶 ID
- 原始請求 URL、請求參數與請求具體內容
- 使用的 API Key 類型（現貨／槓桿／合約模擬／合約實盤）
- 程式語言與程式碼片段
- 是否使用 SDK（如有，請說明調用方式或於 GitHub 留言）
Q3：API v2 與 API v4 應該選哪個？
A：建議根據您的交易需求選擇：
- 若僅需現貨交易，可選擇 API v2
- 若需現貨、槓桿與合約的完整交易功能，建議選擇 API v4
- API v4 支援建立多組 Key，更適合多策略運行
免責聲明
本文內容僅供參考與學習用途，不構成任何金融、投資、交易或法律建議，也不構成購買或出售任何數位資產的要約或邀請。Gate 對文中資訊的準確性、完整性或時效性不作任何明示或暗示的保證。產品功能、介面、規則及費率等資訊可能隨時更新或調整，請以 Gate 平台的最新公告及實際頁面展示為準。
數位資產投資涉及高風險，價格可能出現大幅波動，您可能損失全部投入資金。請在充分了解相關風險的基礎上，根據自身財務狀況與風險承受能力謹慎決策。如有需要，建議您諮詢獨立的專業財務或法律顧問。
有關更多風險資訊，請參閱 Gate《風險警示》及《用戶協議》。
免責聲明
本文內容僅供參考與學習目的，不構成任何金融、投資、交易或法律建議，也不構成購買或出售任何虛擬資產的要約或邀請。Gate 對文中資訊的準確性、完整性或時效性不作任何明示或暗示的保證。產品功能、介面、規則及費率等資訊可能隨時更新或調整，請以 Gate 平台的最新公告及實際頁面展示為準。
虛擬資產投資涉及高風險，價格可能出現大幅波動，您可能損失全部投入資金。請在充分了解相關風險的基礎上，根據自身財務狀況和風險承受能力謹慎決策。如有需要，建議您諮詢獨立的專業財務或法律顧問。
有關更多風險資訊，請參閱 Gate《風險警示》及《用戶協議》。
