如何在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 文件。

常见问题和直接答案

问：我可以使用 python-okx 在 OKX Spot 下 BTC 市价单吗？是的。使用 TradeAPI.place_order 和 ordType='market'，省略 px 字段，并通过 tgtCcy='quote' 指定 sz 作为基础货币数量或报价货币金额。

问：如果我的 API 请求签名验证失败会怎样？ API 返回错误代码 50113 以及消息“无效签名”。当时间戳与 OKX 服务器时间偏差超过 ±5 秒或 HMAC-SHA256 摘要与预期值不匹配时，就会发生这种情况。

问：订单未成交之前可以取消吗？是的。使用有效的 instId 和 ordId 调用 TradeAPI.cancel_order。部分成交的订单将保留已执行的部分，并将未成交的 sz 释放回可用余额。

问：如何解释资金余额响应中的“frozenBal”字段？ freezeBal 代表暂时保留用于未结订单、待提款或保证金要求的资金。在这些操作完成或取消之前，它不可用于新交易。