亲爱的OKX API用户：
近期，OKX平台对费率体系进行了全面升级，所有币对将统一归入相同的费率类别。其中，期货和永续合约将根据保证金类型（USDT保证金与币本位保证金）采用不同的费率标准。为配合这一变更，平台已于2022年5月7日对实时交易系统中的“获取费率”接口进行了重要调整。本文将为您详细解析接口变化及应对方案。
接口主要变更内容
1. 移除“category”字段
- 原接口中的“category”字段已被正式移除，但这不会影响现有程序的调用。
- 无论请求中是否包含该参数，返回的数据结构均保持一致。这是因为所有币对已统一费率类别，无需再按类别区分。
2. 新增返回参数：takerU与makerU
- takerU：代表USDT保证金期货与永续合约的吃单费率。
- makerU：代表USDT保证金期货与永续合约的挂单费率。
- 重要提示：查询期货与永续合约费率时，原“taker”和“maker”参数的含义已发生变化，现在仅代表币本位合约的费率。
接口请求与返回参数详解
请求方式
- HTTP请求：
GET /api/v5/account/trade-fee - 接口名称：获取费率
请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| instType | 字符串 | 是 | 产品类型：SPOT（现货）、MARGIN（杠杆）、SWAP（永续）、FUTURES（期货）、OPTION（期权） |
| instId | 字符串 | 否 | 产品ID，如BTC-USDT，仅适用于现货/杠杆 |
| uly | 字符串 | 否 | 标的指数，如BTC-USD，仅适用于期货/永续/期权 |
| category | 字符串 | 否 | 此字段已停用 |
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| category | 字符串 | 费率表 |
| taker | 字符串 | 币本位合约吃单费率 |
| maker | 字符串 | 币本位合约挂单费率 |
| takerU | 字符串 | USDT保证金合约吃单费率，仅适用于期货/永续 |
| makerU | 字符串 | USDT保证金合约挂单费率，仅适用于期货/永续 |
| delivery | 字符串 | 交割费率 |
| exercise | 字符串 | 期权行权费率 |
| level | 字符串 | 费率等级 |
| instType | 字符串 | 产品类型 |
| ts | 字符串 | 数据返回时间（毫秒级Unix时间戳） |
开发者应对建议
- 检查代码兼容性：确保您的程序不再依赖“category”字段，并能正确识别新的“takerU”和“makerU”参数。
- 更新费率解析逻辑：针对期货和永续合约，需根据保证金类型区分使用“taker/maker”（币本位）或“takerU/makerU”（USDT保证金）。
- 全面测试交易策略：在模拟环境中验证策略的稳定性和准确性，避免因费率解析错误导致意外损失。
常见问题
问：接口调整后，现有程序是否需要立即修改？
答：现有调用仍可正常返回数据，但为确保长期兼容性与费率计算的准确性，建议尽快适配新参数结构。
问：如何区分币本位合约与USDT保证金合约的费率？
答：币本位合约费率请读取“taker”和“maker”字段，USDT保证金合约费率请读取“takerU”和“makerU”字段。
问：现货和杠杆交易的费率查询是否受影响？
答：不受影响。现货和杠杆交易仍使用原“taker”和“maker”参数，且费率类别统一后逻辑更为简洁。
问：如果未及时更新代码，可能遇到什么问题？
答：若程序仍按旧逻辑解析期货/永续合约费率，可能错误地将币本位费率应用于USDT保证金合约，导致成本计算偏差。
问：期权和交割合约的费率查询有变化吗？
答：期权仍使用“exercise”（行权费率），交割合约使用“delivery”费率，本次未调整。
总结
OKX本次费率接口调整旨在优化费率体系结构，提升API一致性与易用性。开发者应重点关注新增的USDT保证金费率字段，并及时更新解析逻辑。通过充分测试与代码适配，可确保交易策略平稳运行，精准掌控交易成本。