Bybit交易日誌
FOQUS自動為你的Bybit帳戶記錄交易日誌。每一個USDT與USDC永續合約倉位都會自動記入,不必手動輸入,連同手續費、資金費與停損紀錄。它以統一交易帳戶(UTA)的Read-Only(唯讀)金鑰連接,日誌永久免費。
FOQUS從Bybit記錄什麼
FOQUS記錄Bybit以USDT結算的永續合約(例如BTCUSDT),以及以USDC結算的永續合約(例如BTCPERP)。開啟中的倉位會立刻出現在日誌中,損益、停損與持倉時間即時更新。
每筆交易都會保存:
- 成交。開倉、加倉、減倉與平倉,各自記錄價格、數量與手續費。
- 停損與停利。每一次設定、取消與移動,以及訂單是否觸發。
- 資金費。持倉期間每一次收到或扣除的結算。
- 強制平倉。在交易時間軸上標記為獨立的動作。
- 限價進場單。從下單、修改到撤銷。
- 開倉時的帳戶。錢包餘額、淨值,以及當下其他開啟中的倉位。
- 每個動作當下的市場。過去5分鐘、1小時與1天的價格變動與成交量,以及RSI、資金費率、未平倉量與多空比。
- 訂單簿。每次開倉、加倉、減倉與平倉前後各錄製一分鐘:Bybit的合約訂單簿;如果該幣種有現貨,旁邊並列現貨訂單簿。免費方案每天10次錄製。
這些資料在一筆交易上會呈現成什麼樣子(你進場的那一秒、移動過的停損、資金費),請見首頁的時間軸。一筆交易原本能賺多少、又回吐了多少,請見MAE與MFE教學。
哪些Bybit網站可以使用
Bybit為多個國家經營獨立的網站,各有自己的API位址,而金鑰只能搭配自己網站的位址使用。FOQUS支援其中六個:bybit.com、bybit.tr、bybit.kz、bybitgeorgia.ge、bybit.ae與bybit.id。你不需要選擇:連接時,FOQUS會依序嘗試這些位址,停在第一個認得你金鑰的位址。
FOQUS不支援Bybit EU、日本與香港的帳戶。Bybit的文件說明,Bybit EU的API只提供給經紀商的第三方應用程式。FOQUS找不到這類金鑰,並會回覆「Bybit doesn’t know this key」(Bybit不認得這把金鑰)。
還有一個條件:統一交易帳戶(UTA)。FOQUS不會儲存經典帳戶的金鑰,並會顯示「Bybit rejected the key. Check the API key and secret.」(Bybit拒絕了金鑰,請檢查API金鑰與密鑰)。如果金鑰與密鑰確定正確,錯誤卻一再出現,請檢查你的帳戶類型。
如何建立Bybit唯讀API金鑰
金鑰只能在Bybit網站上建立,App無法建立。新註冊的Bybit帳戶,在註冊後的頭48小時內可能無法建立金鑰。
- 登入你帳戶所在的Bybit網站。點擊右上角的個人頭像,選擇API。在bybit.com上,就是API Management頁面。
- 點擊Create New Key,選擇System-generated API Keys(系統生成的API金鑰):由Bybit自行產生金鑰與密鑰。
- 在API Key Usage下保留API Transaction。Connect to Third-Party Applications是給Bybit清單上的應用程式用的。
- 為金鑰命名,例如FOQUS。在API Key Permissions下選擇Read-Only(唯讀)。
- 能勾選的項目都勾選:Orders、Positions等。在Read-Only模式下,每一項都只能查看。
- 選擇No IP restriction(不限制IP)。FOQUS不公開它的IP位址清單,因此綁定IP的金鑰無法使用。
- 點擊Submit,輸入驗證碼(一組來自電子郵件,一組來自Google Authenticator),再點擊Next Step。複製API Key與API Secret:Bybit只顯示一次密鑰。
- 建立FOQUS帳號,在Connect your own account(連接自己的帳戶)下選擇Bybit。如果你已經在使用FOQUS,請開啟帳戶選單 → Add account(新增帳戶)。貼上金鑰與密鑰,然後點擊Connect exchange(連接交易所)。
以上名稱取自bybit.com的英文版;其他語言(包括繁體中文)與地區版Bybit網站的用詞可能不同。唯讀API金鑰教學把Bybit的金鑰與Binance、OKX的並列說明。
不限制IP的Bybit API金鑰能用多久
沒有綁定IP的金鑰,Bybit會保留三個月;綁定IP的金鑰則永久有效。更改帳戶密碼後,舊金鑰會在7天內失效。金鑰過期時,FOQUS會把帳戶標示為「The venue refused this key — the account is not updating」(交易所拒絕了這把金鑰,帳戶已停止更新)。
請在那之前替金鑰續期,不必更換。打開API Management,點擊IP Address Added欄位裡的編輯。選擇No IP restriction,點擊Submit,再用電子郵件與2FA驗證碼確認。金鑰自當天起重新有效90天,金鑰與密鑰都不變。
如果已經過期,請建立新金鑰並貼到FOQUS:帳戶選單 → Edit account(編輯帳戶)。新金鑰必須來自同一個Bybit帳戶。來自其他帳戶的金鑰,FOQUS會以「This key belongs to a different exchange account」(這把金鑰屬於另一個交易所帳戶)拒絕。
把Bybit金鑰交給FOQUS安全嗎?
- Read-Only是檢查出來的,不是假設的。連接時,FOQUS會向Bybit查詢金鑰的模式。Read-Write金鑰會收到「The key is not read-only」(金鑰不是唯讀),並被丟棄。
- 只送出讀取請求。FOQUS向Bybit送出GET請求,查詢成交、訂單、倉位與餘額。這些請求都不會下單、移動資金或提領,而且Read-Only金鑰本來就做不到。
- 儲存的資料:金鑰、加密後的密鑰,以及金鑰所屬的Bybit網站。
- 離開時:在FOQUS刪除帳戶,它的交易會一併刪除;再到Bybit的API Management刪除金鑰。
FOQUS在Bybit看不到:現貨、選擇權、交割合約,以及以幣結算的反向合約(例如BTCUSD)。連接之前的交易也不會列入:Bybit的帳戶歷史沒有那些交易的訂單簿,而Bybit的訂單歷史只提供最近24小時內已撤銷的訂單。下一次進場前,倉位大小計算機會依你給定的停損算出倉位大小。偏好試算表?這裡有免費的交易日誌範本。其他平台:Binance、OKX、MetaTrader 5。
Bybit交易日誌常見問題
我過去的Bybit歷史會匯入嗎?
不會,這是刻意的設計:過去的歷史包含的資訊太少,無法覆盤一筆交易。它沒有訂單簿,而Bybit的訂單歷史只提供最近24小時內已撤銷的停損單。因此FOQUS從你連接的那一分鐘起,自己記錄每一筆交易:停損、進場時的帳戶與市場快照,以及訂單簿。之前開啟的倉位不會列入,即使你在連接後才平倉。
FOQUS支援Bybit現貨嗎?
不支援。FOQUS只記錄USDT與USDC永續合約,現貨交易不會進入日誌。不過,訂單簿錄製會在合約訂單簿旁邊,顯示該幣種的現貨訂單簿。
bybit.tr、bybit.kz或其他地區的帳戶可以用嗎?
可以。bybit.com、bybit.tr、bybit.kz、bybitgeorgia.ge、bybit.ae與bybit.id都可以使用。請在你帳戶所在的網站建立金鑰,FOQUS會自己判斷金鑰屬於哪個網站。Bybit EU、日本與香港的帳戶無法連接。
為什麼我的Bybit帳戶停止更新了?
最常見的原因是金鑰過期:沒有綁定IP的金鑰,Bybit只保留三個月。更改密碼後,舊金鑰會在7天內失效。請替金鑰續期,或把同一帳戶的新金鑰貼到Edit account。
可以連接多個帳戶或子帳戶嗎?
可以。每個帳戶或子帳戶都需要自己的Read-Only金鑰,新增數量沒有上限。子帳戶也必須是統一交易帳戶(UTA)。同一個Bybit帳戶無法新增第二次,不論使用哪一把金鑰。
資料來源
- Bybit: How to Create Your API Key?:金鑰只能在網站上建立、新帳戶的48小時限制、步驟,以及Create New Key視窗:API Transaction、Read-Only、No IP restriction。文中API Management頁面的圖片也寫明:未綁定IP的金鑰有效三個月、更改密碼後舊金鑰在7天內失效,以及密鑰只顯示一次。最後更新於2025年11月25日。
- Bybit API: FAQ:未綁定IP的金鑰在90天後過期;如何在保留金鑰與密鑰的情況下續期。
- Bybit API: Get API Key Information:FOQUS檢查的readOnly與uta欄位。
- Bybit API: Get Order History:狀態為Cancelled、Rejected或Deactivated的訂單只提供最近24小時;超過7天則只提供有成交的訂單。
- Bybit API: Get Orderbook:訂單簿請求只接受交易品種與深度,從不接受時間,回傳的是當下的訂單簿。
- Bybit API: Integration Guidance:各地區Bybit網站的API位址;Bybit EU的API只提供給經紀商的第三方應用程式。