swap-integration 用于把 PancakeSwap 的兑换能力接入应用,适用于前端、后端脚本、交易机器人以及智能合约。资料按场景给出三种方法,并说明如何选择:需要快速报价或做原型时,可以使用 PancakeSwap Routing API;使用 React/Next.js 的前端、后端脚本或交易机器人,适合 Smart Router SDK + Universal Router;仅需简单的 V2 兑换或编写 Solidity 集成时,可以直接调用 V2 Router 合约;需要精确的 Universal Router 编码时,也可以直接使用 Universal Router SDK。若要走 Infinity(v4)CL 或 Bin 池,可选 Routing API,或使用支持 Infinity 池类型的 Smart Router SDK。
主要能力与协议:V2 是经典 AMM(xy=k),费率 25 bps,仅 BSC 支持;V3 是集中流动性,与 Uniswap V3 兼容,费率档位 1、5、25、100 bps,支持所有列出的链;StableSwap 面向相关/锚定资产,低滑点,费率 1、4 bps,仅 BSC;Infinity CL 位于 v4 singleton PoolManager,支持 hooks,覆盖 BSC 与 Base;Infinity Bin 是固定价格 bin 流动性,覆盖 BSC 与 Base;Mixed 可跨上述协议拆分路由,主要在 BSC。
支持链与测试:BSC(56)支持 V2、V3、StableSwap、Infinity CL、Infinity Bin;BSC 测试网(97)仅 V2;以太坊(1)、Arbitrum One(42161)、Polygon(137)、zkSync Era(324)、Linea(59144)、opBNB(204)支持 V3;Base(8453)支持 V3、Infinity CL、Infinity Bin。资料还列出各链 RPC 与 Universal Router 地址。测试时使用 BSC 测试网,并可从指定水龙头获取测试 BNB;Smart Router SDK 不索引测试网池,测试网应使用直接 V2 Router 方式。
使用方式:方法一使用 Routing API,基础地址为 https://router.pancakeswap.finance/v0/quote,参数包括 tokenInAddress、tokenInChainId、tokenOutAddress、tokenOutChainId、amount、type、maxHops、maxSplits;资料给出 curl 与 TypeScript 示例。方法二需要安装 @pancakeswap/smart-router、@pancakeswap/sdk、@pancakeswap/v3-sdk、@pancakeswap/universal-router-sdk 以及 viem@2.37.13,示例依次展示创建 viem 客户端、定义代币、并行获取 V2/V3/Stable 候选池、查找最优交易、授权 Permit2 与 Universal Router、编码并发送交易,也包含 exactOutput 示例。方法三给出 V2 Router 地址 0x10ED43C718714eb63d5aA57B78B54704E256024E 及 swapExactETHForTokens、swapExactTokensForETH、swapExactTokensForTokens、支持转账手续费的变体与 getAmountsOut 等 ABI 片段。
限制与注意事项:资料提到 Routing API 报价若超过约 15 秒应重新获取,否则可能因 INSUFFICIENT_OUTPUT_AMOUNT 失败;Smart Router SDK 的 Infinity 池集成仍在演进,目前可靠访问 Infinity CL/Bin 建议使用方法一;直接 V2 Router 仅支持 V2,不支持 V3 与 StableSwap;方法二示例提示可缓存池数据 30–60 秒,并对高价格影响进行提示。资料未提供收费、价格、平台或效果信息。