OKX交易日誌
FOQUS自動為你的OKX帳戶記錄交易日誌。每一個USDT與USDC永續合約倉位都會自動記入，不必手動輸入，連同手續費、資金費與停損紀錄。連接時，你需要一把只有「讀取」（Read）權限的金鑰、它的密鑰與Passphrase。日誌永久免費。
FOQUS從OKX記錄什麼
FOQUS記錄OKX以USDT與USDC為保證金的永續合約，例如BTC-USDT-SWAP與BTC-USDC-SWAP。
倉位開啟期間，它會顯示在FOQUS中，損益、停損與持倉時間即時更新。每一次加倉與部分平倉都會記為獨立的動作，附上價格、數量與手續費。FOQUS會標記你何時設定、取消或移動停損與停利。每次資金費結算都會計入這筆交易。
倉位平倉後，會顯示含手續費與資金費的結果，強制平倉則顯示為獨立事件。旁邊是你的限價進場單：哪些是你下的、修改過的與撤銷的。
在你的每筆成交前後，FOQUS會保存當時的情境：進場時你的餘額與其他倉位，以及市場快照：價格變化與成交量、RSI、資金費率、未平倉量。它也會錄製OKX自己的訂單簿，在每次進場、加倉、部分平倉與出場前後各一分鐘。免費方案每天包含10次這樣的錄製。
不在記錄範圍內的有：現貨與槓桿交易、交割合約、選擇權，以及以幣為保證金的永續合約，例如BTC-USD-SWAP。你連接之前開啟的倉位也不會列入：OKX的帳戶歷史沒有訂單簿，而已撤銷且未成交的普通訂單，OKX只保留2小時。因此FOQUS從你連接的那一分鐘起，自己記錄每一筆交易。
哪些OKX網站可以使用
OKX有三個獨立的網站，各有自己的API位址，而金鑰只能透過自己網站的位址使用。FOQUS支援這三個網站的帳戶：
| 你註冊的網站 | FOQUS讀取的API位址 |
|---|---|
| okx.com | openapi.okx.com |
| my.okx.com（歐洲經濟區） | eea.okx.com |
| app.okx.com（美國與澳洲） | us.okx.com |
FOQUS會自己判斷是哪個網站：先嘗試openapi.okx.com，再試eea.okx.com，最後試us.okx.com，並記下認得這把金鑰的位址。如果都不認得，就什麼都不儲存，連接畫面會顯示「OKX doesn’t know this key. Check the API key.」（OKX不認得這把金鑰，請檢查API金鑰）。
如何建立OKX唯讀API金鑰
- 登入你註冊的OKX網站。打開個人資料（Profile）→ API 和連接（API and connections）→ 創建 API key（Create API key）。在App中：九宮格圖示（⋮⋮⋮）→ API → 創建 API key。
- 輸入金鑰名稱，例如FOQUS。選擇你交易用的帳戶（主帳戶或子帳戶），以及金鑰的用途。
- IP位址白名單留空：FOQUS不公開它的IP位址。
- 在權限（Permissions）下只保留讀取（Read）。不要開啟交易（Trade）或提幣（Withdraw）；如果看到劃轉（Transfer）、借幣（Loan）或賺取（Earn），也不要開啟。
- 替金鑰設定一組Passphrase（密碼短語）並記下來。OKX無法找回它：忘記的話，只能建立新的金鑰。
- 確認後，保存API key與Secret key。
- 建立FOQUS帳號，選擇OKX並填入三個欄位：API key、API secret與Passphrase。點擊Connect exchange（連接交易所）。
以上的中文名稱取自OKX的繁體中文說明，括號內是英文版的名稱；選單項目的名稱依OKX網站版本與地區而異。OKX繁體中文說明的步驟把Passphrase稱為「助記詞」，但它是這把金鑰的密碼，不是錢包的助記詞。在某些地區，帳戶資產至少要有100 USD，OKX才允許建立金鑰。
OKX會刪除未綁定IP、具有交易或提幣權限、且14天未使用的金鑰。這條規則不影響給FOQUS的金鑰：它沒有這些權限。其他過期規則，OKX寫在自己的API常見問答「API key會過期嗎？」一節。萬一OKX停用了金鑰，FOQUS中的帳戶會顯示「The venue refused this key — the account is not updating」（交易所拒絕了這把金鑰，帳戶已停止更新），並等待新的金鑰。
唯讀API金鑰教學把OKX的金鑰與Binance、Bybit的並列說明。
把OKX金鑰交給FOQUS安全嗎？
- 權限資訊來自OKX本身。連接時，FOQUS會取得金鑰的設定，OKX在其中以read_only、trade或withdraw列出它的權限。只要有read_only以外的權限，就會顯示「The key is not read-only」（金鑰不是唯讀），金鑰也會被丟棄。
- 只有讀取請求。FOQUS只向OKX送出讀取類的請求。它無法下單或撤單、在帳戶之間移動資金，也無法提幣。
- 加密儲存：密鑰與Passphrase。API金鑰與金鑰所屬OKX網站的位址，則不加密，直接保存。
- 中斷連接：在FOQUS刪除帳戶，它的交易也會一併刪除。接著到OKX的個人資料 → API刪除金鑰。
日誌會把一個帳戶的交易整理成表格、附圖表的卡片，或週報、月報與年報。接著，MAE與MFE告訴你每段行情你留住了多少，倉位大小計算機則依停損規劃下一次進場。手動記錄也可以：交易日誌範本是免費的。同樣支援：Binance、Bybit、MetaTrader 5。
OKX交易日誌常見問題
OKX的Passphrase要去哪裡找？
Passphrase是你建立金鑰時自己設定的，不是OKX帳戶的登入密碼。之後無法再查看：如果遺失了，請刪除金鑰並建立新的。
為什麼FOQUS顯示「Incorrect OKX passphrase」？
意思是OKX的Passphrase不正確：OKX認得這把金鑰，卻不接受這個Passphrase。你需要的是建立這把金鑰時設定的那一組：每把金鑰都有自己的Passphrase。請檢查鍵盤的輸入法與大小寫。
歐洲、美國或澳洲的OKX帳戶可以用嗎？
可以。FOQUS會判斷金鑰是在哪個網站建立的：okx.com、my.okx.com或app.okx.com，並透過該網站的位址讀取你的交易。
我過去的OKX歷史會匯入嗎？
不會，這是刻意的設計：過去的歷史包含的資訊太少，無法覆盤一筆交易。它沒有訂單簿，而已撤銷且未成交的普通訂單，OKX只保留2小時。因此FOQUS從你連接的那一分鐘起，自己記錄每一筆交易。在那之前開啟的倉位，即使之後才平倉也會略過，因為FOQUS從未看到它們的停損，也沒看到進場時的帳戶。
可以連接OKX子帳戶嗎？
可以。請在子帳戶內建立金鑰，使用子帳戶自己的權限與Passphrase。不要混用主帳戶與子帳戶的金鑰與Passphrase。FOQUS會記錄該子帳戶的交易。
資料來源
- OKX: API FAQ（繁體中文版）：在網站與App建立金鑰的步驟；Passphrase無法查看或找回；Transfer、Loan與Earn權限；部分地區的100 USD條件；子帳戶金鑰；金鑰過期。2026年9月28日更新。
- OKX API: Order history (last 7 days)：已撤銷且未成交的普通訂單保留2小時。
- OKX API: Order book：訂單簿請求只接受交易品種與深度，從不接受時間，回傳的是當下的訂單簿。
- OKX API v5：Read、Trade與Withdraw權限；每把金鑰最多20個IP位址；未綁定IP、具有trade或withdraw權限的金鑰，14天未使用即過期；my.okx.com與app.okx.com的API位址；FOQUS檢查的perm欄位。