幣安 API 怎麼申請?API Key 建立步驟與許可權設定
幣安 API Key 在賬戶的 API 管理頁面建立,需先開啟雙重驗證,生成 API Key 與 Secret Key 兩串字元。許可權分讀取、現貨及槓桿交易、合約交易、提現,開提現前必須先繫結 IP。只看行情與資金費率完全不需要 API Key。
本文要點
- 幣安 API Key 在登入後的 API 管理頁面建立,建立前必須開啟雙重驗證(2FA),系統會生成 API Key 與 Secret Key 兩串字元。
- API Key 相當於賬號,Secret Key 相當於密碼,Secret Key 一旦外洩,別人就能以你的名義呼叫許可權內的所有功能。
- 幣安 API 許可權分讀取、現貨及槓桿交易、合約交易與提現,只需要開程式真正用到的那幾項,提現許可權必須先設定 IP 限制才能開啟。
- 只查行情、標記價格與資金費率不需要申請 API Key,幣安的公開介面直接就能呼叫。
幣安 API Key 在登入後的 API 管理 頁面建立:開啟雙重驗證(2FA)後,給 Key 取個名字、完成安全驗證,系統就會生成 API Key 與 Secret Key 兩串字元。許可權建議從只開“讀取”開始,程式需要下單再加開現貨或合約交易,提現許可權不要開。
如果你只是想用程式查行情或資金費率,其實不需要申請任何 Key,直接呼叫公開介面即可,見 用 API 獲取資金費率。
申請幣安 API 需要什麼條件?
建立 API Key 本身不收費,但交易所會要求賬戶先達到一定的安全條件,常見的有:
- 開啟雙重驗證(2FA):例如身份驗證器 App 或其他驗證方式,這是建立 Key 的必要條件。
- 完成身份認證:一般賬戶需要先完成身份認證才能使用 API,具體要求以頁面提示為準。
- 開通對應的賬戶:想讓程式下 U 本位合約單,賬戶需要先開通合約功能,否則無法勾選合約交易許可權。
- 所在地區可以使用服務:幣安的服務範圍因地區而異。部分受限地區的 IP 訪問幣安介面會被拒絕(例如從美國 IP 呼叫合約介面可能收到 HTTP 451),這和 Key 是否設定正確無關。
賬戶還在使用中的風控限制、子賬戶等特殊情況,能否建立 Key 以交易所頁面顯示為準。
幣安 API Key 在哪裡建立?步驟是什麼?
各版本網頁與 App 的選單位置會調整,下面是通用的流程,按鈕名稱以頁面顯示為準:
- 登入幣安網頁版,在右上角的賬戶或個人中心選單裡找到 API 管理。
- 點選建立 API,選擇金鑰類型。一般使用者選系統生成的類型即可;如果你的程式要求使用自己生成的公私鑰,再按開發者文件選擇對應類型。
- 為這個 Key 填一個備註名,例如“行情記錄指令碼”或“網格測試”,方便以後辨認與刪除。
- 完成郵箱、手機或身份驗證器的安全驗證。
- 頁面顯示 API Key 與 Secret Key。Secret Key 通常只在這一刻完整顯示,離開頁面後就無法再看,務必立即儲存到安全的地方。
- 進入編輯頁面,設定許可權與 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 交易手續費與限頻 與 幣安手續費指南。
建立後怎麼測試?出錯怎麼排查?
建議先只開讀取許可權,用程式查詢一次賬戶餘額,確認簽名與連線都正常後,再按需要加開交易許可權。常見的出錯原因:
- IP 不在白名單:程式所在機器的出口 IP 和設定的不同,請求會被拒絕。
- 時間不同步:簽名請求帶有時間戳,本機時間偏差太大時會被拒絕,開啟系統自動校時即可。
- 許可權不足:例如只開了現貨交易,卻呼叫合約下單介面。
- 簽名錯誤:參數順序、編碼或 Secret Key 複製時多了空格,都會導致簽名對不上。
具體錯誤程式碼與含義以幣安開發者文件為準。不再使用的 Key 要及時刪除,換機器或換程式時也建議直接建立新 Key,而不是修改舊 Key 繼續沿用。
想了解歐易的做法,見 歐易 API 怎麼申請;還沒有賬戶的話,註冊入口見文末或 邀請碼頁。
開戶
在幣安、歐易開戶
註冊前請確認你所在地區可以合法使用該交易所。
參考資料
常見問題
幣安 API Key 在哪裡?
登入幣安後,在賬戶或個人中心選單裡找到 API 管理頁面即可建立與檢視,入口名稱以頁面顯示為準。Secret Key 通常只在建立時完整顯示一次,要當場妥善儲存。
幣安 API 許可權怎麼選?
只看資產與訂單開讀取即可;程式要下現貨單再開現貨及槓桿交易,要下合約單再開合約交易。提現許可權一般不要開,幣安也要求先設定 IP 限制才能開啟。
幣安 API 申請要錢嗎?
不要錢,建立 API Key 本身免費。通過 API 下單和手動下單一樣按 VIP 等級與掛單、吃單收手續費,U 本位合約一般使用者是掛單 0.02%、吃單 0.05%。
查資金費率需要申請幣安 API 嗎?
不需要。標記價格、資金費率與歷史結算記錄都是公開介面,不帶 API Key 也能呼叫。只有查詢自己的資產、訂單或下單時才需要 API Key 與簽名。
看到不懂的名詞?查 合約術語表。
- 01量化 API交易所 API 安全嗎?提幣許可權、IP 白名單與被盜處理API Key 的風險來自 Secret Key 外洩:只讀許可權最多洩露資產資訊,交易許可權可被人用冷門幣對倒轉走資金,提幣許可權則能直接提走資產。不開提幣、繫結 IP 白名單、最小許可權是三條底線。附被盜後的處理步驟與第三方平臺的風險判斷。
- 02量化 APIAPI 交易手續費一樣嗎?限頻規則與量化下單成本怎麼算API 下單與手動下單手續費相同:幣安與歐易永續合約一般使用者掛單 0.02%、吃單 0.05%,現貨幣安 0.1%、歐易掛單 0.08%。量化成本主要來自高頻成交,每天 20 筆 2,000 USDT 吃單一個月約 600 USDT。附網格打平間距與限頻說明。
- 03量化 API資金費率 API 怎麼用?幣安、歐易公開介面與示例程式碼資金費率用公開介面就能獲取,不需要 API Key:幣安用 premiumIndex 與 fundingRate,歐易用 funding-rate 與 funding-rate-history。返回值是小數,0.0001 即 0.01%,附換算年化的 Python 與 JavaScript 示例。
- 04量化 API歐易 API 怎麼申請?API Key、金鑰與 Passphrase 設定歐易 API Key 由 API Key、Secret Key 與 Passphrase 三部分組成,Passphrase 是建立時自己設定的密碼,三者缺一不可。許可權分讀取、交易、提幣,支援 IP 白名單,建立前需開啟雙重驗證。附與幣安 API 的差異對照。