費鑑gaterar.com
简繁
量化與 API · 約 6 分鐘讀完

幣安 API 怎麼申請?API Key 建立步驟與許可權設定

幣安 API Key 在賬戶的 API 管理頁面建立,需先開啟雙重驗證,生成 API Key 與 Secret Key 兩串字元。許可權分讀取、現貨及槓桿交易、合約交易、提現,開提現前必須先繫結 IP。只看行情與資金費率完全不需要 API Key。

本文要點

  1. 幣安 API Key 在登入後的 API 管理頁面建立,建立前必須開啟雙重驗證(2FA),系統會生成 API Key 與 Secret Key 兩串字元。
  2. API Key 相當於賬號,Secret Key 相當於密碼,Secret Key 一旦外洩,別人就能以你的名義呼叫許可權內的所有功能。
  3. 幣安 API 許可權分讀取、現貨及槓桿交易、合約交易與提現,只需要開程式真正用到的那幾項,提現許可權必須先設定 IP 限制才能開啟。
  4. 只查行情、標記價格與資金費率不需要申請 API Key,幣安的公開介面直接就能呼叫。

幣安 API Key 在登入後的 API 管理 頁面建立:開啟雙重驗證(2FA)後,給 Key 取個名字、完成安全驗證,系統就會生成 API Key 與 Secret Key 兩串字元。許可權建議從只開“讀取”開始,程式需要下單再加開現貨或合約交易,提現許可權不要開。

如果你只是想用程式查行情或資金費率,其實不需要申請任何 Key,直接呼叫公開介面即可,見 用 API 獲取資金費率。

申請幣安 API 需要什麼條件?

建立 API Key 本身不收費,但交易所會要求賬戶先達到一定的安全條件,常見的有:

  1. 開啟雙重驗證(2FA):例如身份驗證器 App 或其他驗證方式,這是建立 Key 的必要條件。
  2. 完成身份認證:一般賬戶需要先完成身份認證才能使用 API,具體要求以頁面提示為準。
  3. 開通對應的賬戶:想讓程式下 U 本位合約單,賬戶需要先開通合約功能,否則無法勾選合約交易許可權。
  4. 所在地區可以使用服務:幣安的服務範圍因地區而異。部分受限地區的 IP 訪問幣安介面會被拒絕(例如從美國 IP 呼叫合約介面可能收到 HTTP 451),這和 Key 是否設定正確無關。

賬戶還在使用中的風控限制、子賬戶等特殊情況,能否建立 Key 以交易所頁面顯示為準。

幣安 API Key 在哪裡建立?步驟是什麼?

各版本網頁與 App 的選單位置會調整,下面是通用的流程,按鈕名稱以頁面顯示為準:

  1. 登入幣安網頁版,在右上角的賬戶或個人中心選單裡找到 API 管理。
  2. 點選建立 API,選擇金鑰類型。一般使用者選系統生成的類型即可;如果你的程式要求使用自己生成的公私鑰,再按開發者文件選擇對應類型。
  3. 為這個 Key 填一個備註名,例如“行情記錄指令碼”或“網格測試”,方便以後辨認與刪除。
  4. 完成郵箱、手機或身份驗證器的安全驗證。
  5. 頁面顯示 API Key 與 Secret Key。Secret Key 通常只在這一刻完整顯示,離開頁面後就無法再看,務必立即儲存到安全的地方。
  6. 進入編輯頁面,設定許可權與 IP 訪問限制,儲存後才會生效。

建議一個用途建立一個 Key,不要所有程式共用同一個。這樣某個程式出問題時,只要刪除它對應的 Key,其他程式不受影響。如果要同時執行多套策略,也可以用子賬戶把資金分開,每個子賬戶各自建立 Key,某個 Key 出問題時,影響只限於該子賬戶裡的資產。子賬戶的開通條件以幣安頁面為準。

API Key 和 Secret Key 有什麼區別?

兩串字元的角色完全不同:

專案 作用 可以給別人看嗎 遺失或外洩怎麼辦
API Key 標識“這是哪個 Key”,請求時放在請求頭裡 儘量不要,但外洩本身風險較小 若和 Secret Key 一起外洩,立即刪除
Secret Key 用來對請求籤名,證明請求確實由你發出 絕對不行 立即刪除該 Key,重新建立

可以把 API Key 想成賬號、Secret Key 想成密碼。程式每次呼叫私有介面時,會用 Secret Key 對請求內容計算簽名,交易所核對簽名後才執行。所以 任何人拿到 Secret Key,就能以你的名義執行這個 Key 許可權內的所有操作。不要把它截圖、發在聊天群、貼進公開程式碼倉庫,也不要交給聲稱“幫你除錯”的陌生人。更完整的儲存方式見 交易所 API 安全。

幣安 API 許可權怎麼選?

幣安的 Key 可以勾選多種許可權,常見的幾項如下:

許可權 能做什麼 適合的用途 建議
讀取 查詢資產、訂單、成交記錄 記賬、盈虧統計、持倉監控 預設開啟,風險最低
現貨及槓桿交易 下單、撤單(現貨與槓桿) 現貨網格、定投程式 程式要下現貨單才開
合約交易 合約下單、撤單、調整槓桿 合約策略、資金費率套利 程式要下合約單才開
提現 把資產提到外部地址 極少數自建資金排程 不建議開啟

選擇原則是“最小許可權”:程式只需要統計盈虧,就只開讀取;只做現貨網格,就不要順手開合約交易。許可權越少,Key 外洩時的損失上限越低。

