API金鑰是什麼，能用來做什麼
API（Application Programming Interface）金鑰是你的幣安賬戶與外部程式之間的橋樑。透過API金鑰，第三方軟體、量化交易機器人或你自己編寫的程式可以代替你在幣安上執行查詢資料、下單交易、獲取行情等操作，而不需要你手動登入網頁或App。
API金鑰的常見應用場景包括：量化交易，使用交易機器人自動執行策略；資料分析，獲取實時行情和歷史K線資料進行研究；投資組合管理，使用第三方工具彙總多個交易所的持倉資訊；稅務記錄，透過API自動匯出交易記錄供稅務軟體使用。
每個API金鑰由兩部分組成：API Key（公鑰）和Secret Key（私鑰）。API Key用於標識你的身份，Secret Key用於對請求進行簽名以證明請求的真實性。兩者必須配合使用，缺一不可。
理解API金鑰的重要性在於認識到它相當於你賬戶的一把"可程式設計鑰匙"。使用API功能前，請確保你已透過 幣安官方 註冊並完成了KYC認證。根據你賦予它的許可權，持有這把鑰匙的程式可以讀取你的資料甚至操控你的資金。因此建立和管理API金鑰必須格外謹慎。
建立API金鑰的詳細步驟
建立API金鑰的操作需要在幣安網頁端完成，步驟如下：
第一步，登入幣安官網，點選右上角的使用者圖示，在下拉選單中找到"API管理"選項並點選進入。
第二步，在API管理頁面，你會看到一個輸入框，用於為新API金鑰設定標籤名稱。標籤名稱是為了方便你區分不同用途的API金鑰，比如你可以命名為"量化策略A"、"行情監控"等。輸入標籤名稱後，點選"建立API"按鈕。
第三步，系統會要求你完成安全驗證。根據你賬戶的安全設定，可能需要輸入郵箱驗證碼、谷歌驗證碼或手機簡訊驗證碼。部分情況下需要同時完成多項驗證。
第四步，驗證透過後，系統會顯示你新建立的API Key和Secret Key。這裡非常關鍵——Secret Key只會顯示這一次，頁面關閉後就再也看不到了。你必須在這個時候把Secret Key複製並安全儲存下來。如果忘記儲存，唯一的辦法是刪除這個API金鑰並建立一個新的。
第五步，建立完成後，API金鑰預設只有"讀取"許可權，沒有交易和提幣許可權。你需要根據實際需求在下一步配置合適的許可權。
許可權配置的最佳實踐
幣安API金鑰的許可權分為幾個主要類別，合理配置許可權是保證安全的核心。
讀取許可權（Enable Reading）允許API查詢你的賬戶餘額、交易歷史、訂單資訊和行情資料。這是最基礎的許可權，幾乎所有的API使用場景都需要開啟。
現貨和槓桿交易許可權（Enable Spot & Margin Trading）允許API在現貨和槓桿市場上下單、撤單。如果你的程式需要自動執行交易操作，需要開啟這個許可權。
合約交易許可權允許API在期貨合約市場上操作。與現貨許可權分開設定，只有需要自動化合約交易時才開啟。
提幣許可權（Enable Withdrawals）允許API發起提幣請求。這是風險最高的許可權，開啟後意味著持有這個API金鑰的程式可以將你的資金轉出交易所。除非你有非常明確和必要的自動化提幣需求，否則強烈建議永遠不要開啟這個許可權。
最小許可權原則是配置API許可權的黃金法則。只給API金鑰分配它實際需要的最小許可權集合。如果你只是用來獲取行情資料，那就只開讀取許可權；如果需要自動交易，就開讀取加交易許可權；提幣許可權能不開就不開。
IP白名單限制
除了許可權配置之外，IP白名單是另一個重要的安全保障。
在API金鑰的設定頁面，你可以指定允許使用這個API金鑰的IP地址。設定後，只有來自白名單IP地址的請求才會被接受，來自其他IP的請求即使攜帶了正確的API金鑰也會被拒絕。
如果你的量化程式執行在一臺固定IP的伺服器上（比如雲伺服器），強烈建議將伺服器的出口IP新增到白名單中。這樣即使API金鑰洩露，攻擊者也無法從其他IP地址使用它。
新增IP白名單的操作很簡單：在API金鑰詳情頁面，找到"IP限制"選項，選擇"限制僅允許受信任的IP訪問"，然後輸入允許的IP地址。可以新增多個IP。
如果你不確定自己的程式執行在什麼IP上，或者IP是動態變化的（比如家用寬頻），可以暫時不設定IP限制。但這意味著API金鑰的安全性完全依賴於金鑰本身不被洩露，風險相對較高。
一個折中的方案是：如果IP是動態的，可以在你的程式每次啟動時先檢查當前IP，然後透過API更新IP白名單。不過這需要一定的程式設計能力來實現。
API金鑰的安全管理
API金鑰的日常管理同樣重要，以下是幾條關鍵的安全準則。
Secret Key的儲存方式直接決定了安全級別。不要把Secret Key硬編碼在程式原始碼中，特別是如果程式碼會上傳到GitHub等公開倉庫。正確的做法是將Secret Key儲存在環境變數、加密的配置檔案或專門的金鑰管理服務中。
定期輪換API金鑰是一個好習慣。即使沒有發生安全事件，也建議每隔一段時間（比如每幾個月）刪除舊的API金鑰並建立新的。這樣即使舊金鑰在某個環節被洩露了，它的有效期也是有限的。
監控API金鑰的使用情況。透過 幣安官方 下載的APP也可以檢視API呼叫記錄，你可以定期檢查API的呼叫頻率和來源IP。如果發現異常的呼叫模式，比如在你的程式沒有執行時出現了API呼叫，應該立即禁用該金鑰並檢查安全狀況。
不要在多個場景中共用同一個API金鑰。為不同的用途建立不同的API金鑰，比如一個用於量化交易，一個用於資料查詢，一個用於投資組合管理工具。這樣某個金鑰出現問題時，不會影響其他用途，也方便快速定位和處理。
如果你不再使用某個API金鑰，及時刪除它。留著不用的API金鑰不會帶來任何好處，只會增加被濫用的風險。
常見問題和故障排查
使用API過程中經常會遇到一些技術問題，以下是常見問題的排查思路。
請求返回許可權錯誤（Permission Denied）。首先檢查API金鑰是否開啟了相應的許可權。比如你在嘗試下單但只開啟了讀取許可權，就會收到許可權錯誤。其次檢查IP白名單是否包含了你的請求來源IP。
請求頻率超限（Rate Limit）。幣安對API呼叫有頻率限制，超過限制後會臨時遮蔽請求。不同型別的介面有不同的限制規則，比如下單介面的限制比行情查詢介面更嚴格。解決方法是在程式中新增請求間隔控制，避免短時間內傳送過多請求。響應頭中通常會返回當前的限制狀態和剩餘配額資訊。
時間戳錯誤（Timestamp Error）。幣安的簽名認證機制要求請求中的時間戳和伺服器時間的偏差不能超過一定範圍（通常是幾秒）。如果你的程式執行環境的系統時間不準確，就會出現這個錯誤。確保系統時間與NTP伺服器同步可以解決這個問題。
簽名驗證失敗（Signature Error）。這通常是Secret Key不正確或簽名計算方式有誤導致的。檢查Secret Key是否完整複製（沒有多餘的空格或缺少字元），確認簽名演算法使用的是HMAC-SHA256，引數的排序和編碼方式符合文件要求。