Web3 API 文档更新日志与功能演进全览

本文档详细记录了 Web3 API 的更新历史，涵盖了 DEX API、DeFi API 及其他相关服务的功能新增、优化与重要变更。无论您是开发者、研究者还是技术爱好者，都能通过此日志了解 Web3 API 的能力演进与最佳实践。

核心功能演进概览

Web3 API 持续扩展其多链支持与交易功能，为开发者提供强大的工具集。

多链兑换支持

API 不断新增对主流公链的支持，提升跨链交易的便捷性：

• Sonic 链：2025年3月12日起，单链兑换接口已支持 Sonic 链。
• Solana 链：自2025年2月11日起，支持 /swap-instruction 接口，允许自定义组装交易指令。
• Sui 链：2024年10月29日，单链兑换功能扩展至 Sui 链。
• Merlin 链与 X Layer 链：2024年4月，跨链及单链兑换相继支持这两条新兴链。

交易功能增强

交易机制日益灵活，满足多样化场景需求：

• 正滑点收取：2025年3月6日，可通过 enablePositiveSlippage 参数启用。
• 指定流动性池：2025年1月23日，支持通过 directRouter 参数指定单个池进行兑换（当前仅限 Solana）。
• 自动滑点：2024年12月26日，单链兑换引入自动滑点功能，优化交易体验。
• 分佣功能：Solana 主网于2024年5月7日支持分佣；同年11月12日，新增分佣地址参数，SOL 及 SPL token 均可使用钱包地址分佣。

安全与风险控制

平台高度重视资产安全，引入了多项风控措施：

• 风险代币识别：自2024年11月12日起，单链询价与兑换接口可识别并返回如“貔貅盘”、买卖税100%的高风险代币，帮助用户规避风险。
• 滑点限制调整：跨链滑点限制参数范围多次调整，最终于2024年4月12日定为0.002-0.5，在灵活性与安全性间取得平衡。

详细更新日志（按时间倒序）

2025年主要更新

2025年3月12日

• API/DEX API

  • 单链兑换已支持 Sonic 链。

2025年3月6日

• API/DEX API

  • 单链兑换接口支持收取正滑点，通过设置 enablePositiveSlippage 参数实现。

2025年2月11日

• API/DEX API

  • 单链兑换接口支持 Solana 链的 /swap-instruction 接口，用户可自定义组装交易指令。

2025年1月23日

• API/DEX API

  • 单链兑换接口支持指定单个流动性池进行兑换（通过 directRouter 参数），当前仅支持 Solana 链。
  • 新增查询兑换交易历史功能。

2024年主要更新

2024年是功能密集更新的一年，主要集中在扩展链支持、增强交易灵活性和提升安全性。

第四季度更新

• 2024年12月26日：单链兑换接口支持自动滑点功能。
• 2024年11月25日：swapReceiverAddress 参数支持 Solana 链，可为兑换交易指定其他接收地址。
• 2024年11月12日：新增 Solana 分佣地址参数；多个接口支持返回协议 logo；支持识别高风险代币。
• 2024年10月29日：单链兑换支持 Sui 链。

第三季度更新

• 2024年7月2日：提醒用户 ETH dexRouter 旧合约（0xf3...9127）将于2024年8月1日后停用，请切换至最新版本。

第二季度更新

• 2024年6月19日：兑换 API DEX Router ETH 合约地址更新。
• 2024年5月7日：Solana 主网支持分佣功能。
• 2024年4月19日：跨链支持 Sui 链和 X Layer 链。
• 2024年4月12日：跨链滑点限制调整为0.002-0.5；跨链支持 Merlin 链；单链兑换接口新增返回参数 quoteCompareList。
• 2024年4月8日：单链兑换接口新增请求参数 toTokenReferrerAddress。
• 2024年4月2日：单链兑换接口新增支持 Merlin 链。

第一季度更新

