交易所 API 連接教學

在交易所建一把唯讀 API 金鑰貼到 Blave，就能在同一頁看到你在各交易所的淨值與持倉。Blave 用它無法下單或提領。

交易所 API 連接，是把你在交易所建立的唯讀 API 金鑰交給 Blave，讓 Studio 讀取你的餘額與持倉。目前支援 Binance、OKX、BingX、Bitget、Bitunix、Bybit 六家。金鑰只需要讀取權限，Blave 拿到後無法下單，也無法提領。在交易所建好金鑰，到 Blave API 頁貼上就完成。

連上之後能看到什麼？

• 投資組合頁：把所有已連接的交易所合在一起，顯示帳戶淨值走勢、投資表現、配置比例，以及每個幣種在哪個交易所、哪個錢包的餘額與曝險。
• Studio 圖表的選幣視窗多一個「投資組合」分頁，列出你目前持有的幣種，切換圖表時不用再搜尋。
• Blave 讀取的帳戶：Binance 的現貨、U 本位合約與活期理財；OKX 的交易帳戶；BingX 的現貨與永續合約；Bitget 經典帳戶的現貨與合約；Bitunix 的現貨與合約；Bybit 的統一交易帳戶。六家都不讀資金帳戶（Funding），放在資金帳戶的幣不會出現在投資組合頁。

把 API 金鑰交給 Blave 安全嗎？

• 只開讀取權限。權限是交易所綁在金鑰上的：一把只有讀取權限的金鑰，拿到的人只能查看帳戶，不能下單、劃轉或提領。
• Blave 會定期用這把金鑰讀取你的餘額與持倉，產生投資組合頁的資料。
• 連接視窗附有 API 連接政策：Blave 會以匿名化方式收集與分析連接帳戶的資料，用來改善產品。不想再被讀取時，照刪除步驟移除金鑰。

怎麼在各交易所建立唯讀 API 金鑰？

六家的流程大同小異：到帳戶的 API 管理頁建立新金鑰、只給讀取權限、完成安全驗證、複製金鑰。兩條規則每家都適用：

• IP 白名單留空。綁了你自己的 IP，Blave 的伺服器就不在名單內，會讀不到資料。
• 只開讀取。交易、劃轉、提領權限一律不開。

Binance｜OKX｜BingX｜Bitget｜Bitunix｜Bybit

以下按鈕與欄位名稱照交易所英文網頁版；介面切換成其他語言或改版後，名稱可能不同。

Binance

建立金鑰前，Binance 要求帳戶已開啟 2FA、現貨錢包入金過任意金額、完成身分驗證。金鑰要用系統產生（HMAC），自行產生的 RSA／Ed25519 金鑰連不上。Blave 連接時會檢查 U 本位合約帳戶，還沒開通合約的帳戶會連不上。

1. 登入 Binance 網頁版，點右上角頭像 →「Account」→「API Management」，按「Create API」。App 版在「More」→「Other」→「API Management」。
2. 金鑰類型選「System-generated」，標籤填 Blave，完成 2FA 驗證。
3. 確認權限只有「Enable Reading」（預設就是），其他權限不要勾，也不要設定 IP 限制。
4. 複製 API Key 與 Secret Key。

Binance 官方說明

OKX

1. 登入 OKX 網頁版，到「Profile」→「API and connections」，按「Create API key」。
2. 填 API key 名稱（例如 Blave），「Account」選你要讓 Blave 讀取的帳戶。
3. 「Permissions」只勾「Read」，IP 位址白名單留空。
4. 設定 Passphrase 並記下來。OKX 建立後不會再顯示，忘了只能刪掉重建；在 Blave 連接時要填。
5. 完成安全驗證，複製 API Key 與 Secret Key。

OKX 官方說明

BingX

Blave 連接時會檢查永續合約帳戶，還沒開通合約的帳戶會連不上。

1. 登入 BingX 網頁版，到個人中心的「API Management」，按「Create API」。
2. 填一個好辨識的名稱（例如 Blave），完成安全驗證。
3. 權限只留讀取，現貨交易、合約交易、萬向劃轉、子帳戶管理、提領都不要開，IP 留空。BingX 只有讀取權限的金鑰不會因為閒置被刪除。
4. 複製 API Key 與 Secret Key。

前往 BingX API 管理頁

Bitget

目前只支援經典帳戶。統一交易帳戶（UTA）的金鑰連接時會顯示「無效的 API。」

1. 登入 Bitget 網頁版，到個人中心的「API Management」，按「Create New API」。
2. 「Notes」填 Blave，設定 API Passphrase 並記下來，在 Blave 連接時要填。
3. 權限選「Read-only」，不綁定 IP。
4. 完成信箱、簡訊與 Google 驗證碼，複製 API Key 與 Secret Key。

Bitget 官方說明

Bitunix

Blave 連接時會檢查合約帳戶，還沒開通合約的帳戶會連不上。

1. 登入 Bitunix，點右上角頭像 →「API Management」，按「Create API」。
2. 「Note」填 Blave，「Purpose」選「Bind Third-Party App」，權限會自動設為「Read-only」。介面若和這裡不同，以只給讀取權限為準。
3. 完成安全驗證後，畫面會顯示 API Key 與 Secret Key，當下就複製備份。

前往 Bitunix API 管理頁

Bybit

新註冊的帳戶前 48 小時可能無法建立金鑰。金鑰要用系統產生（HMAC），自行產生的 RSA／Ed25519 金鑰連不上。沒綁 IP 的 Bybit 金鑰 90 天後到期，延長方式見連接失敗怎麼辦。

1. 用電腦開 Bybit 網站（App 不能建立 API 金鑰），點右上角頭像 →「API」，進入「API Management」頁。
2. 按「Create New Key」，選「System-generated API Keys」。
3. 依畫面選用途，名稱填 Blave。
4. 權限選「Read-Only」，IP 選「No IP restriction」。
5. 輸入 Google 2FA 驗證碼，複製 API Key 與 Secret Key。

Bybit 官方說明

在 Blave 貼上金鑰

連接失敗怎麼辦？

• 顯示「無效的 API。」：Blave 用這組金鑰讀不到帳戶。依序檢查：金鑰複製不完整或多了空白；交易所選錯；OKX、Bitget 的 Passphrase 漏填或填錯；Binance、Bybit 用了自行產生的 RSA／Ed25519 金鑰；Binance、BingX、Bitunix 的合約帳戶還沒開通。
• Bitget 金鑰一直顯示「無效的 API。」：如果你的 Bitget 是統一交易帳戶（UTA），目前無法連接，Blave 只支援經典帳戶。
• 顯示「該 API 已被連接。」：同一個交易所帳戶已經連在某個 Blave 帳號上，可能是你的另一個帳號。先到那個帳號的 API 頁刪除，再重新連接。
• Bybit 原本正常，後來讀不到資料：沒綁 IP 的 Bybit 金鑰 90 天後到期。到 Bybit 的 API Management 頁，在該金鑰「IP Address Added」欄按編輯，選「No IP restriction」送出並完成驗證，效期從當下重算 90 天，金鑰不變（Bybit 官方說明）。

怎麼刪除金鑰？

1. 先到 Blave API 頁的「交易所」分頁，找到該金鑰按「刪除」並確認。
2. 再到交易所的 API 管理頁刪除同一把金鑰。

順序不要反過來：先在交易所刪除的話，Blave 這邊的紀錄不會自動移除。