API接入

幣安API唯讀權限有什麼用?行情查詢與資產對帳用法

幣安API唯讀權限(Enable Reading)可以查詢帳戶餘額、訂單與成交紀錄,但無法下單或提幣。本文說明唯讀金鑰能做什麼、如何建立、怎麼用於行情查詢與資產對帳,並附風險提醒。

幣安 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:資產對帳的做法是先固定一個對帳時間點,再用介面資料與自己的流水逐項核對。 這樣可以避免因為資料即時變動而對不上帳。

以下步驟適合個人與小型團隊參考:

  1. 選定對帳時間點,例如每月最後一天的固定時刻,並記錄當時的時間戳記。
  2. 透過唯讀介面讀取該時刻各幣種的可用與凍結餘額。
  3. 讀取區間內的成交紀錄、儲值紀錄和提幣紀錄。
  4. 用上期期末餘額加本期流入、減去本期流出,計算出理論餘額。
  5. 把理論餘額與介面回傳的實際餘額比對,逐幣種檢查差異。

出現差異時,最常見的原因有手續費以其他幣種扣除(例如使用 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,隨時查看金鑰狀態。

繼續瀏覽

對幣安使用還有疑問?回到分類頁查詢同主題的其它教程。

分類導航

相關教程

幣安API怎麼申請?金鑰簽名一般要怎麼生成 2026-04-14 幣安Spot API怎麼用?從零到第一單的可執行程式碼 2026-04-14 幣安Futures和Spot API有什麼區別?端點引數權重對比 2026-04-14 幣安API會被封IP嗎?限頻策略與權重計算詳解 2026-04-14