• 2024年3月22日：单链兑换新增参数 callDataMemo；跨链接口新增排序参数 sort 并更新合约地址。
• 2024年3月13日：跨链查询状态接口新增 gasfee 等响应参数；跨链兑换新增 onlyBridge 参数及多个响应参数；新增跨链合约地址与专用币种列表接口。
• 2024年3月7日：单链跨链兑换新增请求参数 priceImpactProtectionPercentage。
• 2024年2月29日：单链兑换接口新增返回参数 decimal。
• 2024年2月22日：单链兑换接口新增返回参数 maxPriorityFeePerGas。
• 2024年2月1日：单链兑换支持 Solana，新增参数 solTokenAccountAddress，并提供快速开始引导。
• 2024年1月17日：跨链兑换接口新增请求参数 feePercent, referrerAddress。
• 2024年1月11日：跨链滑点范围调整为0.005-0.5。
• 2024年1月2日：跨链兑换新增请求参数 receiveAddress；查询状态接口新增参数 chainId。

2023年重要奠基

2023年是 Web3 API 文档体系化与功能初步成型的关键时期。

DeFi API 上线与核心功能建立

• 2023年12月28日：欧易 Web3 DeFi API 首版文档正式上线，包含申购、赎回、领取奖励金的完整流程，以及查询、计算、调用交易和查询用户信息的方法。

DEX API 功能扩展与优化

• 2023年12月20日：跨链接口新增响应参数 crossChainFeeTokenAddress 和 status。
• 2023年12月14日：新增 Dex Iframe；交易接口新增可选参数 swapReceiverAddress。
• 2023年12月08日：新增限价单列表查询接口和获取取消 calldata 接口。
• 2023年12月06日：跨链接口新增多个响应参数，FAQ 增加退款问题。
• 2023年11月：Order API 支持 OpenSea 和 OKX 挂单；新增多个快速开始教程；正式增加 DEX 跨链聚合器 API 和限价单 API。
• 2023年10月23日：添加智能合约模块，包含合约地址与 ABI 信息。

开发者体验与安全规范

• 2023年9月27日：更新 DApp 接入欧易 Web3 钱包移动端的引导内容。
• 2023年8月17日：为 Marketplace API、DEX API、比特币生态 API 统一添加 API Key 身份验证，所有接口需从开发者平台生成 Key，并更新了所有 URI 和错误码。
• 2023年5月29日：比特币生态 API 新增 brc20/token-list 接口，并为现有接口添加 index, location 等响应参数。

常见问题

Web3 API 支持哪些区块链？

目前，Web3 API 的单链与跨链功能已支持包括 Ethereum、Solana、Sui、Sonic、Merlin、X Layer 在内的多条主流公链，并持续扩展中。👉 查看所有支持的链列表与实时更新

如何开始使用 DEX API 进行开发？

建议从官方提供的“快速开始教程”入手。2023年11月后，文档中陆续增加了DEX API、跨链聚合器API及Solana链的专项引导，包含代码示例和关键参数说明。

什么是正滑点？如何启用？

正滑点是指交易执行价格优于预期价格带来的额外收益。从2025年3月6日起，您可以在调用单链兑换接口时，通过设置 enablePositiveSlippage 参数为 true 来启用此功能。

如何防范高风险代币？

自2024年11月12日起，使用单链询价（quote）或兑换（swap）接口时，系统会自动识别并返回如“貔貅盘”等高风险代币的警告信息。开发者应在前端集成这些提示，以保护终端用户资产安全。

旧版的 ETH Router 合约还能用吗？

不能。根据2024年7月2日的公告，旧版ETH dexRouter合约（0xf3de3c0d654fda23dad170f0f320a92172509127）已在2024年8月1日后停止服务。请务必确保您的应用已迁移至最新的合约地址。

调用 API 需要进行身份验证吗？

是的。自2023年8月17日起，调用 Marketplace API、DEX API 和比特币生态 API 均需使用 API Key 进行身份验证。您需要前往 Web3 开发者管理平台生成专属 Key 后方可调用接口。