在去中心化交易所（DEX）生态中，通过聚合器获取最优兑换路径是提升交易效率的关键。本文将详细介绍如何通过 DEX 聚合器的兑换 API 获取交易数据，并深入解析各项请求与响应参数，助您高效集成。
兑换功能概述
DEX 聚合器 Router 能够为用户提供最优的兑换路径，聚合多个流动性源，确保获得最佳交易价格。通过调用兑换 API，您可以获取交易所需的详细数据，包括路径详情、预估费用和滑点设置等。
特别需要注意的是，在使用 Uni v3 流动性池进行兑换时，若池中流动性不足，系统将自动退回剩余支付代币。因此，在集成过程中，请确保您的智能合约能够正确处理代币退回，以保障用户体验。
核心请求参数详解
基本参数配置
- chainIndex：区块链唯一标识符（例如：501 代表 Solana）。
- amount：交易数量。需根据代币精度进行转换（例如：1 USDT 需输入 1000000）。
- swapMode：交易模式。可选择
exactIn（固定输入）或exactOut（固定输出）。后者仅支持部分链和协议。 - fromTokenAddress：卖出代币的合约地址。
- toTokenAddress：买入代币的合约地址。
- slippage：滑点限制。EVM 网络范围为 0-1，Solana 网络需小于 1。
高级功能参数
- feePercent：分佣比例。Solana 链最高 10%，其他链最高 3%。
- positiveSlippagePercent：正滑点费用比例（仅支持 Solana，最高 10%）。
- gasLevel：Gas 价格等级（可选 average、fast、slow）。
- priceImpactProtectionPercentage：价格影响保护阈值（默认 90%）。
- autoSlippage：启用自动滑点计算，覆盖手动设置。
响应参数解析
API 响应包含丰富的交易路径信息，主要分为以下几个部分：
路由结果概览
- fromTokenAmount：卖出代币数量。
- toTokenAmount：买入代币数量。
- tradeFee：预估网络费用（USD 计价）。
- estimateGasFee：预估 Gas 消耗（以 wei 为单位）。
路径详情信息
- dexRouterList：兑换路径集合，包含路径详情和处理比例。
- subRouterList：子路径数据，展示具体协议执行情况。
- fromToken/toToken：代币基本信息，包括合约地址、符号、精度和税率。
交易数据对比
- quoteCompareList：不同 DEX 的报价对比，包括费用、输出数量和价格影响。
- tx：交易数据，包含签名信息、Gas 设置和调用数据。
常见问题解答
什么是滑点？如何设置合理的滑点值？
滑点是指预期价格与实际执行价格之间的差异。设置滑点时，需考虑市场波动性：低波动代币可设置较小滑点（如 0.5%），高波动代币则需更大容忍度（如 3-5%）。启用 autoSlippage 参数可让系统根据实时市场情况自动计算最优滑点。
ExactOut 模式有哪些使用限制？
ExactOut 模式目前仅支持 Ethereum、Base、BSC 和 Arbitrum 链，且仅限于 Uni v2 和 v3 协议。在此模式下，滑点设置将作用于输入代币，确保输出数量精确。
如何正确处理代币退回情况？
当流动性不足时，系统会自动退回剩余代币。集成时，请确保您的合约包含接收代币的逻辑，并能够更新用户余额。建议在测试网上充分模拟各种流动性场景，以保证主网部署后的稳定性。
最佳实践建议
- 精度处理：始终使用代币精度转换数量，可通过币种列表接口获取最新精度信息。
- 费用优化：根据网络拥堵情况动态调整 Gas 等级，平衡交易速度与成本。
- 价格保护：启用
priceImpactProtectionPercentage防止大幅滑价，特别是低流动性代币交易。 - 测试验证：在生产环境前，全面测试各种边界情况，包括流动性不足、高滑点等场景。
通过合理配置 API 参数和深入理解响应数据，您可以构建高效、安全的 DEX 聚合交易体验，为用户提供最优的链上兑换服务。