當你想用交易機器人自動下單、用第三方工具分析持倉、或者自己寫程式呼叫行情資料的時候,都需要用到幣安的API介面。API就像是你交給程式的一把"鑰匙",程式拿著這把鑰匙可以代替你執行特定操作。
還沒有幣安賬號的話,先透過 幣安官網 註冊一個,註冊連結自帶手續費折扣。如果你習慣手機操作,也可以 下載幣安App 完成註冊和後續設定。
什麼是API Key和Secret Key
建立API後,你會得到兩樣東西:
- API Key:相當於你的使用者名稱,用來告訴幣安"我是誰"
- Secret Key:相當於你的密碼,用來驗證請求確實是你發出的
這兩個值配合使用,程式才能透過API與你的幣安賬戶互動。Secret Key只在建立時顯示一次,之後就看不到了,所以務必在建立時立即儲存。
申請API Key的前置條件
在建立API之前,你的賬戶需要滿足:
- 完成身份認證(KYC)
- 開啟雙重驗證(推薦Google Authenticator)
- 賬戶狀態正常,沒有安全限制
如果這些都已經完成,就可以開始建立了。
建立API Key的完整步驟
第一步:找到API管理頁面
登入幣安網頁端,點選右上角的個人頭像,在下拉選單中選擇"API管理"。你也可以直接在頁面頂部的搜尋欄裡搜"API"快速跳轉。
第二步:給API取個名字
進入API管理頁面後,在輸入框中填一個標籤名,比如"量化機器人"或"行情讀取"。這個名字只是方便你自己區分,不影響任何功能。然後點選"建立API"。
第三步:完成安全驗證
系統會要求你完成雙重驗證——通常是郵箱驗證碼加上Google Authenticator驗證碼。按提示操作即可。
第四步:儲存Secret Key
驗證透過後,頁面會同時顯示API Key和Secret Key。這是Secret Key唯一一次完整顯示的機會。立即把它複製並儲存到安全的地方,比如密碼管理器裡。千萬不要截圖發給別人,也不要存在聊天記錄裡。
配置API許可權
建立好API Key之後,接下來最重要的一步是設定許可權。預設情況下,新建立的API Key只有"讀取"許可權。你需要根據實際用途手動開啟其他許可權:
讀取許可權(預設開啟)
可以查詢賬戶餘額、歷史訂單、行情資料等。如果你只是想用第三方工具看持倉分析,只開這個許可權就夠了。
交易許可權
允許透過API下單、撤單、修改訂單。跑量化交易機器人的話必須開啟。開啟後,程式就能在你的賬戶上自動買賣。
提現許可權
允許透過API發起提現操作。除非你非常確定需要,否則強烈建議不要開啟。絕大多數使用場景都不需要這個許可權。一旦API Key洩露,開啟了提現許可權意味著資金可能被轉走。
許可權配置的原則是"最小夠用":程式需要什麼許可權就只開什麼許可權,能不開的就不開。
設定IP白名單
這是很多人忽略但極其重要的一步。IP白名單的意思是:只允許特定IP地址使用這個API Key。
為什麼要設IP白名單?
如果不設白名單,任何人拿到你的API Key和Secret Key,從任何地方都能呼叫你的賬戶。設了白名單之後,即使金鑰洩露,對方因為IP不在白名單裡也無法使用。
怎麼設定:
- 在API詳情頁面找到"IP訪問限制"選項
- 選擇"限制僅受信任的IP訪問"
- 填入你的伺服器IP地址或本地IP地址
- 儲存設定
如果你在本地電腦上執行程式,填寫你的公網IP(可以在搜尋引擎搜"我的IP"檢視)。如果用的是雲伺服器,填寫伺服器的IP。
需要注意的是,如果你的IP是動態的(大多數家庭寬頻都是),每次IP變了都需要回來更新白名單。這種情況下,使用固定IP的雲伺服器會方便很多。
實際接入測試
配置完成後,建議先做一個簡單的測試,確認API能正常工作。
用Python舉個最基本的例子:
from binance.client import Client
api_key = '你的API_Key'
api_secret = '你的Secret_Key'
client = Client(api_key, api_secret)
# 測試連線:獲取賬戶資訊
account = client.get_account()
print(account['balances'][:5]) # 列印前5個幣種餘額
如果返回了賬戶餘額資訊,說明API配置成功。如果報錯,常見原因包括:
- Secret Key複製錯了(多了空格或少了字元)
- IP不在白名單裡
- 許可權沒有正確開啟
- 系統時間不同步(API請求對時間戳有嚴格要求,電腦時間偏差超過幾秒就會失敗)
API使用的安全建議
API的安全性再怎麼強調都不過分。一旦金鑰洩露且許可權設定不當,損失可能是立即且不可逆的。
絕對不要做的事情:
- 不要把API Key和Secret Key寫在公開的程式碼倉庫裡(GitHub上因此丟幣的案例很多)
- 不要在微信、Telegram等聊天工具裡傳送金鑰
- 不要給不信任的第三方工具授權交易和提現許可權
應該做的安全措施:
- 使用環境變數或配置檔案儲存金鑰,不要硬編碼在程式裡
- 定期輪換API Key,刪除不再使用的舊Key
- 設定IP白名單
- 關閉不需要的許可權
- 開啟幣安的API交易風控提醒
常見問題
Q:一個賬戶最多能建立多少個API Key?
普通使用者通常可以建立30個API Key。VIP使用者的限額更高。
Q:API Key有有效期嗎?
預設沒有有效期,除非你手動刪除或者觸發了安全風控。但如果90天內沒有使用過,幣安可能會自動停用。
Q:用API交易手續費跟手動交易一樣嗎?
一樣的,手續費按照你的VIP等級和是否使用BNB抵扣來計算,跟是否透過API下單沒有關係。
API是一個強大的工具,但能力越大責任越大。第一次使用時,建議先用小金額測試,確認一切正常後再放開交易規模。