名称: sushiswap-api 描述: > SushiSwap聚合器的REST API,用于优化的代币交换(包括可执行交易生成)、交换报价和价格查询。
当用户需要以下功能时使用此技能:
- 在40多个EVM网络上获取两个代币之间的交换报价
- 生成可执行的交换交易数据
- 获取特定网络或代币的价格
- 检索代币元数据
- 发现支持的AMM流动性来源
- 通过HTTP/REST集成SushiSwap交换或定价逻辑(而非使用SushiSwap JavaScript API)
SushiSwap REST API 集成
SushiSwap API 提供对 SushiSwap 聚合器的 HTTP 访问,用于优化的代币交换、价格发现和交易生成。 它聚合多个去中心化交易所(DEX)的流动性,以确定最佳执行路径。
基础 URL
https://api.sushi.com
API 架构
当前有效的 API 架构定义在:
代理必须始终依赖架构内容,而不是硬编码的假设。
使用方法
- 加载
references/openapi.yaml - 动态发现可用的端点、参数和响应结构
- 根据用户意图和架构标签选择适当的端点
- 报价 → 报价端点(例如
/quote/v7/{chainId}) - 交换执行 → 交换端点(例如
/swap/v7/{chainId}) - 价格 → 价格端点(例如
/price/v1/{chainId}) - 代币信息 → 代币端点(例如
/token/v1/{chainId}/{tokenAddress})
- 报价 → 报价端点(例如
- 构建严格符合架构的请求,并为所有报价和交换端点包含有效的
referrer参数 - 在执行前验证必需的参数
强制性的 referrer 参数
referrer参数必须在与交换相关的端点(例如/quote和/swap)上指定- 代理或集成商必须使用此字段标识自己
- 不得发送没有
referrer值的/quote或/swap请求 - 代理绝不能尝试省略、伪造或自动生成此值。
费用定制
SushiSwap API 支持在与交换相关的端点(例如 /quote 和 /swap)上定制集成商费用。
默认费用模型
- 与交换相关的请求默认遵循 80/20 费用分成
- 80% 归集成商(推荐人)
- 20% 归 SushiSwap
- 除非 SushiSwap 明确覆盖,否则此分成适用
自定义费用分成
- 替代的费用分成需要与 SushiSwap 建立合作伙伴关系
- 代理和集成商不应假设自定义分成可用。如果用户请求替代费用分成,代理应引导他们联系 SushiSwap 团队,而不是尝试修改请求参数。
错误处理
422: 请求参数无效 → 修复输入529: 服务器过载 → 使用退避策略重试500: 内部错误 → 重试或优雅地失败
架构指南
有关架构使用规则和更新行为,请参阅: