Freqtrade项目中的杠杆层级缓存问题分析与解决方案

问题背景

在使用Freqtrade进行Bybit平台的期货回测时，用户遇到了"Coins got no leverage tiers available"的错误提示。这个问题特别出现在某些特定币种(如SUI)上，尽管这些币种在Bybit平台确实提供了杠杆层级信息。

问题原因分析

经过深入调查，发现这个问题源于两个层面的机制：

1. Freqtrade的杠杆层级缓存机制：Freqtrade为了提高效率，会对平台的杠杆层级信息进行缓存。默认情况下，这些数据会被保存在user_data/data/bybit/futures/目录下的JSON文件中，缓存周期通常为数周。

2. CCXT库的API调用限制：底层使用的CCXT库在获取杠杆层级信息时，内部有一个硬编码的maxCalls参数(默认值为20)，限制了API调用的最大次数。对于Bybit这样提供大量交易对的平台，这个限制可能导致无法完整获取所有币种的杠杆信息。

解决方案

针对这个问题，我们提供两种解决方案：

方案一：清除Freqtrade缓存

1. 定位并删除缓存文件：user_data/data/bybit/futures/leverage_tiers_USDT.json
2. 重新启动回测，系统会自动重新获取最新的杠杆层级信息

方案二：修改CCXT库的调用参数

对于更复杂的情况，特别是当平台提供大量交易对时，可以修改CCXT库的fetch_paginated_call_cursor方法中的maxCalls参数：

1. 将默认值从20增加到50或更高
2. 这样能确保获取到所有币种的杠杆信息
3. 修改后，SUI等币种的杠杆信息能够正确获取，回测可以正常进行

技术细节

Freqtrade在获取杠杆信息时的处理流程：

1. 首先检查本地缓存
2. 若无缓存或缓存过期，通过CCXT库从平台API获取
3. 将获取的数据存入缓存供后续使用

CCXT库在处理分页API调用时，使用maxCalls参数来防止无限循环，但这个保守的设置可能导致数据获取不完整。

最佳实践建议

1. 定期清理杠杆层级缓存，特别是在平台新增交易对后
2. 对于大型平台，考虑适当增加CCXT的调用限制参数
3. 在策略开发初期，使用较小的交易对列表进行测试
4. 关注平台API的更新，及时调整相关参数

总结

Freqtrade与CCXT的集成提供了强大的交易功能，但在处理大量数据时可能会遇到此类边界条件问题。理解底层机制有助于开发者快速定位和解决问题，确保回测和实盘交易的顺利进行。通过适当的参数调整和缓存管理，可以有效避免杠杆信息获取不完整的问题。