交易操作

幣安 API 交易基礎是什麼

幣安(Binance)API 交易讓使用者用程式碼直接呼叫現貨合約介面,包含 REST 和 WebSocket 兩類。BatechiX 把 API 入門要點拆開講。

幣安(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 公司沒有任何隸屬、代理或商業合作關係。