幣安 API 的唯讀權限(介面顯示為 Enable Reading)只能讀取資料,無法下單、取消委託或提幣,適合用來做行情查詢、資產對帳,以及授權給第三方記帳工具。建立金鑰需要先登入 幣安官網 的帳戶後台,手機端使用者也可以在 幣安官方APP 中查看既有金鑰;iPhone 使用者可參考 iOS安裝教學。要注意的是,唯讀金鑰雖然無法動用資金,卻能看到餘額與歷史成交,因此仍屬敏感資訊,不可隨意交給他人。
唯讀權限到底能做什麼、不能做什麼
A:唯讀權限能查詢帳戶餘額、目前掛單、歷史訂單、成交明細、儲值紀錄和提幣紀錄,無法建立訂單、取消訂單,也無法發起任何提幣。 幣安建立 API 金鑰時,預設只勾選讀取權限,交易、提幣、合約等權限都需要手動額外開啟。
唯讀權限的價值在於把「看資料」和「動資金」徹底分開。使用者把唯讀金鑰交給報表工具、記帳軟體或自建腳本之後,即使金鑰外洩,攻擊者也無法直接轉走資產或在市場上下單,損失範圍僅限於隱私層面。
下表整理了常見權限類型的能力差異,具體名稱與選項以幣安 API 管理頁面目前顯示為準:
| 權限類型 | 能否查詢餘額與紀錄 | 能否下單撤單 | 能否提幣 | 外洩後的主要風險 |
|---|---|---|---|---|
| 僅讀取(Enable Reading) | 可以 | 不可以 | 不可以 | 持倉與交易習慣被看到 |
| 現貨與槓桿交易 | 可以 | 可以 | 不可以 | 被惡意下單造成虧損 |
| 合約交易 | 可以 | 可以(合約帳戶) | 不可以 | 被惡意開倉或爆倉 |
| 允許提幣 | 可以 | 視其他勾選而定 | 可以 | 資產被直接轉走 |
從表中可以看出,唯讀金鑰是四種設定中風險最低的一種。日常只需要查看資料的情境,應優先選擇唯讀,而不是為了方便而勾選全部權限。
公開行情和唯讀金鑰有什麼差別
A:公開行情介面不需要任何金鑰,唯讀金鑰解決的是「查看自己帳戶資料」的問題。 幣安的行情類介面,例如最新價格、K 線、深度、24 小時統計,屬於公開資料,任何人不必登入就能呼叫。
許多新手誤以為查詢行情也必須申請 API 金鑰,其實只需要一個 HTTP 請求。下面的指令可以直接查詢 BTCUSDT 的最新價格:
curl "https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT"
回傳結果是一段 JSON,包含交易對名稱與最新成交價。只有涉及個人帳戶的資料,例如餘額、掛單、成交歷史,才需要帶上 API Key 並對請求簽名。
| 比較項目 | 公開行情介面 | 唯讀金鑰介面 |
|---|---|---|
| 是否需要 API Key | 不需要 | 需要 |
| 是否需要簽名 | 不需要 | 需要(HMAC-SHA256) |
| 可取得的內容 | 價格、K線、深度、成交 | 餘額、訂單、成交、儲值與提幣紀錄 |
| 是否涉及個人隱私 | 否 | 是 |
| 典型用途 | 看盤、行情看板、策略回測 | 資產對帳、記帳、持倉監控 |
唯讀權限的三類典型用法
A:唯讀金鑰最常見的三類用法是資產對帳、持倉監控和第三方工具授權。 這三種情境都不需要動用資金,只需要穩定地讀取帳戶資料。
用法一:資產對帳
資產對帳指的是把幣安帳戶裡的實際餘額,與自己的帳本或記帳試算表逐項核對。透過唯讀介面讀取帳戶資產清單,再與自己記錄的買入、賣出、儲值、提幣流水加總比對,就能發現遺漏的手續費、未記錄的劃轉,或自己漏記的交易。
對帳時通常關注三個數字:可用餘額、凍結餘額和估值。凍結餘額來自尚未成交的掛單,這一點很容易被忽略,導致帳本與介面回傳的資料對不上。
用法二:持倉監控
持倉監控是定時拉取帳戶資產,再與公開行情價格相乘,得到總資產估值。許多個人看板、手機桌面小工具和訊息提醒腳本,都屬於這種用法。
這類腳本只讀取資料,所以使用唯讀金鑰即可。腳本不論執行在個人電腦、樹莓派或雲端伺服器上,都不需要開啟交易權限。
用法三:第三方記帳與稅務工具授權
部分記帳、資產彙整和稅務整理工具,會要求使用者提供唯讀 API 金鑰來同步交易歷史。這類工具本身不需要下單,因此唯讀權限就足夠;如果某個工具要求開啟提幣權限,應立刻停止授權並查證來源。
第一步到第四步:建立一組唯讀 API 金鑰
A:建立唯讀金鑰一般需要四個步驟:登入帳號、進入 API 管理、建立並命名金鑰、儲存 Secret 並確認權限。 幣安網頁端與 APP 端的選單位置可能隨版本調整,請以實際頁面為準。
第一步:登入並準備好驗證
先登入 幣安官網,確認帳號已完成必要的身分認證,並已啟用兩步驟驗證(2FA)。建立 API 金鑰時,幣安通常會要求透過 2FA、電子郵件或手機簡訊驗證碼確認操作。
第二步:進入 API 管理頁面
在帳戶中心找到「API 管理」入口,選擇建立新的 API 金鑰。幣安會讓使用者選擇系統產生的金鑰類型,並為金鑰填寫備註名稱。備註建議寫明用途,例如「唯讀-記帳工具」,方便日後區分。
第三步:核對權限並綁定 IP
建立完成後,金鑰頁面會顯示權限清單。唯讀用途的金鑰應保持「啟用讀取」,並確認交易、提幣等其他權限處於關閉狀態。同時建議填寫 IP 存取限制,只允許自己的伺服器或固定出口位址呼叫。
第四步:儲存 Secret Key
API Key 可以隨時在頁面查看,但 Secret Key 通常只會在建立時完整顯示一次。請立即把 Secret 儲存到密碼管理器或加密檔案中,不要截圖貼到聊天群組,也不要寫進公開的程式碼儲存庫。具體的儲存方案可以參考本站〈幣安API金鑰怎麼安全存〉一文。
用唯讀金鑰查詢帳戶的基本流程
A:帶簽名的唯讀請求由三個部分組成:API Key 放在請求標頭、請求參數中帶時間戳記、簽名附在查詢字串末尾。 簽名是使用 Secret Key 對參數字串進行 HMAC-SHA256 運算得出。
下面是一個 Python 範例,示範如何從環境變數讀取金鑰,再查詢現貨帳戶資訊:
import os, time, hmac, hashlib, requests
API_KEY = os.environ["BINANCE_API_KEY"]
API_SECRET = os.environ["BINANCE_API_SECRET"]
query = f"timestamp={int(time.time() * 1000)}"
signature = hmac.new(API_SECRET.encode(), query.encode(), hashlib.sha256).hexdigest()
resp = requests.get(
f"https://api.binance.com/api/v3/account?{query}&signature={signature}",
headers={"X-MBX-APIKEY": API_KEY},
)
for item in resp.json()["balances"]:
if float(item["free"]) > 0 or float(item["locked"]) > 0:
print(item["asset"], item["free"], item["locked"])
程式碼只輸出非零餘額。如果請求回傳 401 或權限錯誤,應先檢查金鑰是否勾選了讀取權限,以及呼叫的 IP 是否在白名單內。其餘簽名細節可以閱讀本站〈幣安API簽名怎麼產生〉一文。
常見的唯讀類介面包括:帳戶資訊、目前掛單、歷史訂單、帳戶成交紀錄、儲值歷史和提幣歷史。具體路徑與參數以幣安官方 API 文件為準。
資產對帳的實際做法
A:資產對帳的做法是先固定一個對帳時間點,再用介面資料與自己的流水逐項核對。 這樣可以避免因為資料即時變動而對不上帳。
以下步驟適合個人與小型團隊參考:
- 選定對帳時間點,例如每月最後一天的固定時刻,並記錄當時的時間戳記。
- 透過唯讀介面讀取該時刻各幣種的可用與凍結餘額。
- 讀取區間內的成交紀錄、儲值紀錄和提幣紀錄。
- 用上期期末餘額加本期流入、減去本期流出,計算出理論餘額。
- 把理論餘額與介面回傳的實際餘額比對,逐幣種檢查差異。
出現差異時,最常見的原因有手續費以其他幣種扣除(例如使用 BNB 抵扣)、小額資產轉換、活動獎勵入帳,以及不同帳戶(現貨、資金、合約)之間的劃轉漏記。排查時應依幣種逐項查,不要一次合併比較。
| 差異來源 | 典型表現 | 排查方法 |
|---|---|---|
| 手續費扣除 | 餘額略少於預期 | 查看成交紀錄中的手續費幣種 |
| 帳戶間劃轉 | 現貨餘額突然變化 | 對照劃轉歷史 |
| 活動獎勵與空投 | 餘額多出一筆 | 查看資金流水與公告 |
| 凍結餘額 | 可用餘額偏少 | 查詢目前掛單 |
| 小額資產兌換 | 多個小幣種消失 | 核對兌換紀錄 |
使用唯讀金鑰的風險與安全提醒
A:唯讀金鑰不會讓資金被轉走,但會暴露持倉與交易行為,所以仍然需要當作敏感憑證來保管。 持倉資訊一旦被他人取得,可能成為社交工程攻擊與釣魚詐騙的素材。
以下是幾條基本的安全規則:
- 唯讀用途的金鑰不要勾選交易、合約和提幣權限,權限越少越安全。
- 為金鑰設定 IP 存取限制,只允許自己的固定位址呼叫。
- 每個工具或腳本使用獨立的金鑰,方便單獨撤銷。
- 不要把金鑰交給自稱客服或「代操」的任何人,幣安官方不會索取 Secret Key。
- 發現異常呼叫或不再使用某工具時,立即在 API 管理頁面刪除對應金鑰。
- 第三方工具要求提幣權限時,應視為高風險訊號,拒絕授權。
同時需要提醒:本站是獨立的第三方教學站,不是幣安官方網站。API 的權限名稱、頁面入口和限制規則,以幣安官方頁面與文件目前顯示為準。加密資產價格波動劇烈,投資有風險;中國大陸使用者使用相關服務時,請自行了解並遵守當地法律法規。
常見問題
Q:幣安API唯讀權限會不會被人拿去提幣? A:不會。唯讀權限不包含提幣能力,提幣需要另外開啟「允許提幣」權限。但唯讀金鑰外洩後,持倉與成交紀錄會被看到,仍應及時刪除並重新建立。
Q:只查看行情需要申請API金鑰嗎? A:不需要。最新價、K 線、深度等公開行情介面不需要金鑰與簽名,直接送出 HTTP 請求即可取得。
Q:唯讀金鑰可以不設定IP白名單嗎? A:可以不設定,但不建議。設定 IP 限制後,即使金鑰外洩,其他位址也無法使用。使用浮動 IP 的使用者,可以透過固定出口的雲端伺服器轉送請求。
Q:唯讀金鑰能看到合約帳戶的資料嗎? A:合約帳戶通常需要在金鑰權限中額外啟用合約相關選項,才能透過介面讀取合約資料。具體選項以幣安 API 管理頁面顯示為準。
Q:第三方記帳工具要求我提供唯讀金鑰,安全嗎? A:從權限上看,唯讀相對安全,但仍要確認工具來源可信、有明確的隱私說明,並為其單獨建立金鑰,不使用時及時刪除。
Q:唯讀介面呼叫時回傳權限錯誤怎麼辦? A:先確認金鑰勾選了讀取權限,再檢查呼叫的 IP 是否在白名單內、系統時間與幣安伺服器時間是否偏差過大,最後核對簽名是否正確。
Q:唯讀金鑰需要定期更換嗎? A:建議定期輪換,並在人員異動、工具停用或懷疑外洩時立即更換。輪換週期沒有統一標準,依自己的風險承受能力安排即可。
如果還沒有幣安帳號,可以先透過 幣安官網 完成註冊與認證,再依本文步驟建立唯讀金鑰;手機端可安裝 幣安官方APP,隨時查看金鑰狀態。