如何在OKX現貨上購買BTC？

帳戶設定和 API 配置

1. 登入您的 OKX 帳戶並導覽至「安全設定」下的「API 管理」部分。

2. 建立一個新的 API 金鑰，並明確啟用「讀取」和「交易」權限。除非絕對必要，否則不要啟用提款權限。

3. 記錄三個基本憑證：API 金鑰、金鑰和密碼。將它們儲存在加密的環境變數檔案或安全保管庫中。

4. 設定 IP 白名單，將 API 存取限制為僅受信任的伺服器位址。

5. 在啟動任何實際交易之前，將標誌參數設為「0」（用於即時交易）或「1」（用於演示環境測試）。

市場數據收集和驗證

1. 初始化MarketData模組，無需認證即可取得即時BTC-USDT行情資料。

2. 解析回應以提取最後交易價格、24 小時最高價/最低價和買賣價差。

3. 根據 CoinGecko 和 Binance 現貨源等多個來源交叉檢查檢索到的價格，以檢測潛在的異常情況。

4. 使用大小為 25 的 get_orderbook 方法來驗證中間價格附近主要價格水準的當前流動性深度。

5. 驗證本機系統時鐘和 OKX 伺服器時間之間的時間戳同步，以避免簽章過期錯誤。

訂單執行機制

1. 使用經過驗證的憑證和適當的標誌值實例化 TradeAPI 類別。

2. 建構一個限價訂單負載，指定instId為“BTC-USDT”，tdMode為“cash”，side為“buy”，ordType為“limit”，px為目標執行價格，sz為所需的BTC數量。

3. 提交訂單並從 JSON 回應中擷取傳回的 ordId、clOrdId 和程式碼欄位。

4. 立即呼叫 get_orders_pending 來確認訂單出現在未結帳訂單清單中。

5. 透過輪詢或 WebSocket 訂閱 /public/spot/trade 通道來監控已執行成交的成交狀態。

資金審核及結算

1. 在下達任何買單之前，請使用 ccy='USDT' 呼叫 FundingAPI.get_balances 方法來檢索可用餘額和凍結金額。

2. 確保availBal超過訂單總價值（px × sz）加上預計交易費用。

3. 成功執行後，再次觸發 get_balances 觀察更新後的 bal 和vailBal 值，反映新的 BTC 部位和減少的 USDT。

4. 使用AccountAPI.get_account_bills檢索交易紀錄，以確認結算時間戳記和費用扣除額。

5. 將訂單確認和結算日誌匯出為包含 ordId、instId、px、sz、fillSz、fee 和時間戳欄位的 CSV 檔案。

常見問題和直接答案

Q：我可以使用 python-okx 在 OKX Spot 下 BTC 市價單嗎？是的。使用 TradeAPI.place_order 和 ordType='market'，省略 px 字段，並透過 tgtCcy='quote' 指定 sz 作為基礎貨幣數量或報價貨幣金額。

Q：如果我的 API 請求簽章驗證失敗會怎麼樣？ API 傳回錯誤代碼 50113 以及訊息「無效簽章」。當時間戳記與 OKX 伺服器時間偏差超過 ±5 秒或 HMAC-SHA256 摘要與預期值不符時，就會發生這種情況。

Q：訂單未成交前可以取消嗎？是的。使用有效的 instId 和 ordId 呼叫 TradeAPI.cancel_order。部分成交的訂單將保留已執行的部分，並將未成交的 sz 釋放回可用餘額。

Q：如何解釋資金餘額回應中的「frozenBal」欄位？ freezeBal 代表暫時保留用於未結訂單、待提款或保證金要求的資金。在這些操作完成或取消之前，它不可用於新交易。