幣安要求 必須先設定 IP 訪問限制,才能開啟提現許可權。即使是自己寫的程式,資金排程也可以手動處理,沒有必要讓 Key 具備提幣能力。交給任何第三方工具的 Key,更是一律不開提現。

幣安 API 一定要繫結 IP 嗎?

不繫結也能使用讀取與交易許可權,但強烈建議繫結。繫結 IP 後,只有來自白名單地址的請求會被接受,即使 Secret Key 外洩,攻擊者也無法從其他地方呼叫。

繫結的前提是程式執行在 固定 IP 的機器上,例如租用的雲伺服器。家用寬頻的 IP 往往會變動,繫結後可能某天突然連不上。未限制 IP 的 Key 在許可權或有效期方面可能有額外規則,以幣安的官方說明為準。

用 API 下單手續費會更貴嗎?

不會。API 下單與網頁、App 手動下單使用同一套費率,按賬戶的 VIP 等級與掛單、吃單計算。一般使用者 U 本位合約掛單 0.02%、吃單 0.05%,現貨掛單與吃單都是 0.1%。

舉例:程式用市價單(吃單)開一筆 10,000 USDT 的合約倉位,手續費是 10,000 × 0.05% = 5 USDT;改用限價掛單成交是 10,000 × 0.02% = 2 USDT。程式交易次數通常比手動多,掛單與吃單的差距會累積得很快,見 API 交易手續費與限頻 與 幣安手續費指南。

建立後怎麼測試?出錯怎麼排查?

建議先只開讀取許可權,用程式查詢一次賬戶餘額,確認簽名與連線都正常後,再按需要加開交易許可權。常見的出錯原因:

  1. IP 不在白名單:程式所在機器的出口 IP 和設定的不同,請求會被拒絕。
  2. 時間不同步:簽名請求帶有時間戳,本機時間偏差太大時會被拒絕,開啟系統自動校時即可。
  3. 許可權不足:例如只開了現貨交易,卻呼叫合約下單介面。
  4. 簽名錯誤:參數順序、編碼或 Secret Key 複製時多了空格,都會導致簽名對不上。

具體錯誤程式碼與含義以幣安開發者文件為準。不再使用的 Key 要及時刪除,換機器或換程式時也建議直接建立新 Key,而不是修改舊 Key 繼續沿用。

想了解歐易的做法,見 歐易 API 怎麼申請;還沒有賬戶的話,註冊入口見文末或 邀請碼頁。

開戶

在幣安、歐易開戶

幣安 Binance

邀請碼 BN6691

註冊幣安
歐易 OKX

邀請碼 OK6667

註冊歐易

註冊前請確認你所在地區可以合法使用該交易所。

參考資料

  1. 幣安開發者文件|標記價格與資金費率(Mark Price)
  2. 幣安|交易手續費率(Fee Schedule)

常見問題

幣安 API Key 在哪裡?

登入幣安後,在賬戶或個人中心選單裡找到 API 管理頁面即可建立與檢視,入口名稱以頁面顯示為準。Secret Key 通常只在建立時完整顯示一次,要當場妥善儲存。

幣安 API 許可權怎麼選?

只看資產與訂單開讀取即可;程式要下現貨單再開現貨及槓桿交易,要下合約單再開合約交易。提現許可權一般不要開,幣安也要求先設定 IP 限制才能開啟。

幣安 API 申請要錢嗎?

不要錢,建立 API Key 本身免費。通過 API 下單和手動下單一樣按 VIP 等級與掛單、吃單收手續費,U 本位合約一般使用者是掛單 0.02%、吃單 0.05%。

查資金費率需要申請幣安 API 嗎?

不需要。標記價格、資金費率與歷史結算記錄都是公開介面,不帶 API Key 也能呼叫。只有查詢自己的資產、訂單或下單時才需要 API Key 與簽名。

看到不懂的名詞?查 合約術語表。

→延伸閱讀
  1. 01量化 API交易所 API 安全嗎?提幣許可權、IP 白名單與被盜處理API Key 的風險來自 Secret Key 外洩:只讀許可權最多洩露資產資訊,交易許可權可被人用冷門幣對倒轉走資金,提幣許可權則能直接提走資產。不開提幣、繫結 IP 白名單、最小許可權是三條底線。附被盜後的處理步驟與第三方平臺的風險判斷。
  2. 02量化 APIAPI 交易手續費一樣嗎?限頻規則與量化下單成本怎麼算API 下單與手動下單手續費相同:幣安與歐易永續合約一般使用者掛單 0.02%、吃單 0.05%,現貨幣安 0.1%、歐易掛單 0.08%。量化成本主要來自高頻成交,每天 20 筆 2,000 USDT 吃單一個月約 600 USDT。附網格打平間距與限頻說明。
  3. 03量化 API資金費率 API 怎麼用?幣安、歐易公開介面與示例程式碼資金費率用公開介面就能獲取,不需要 API Key:幣安用 premiumIndex 與 fundingRate,歐易用 funding-rate 與 funding-rate-history。返回值是小數,0.0001 即 0.01%,附換算年化的 Python 與 JavaScript 示例。
  4. 04量化 API歐易 API 怎麼申請?API Key、金鑰與 Passphrase 設定歐易 API Key 由 API Key、Secret Key 與 Passphrase 三部分組成,Passphrase 是建立時自己設定的密碼,三者缺一不可。許可權分讀取、交易、提幣,支援 IP 白名單,建立前需開啟雙重驗證。附與幣安 API 的差異對照。