如何查看OKX合约盈利历史？完整教程

通过 OKX Web 界面访问期货利润历史记录

1. 使用经过验证的凭据登录您的 OKX 帐户，然后导航至顶部导航栏上的“资产”部分。

2. 从下拉菜单中选择“期货”，进入期货钱包仪表板。

3. 单击余额摘要面板正下方的“历史记录”选项卡。

4. 从过滤器选项中选择“损益”——这将显示按时间顺序排序的所有已实现盈亏条目。

5. 使用日期范围选择器指定开始和结束时间戳；默认视图显示最近 30 天，但每个查询最多支持 90 天。

通过 python-okx API 检索利润数据

1. 使用有效的 API 凭证初始化AccountAPI模块，并为真实交易环境设置flag='1' 。

2. 调用get_position_history() ，参数包括instType='SWAP' 、 instId='BTC-USDT-SWAP'和limit=100 。

3. 解析响应数据以提取每个平仓头寸的实现Pnl 、费用、 ts （时间戳）和ordId等字段。

4. 通过迭代前后游标值来聚合多个页面的结果，直到不再返回记录。

5. 使用 Python 的日期时间库将原始毫秒时间戳转换为 ISO 8601 格式以提高可读性并与本地时区设置保持一致。

了解OKX期货的盈利计算逻辑

1. 已实现利润是在平仓时计算的，对于多头仓位，已实现利润等于(退出价格 - 入场价格) × 仓位大小 × 合约乘数。

2. 对于空头仓位，公式相反： (entryPrice - exitPrice) ×positionSize ×contractMultiplier 。

3. 费用单独扣除，包括接受者/制造者费率以及定期收取的资金结算费用。

4. 未实现盈亏不包括在历史利润报告中——它仅出现在活跃头寸跟踪中，并在平仓时重置。

5. 全仓保证金和逐仓保证金模式会影响费用分配和清算门槛，但不会改变核心盈亏算法。

数据导出和本地存储选项

1. 在 OKX Web 界面中，单击 PnL 表旁边的“导出”按钮，下载包含所有可见行的 CSV 文件。

2. 导出的文件包括以下列：日期、工具、边、大小、入场价格、退出价格、已实现盈亏、费用和净利润。

3. 使用 python-okx 时，从 API 响应构建 Pandas DataFrame 并使用df.to_csv('okx_futures_pnl.csv', index=False)将其保存在本地。

4. 通过安排一个 cron 作业来启用每日自动导出，该作业触发一个脚本，使用之前和之后的时间戳来获取前一天的 PnL 记录。

5. 使用 AES-256 加密工具存储导出文件的加密备份，以符合个人数据保护要求。

常见问题解答

Q1：我可以通过OKX网页界面检索超过90天的盈利历史吗？不可以。Web 界面对直接检索强制执行严格的 90 天限制。要访问较旧的记录，请使用 python-okx get_position_history()方法和适当的分页处理。

问题 2：为什么我导出的 CSV 显示某些职位的费用为零？当在挂单者回扣期间建仓和平仓或不涉及吃单流动性消耗时，就会发生这种情况。如果头寸持续时间在结算周期之间，则也可能不存在资金费用。

Q3：已实现盈亏是在扣税前还是扣税后显示？ OKX 不执行扣缴税款。显示的所有损益值均为任何司法管辖区纳税义务之前的总金额。

问题 4：API 是否会在利润历史端点中返回未实现的盈亏？不会。像get_position_history()这样的端点专门提供最终的、已平仓的数据。未实现的值仅出现在通过get_positions()的实时仓位快照中。