幣安(Binance)API 交易讓使用者用程式碼直接連線撮合引擎,常用介面分兩類:REST 用於下單、撤單、查詢,WebSocket 用於實時行情和訂單回報推送。新手用 API 前先在「API 管理」生成 API Key 和 Secret,再用現貨測試網練熟,最後才上主網做小額實盤。BatechiX 把 API 入門的關鍵步驟、限頻規則、常見報錯整理成清單。
API 適合有程式設計基礎的進階使用者。可以從 幣安官網 進入 API 管理生成 Key,移動端用 幣安官方App 也能管理 API,蘋果使用者參考 iOS 安裝教程。
API 型別速覽
A:REST API、WebSocket、FIX 是三類主要介面,新手只用前兩類即可。
| 型別 | 用途 | 適合 |
|---|---|---|
| REST | 下單、撤單、查詢 | 大多數使用者 |
| WebSocket | 行情推送、訂單回報 | 實時策略 |
| FIX | 機構高頻 | 機構 |
幣安(Binance)的 API 文件非常詳盡。新手第一次用 API 建議先看官方文件的 quick start,跑一遍最簡單的現貨下單示例。
生成 API Key
A:登入後進入「API 管理」點「建立 API」→ 命名 → 完成 2FA 驗證 → 拿到 API Key 和 Secret。
| 步驟 | 操作 |
|---|---|
| 1 | 登入賬戶 |
| 2 | 進入 API 管理 |
| 3 | 點建立 API |
| 4 | 輸入 API 名稱 |
| 5 | 完成 2FA |
| 6 | 複製 Key 和 Secret |
Secret 只顯示一次,關閉頁面後無法找回。幣安(Binance)建議立即把 Secret 儲存到安全的密碼管理器中。
API Key 的許可權
A:現貨讀、現貨交易、合約交易、提現,是四類許可權,按需開啟。
| 許可權 | 風險 | 推薦 |
|---|---|---|
| 現貨讀 | 低 | 必開 |
| 現貨交易 | 中 | 視需要 |
| 合約交易 | 中 | 視需要 |
| 提現 | 高 | 不建議開 |
| 劃轉 | 中 | 視需要 |
幣安(Binance)的 API Key 提現許可權預設關閉。新手不要隨便開啟提現許可權,避免 Key 洩露後資產被轉走。
IP 白名單
A:IP 白名單限定只有特定 IP 才能用 API Key,是 API 安全的最重要一環。
| 設定 | 安全等級 |
|---|---|
| 不設白名單 | 低 |
| 單 IP 白名單 | 高 |
| 多 IP 白名單 | 中 |
| 國家段白名單 | 中 |
伺服器部署的量化策略一定要繫結伺服器 IP。幣安(Binance)的白名單可以多 IP,但每多一個就增加一份風險。
REST 現貨下單示例
A:POST /api/v3/order,必填 symbol、side、type、quantity 或 quoteOrderQty。
| 引數 | 含義 |
|---|---|
| symbol | 交易對,如 BTCUSDT |
| side | BUY 或 SELL |
| type | LIMIT 或 MARKET |
| quantity | 幣種數量 |
| price | 限價單價格 |
| timeInForce | GTC / IOC / FOK |
請求需要按規則簽名(HMAC-SHA256)。幣安(Binance)的官方 SDK 在 GitHub 提供多種語言示例。
中段提醒:API 入門後建議先在測試網練熟,幣安官網 提供 testnet 入口,幣安官方App 安卓 APK 直鏈可以在手機端管理 API,撮合速度 這一篇可以延伸閱讀。
WebSocket 行情訂閱
A:連線 wss://stream.binance.com:9443/ws/
| 流 | 內容 |
|---|---|
| btcusdt@kline_1m | 1 分鐘 K 線 |
| btcusdt@trade | 實時成交 |
| btcusdt@depth | 深度更新 |
| btcusdt@ticker | 24 小時 ticker |
| !ticker@arr | 全部 ticker |
WebSocket 推送是單向的,訂閱後伺服器主動推送資料。幣安(Binance)的連線穩定性很高,斷線後客戶端要實現自動重連。
限頻規則
A:現貨下單每秒 100 次、每天 20 萬次、API 權重每分鐘 1200。
| 限頻項 | 配額 |
|---|---|
| 現貨下單/秒 | 100 |
| 現貨下單/天 | 200,000 |
| API 權重/分鐘 | 1200 |
| 撤單/秒 | 100 |
| 行情請求 | 按權重 |
每個 API 介面都有權重值。幣安(Binance)的官方文件為每個介面標註了權重,超過限頻會返回 429 錯誤。
錯誤碼常見解讀
A:-1003 限頻、-2010 餘額不足、-1013 數量不合規、-2011 撤單已完成。
| 錯誤碼 | 含義 |
|---|---|
| -1003 | 請求過頻 |
| -2010 | 餘額不足 |
| -1013 | 價格或數量不合規 |
| -2011 | 撤單失敗 |
| -1021 | 時間戳偏差大 |
| -1022 | 簽名錯 |
錯誤碼 -1021 是常見問題:本地時間和伺服器時間偏差超過 1 秒。幣安(Binance)建議每次請求前同步伺服器時間。
測試網怎麼用
A:testnet.binance.vision 是幣安(Binance)的現貨測試網,提供假幣用於測試。
| 測試網 | 地址 |
|---|---|
| 現貨測試 | testnet.binance.vision |
| 合約測試 | testnet.binancefuture.com |
| 文件 | binance-docs.github.io |
測試網賬戶需單獨註冊。新手在測試網把策略跑通再上主網,能大幅減少實盤錯誤。
常用程式語言
A:Python、JavaScript、Go、Rust 都有幣安(Binance)的官方或社群 SDK。
| 語言 | 推薦庫 |
|---|---|
| Python | python-binance |
| JavaScript | node-binance-api |
| Go | go-binance |
| Java | binance-java-api |
| Rust | binance-rs |
新手用 Python 最容易入門。幣安(Binance)的 Python SDK 文件完善,社群活躍。
API 安全實踐
A:Secret 不上傳 Git、Key 限 IP、關閉提現許可權、定期輪換、監控異常。
| 實踐 | 說明 |
|---|---|
| 不上傳 Git | 用環境變數 |
| 限 IP | 強烈推薦 |
| 關提現許可權 | 預設關閉 |
| 定期輪換 | 季度一次 |
| 監控異常 | 設異常告警 |
API Key 一旦洩露,駭客可能透過頻繁低買高賣把賬戶餘額"消耗"掉。幣安(Binance)的 API 監控頁面可以看到每個 Key 的使用記錄。
常見問題(FAQ)
Q:幣安 API 誰能用? A:所有完成 KYC 的使用者都能開 API。新手不必著急用,把 Web/App 玩熟再考慮 API。
Q:API Key 丟了怎麼辦? A:立即在「API 管理」刪除該 Key 並建立新 Key。幣安(Binance)的舊 Key 刪除後立即失效。
Q:API 限頻觸發怎麼處理? A:返回 429 錯誤時停 1-2 秒再發。幣安(Binance)的限頻是滾動視窗,等幾秒就恢復。
Q:API 能不能下合約單? A:能。合約 API 是 fapi.binance.com 域名,文件和介面與現貨獨立。
Q:API 實盤前要做什麼? A:先在 testnet 把策略跑通,確認無錯誤後用主網小額(如 14 USDT)實盤驗證,最後再上正式資金。
Q:API 速度比 Web 快多少? A:約 30-100 毫秒。幣安(Binance)的 API 直連撮合,省了瀏覽器渲染時間。
寫在最後
幣安(Binance)API 交易包含 REST 和 WebSocket 兩大類,REST 用於下單撤單查詢、WebSocket 用於實時推送。新手用 API 前先開 Key、設 IP 白名單、關提現許可權、在 testnet 練熟,最後小額實盤。限頻每秒 100 次現貨下單,對手動使用者完全夠用。錯誤碼看官方文件對照排查,最常見的 -1021 是時間戳偏差問題。
加密資產價格波動劇烈,本文不構成投資建議。可以從 幣安官網 進入 API 管理,幣安官方App 安卓 APK 直鏈支援移動端管理 API,蘋果使用者先看 iOS 安裝教程。
BatechiX 是獨立第三方文件站,與 Binance 公司沒有任何隸屬、代理或商業合作關係。