SushiSwapAPI集成 sushiswap-api

SushiSwap API 集成技能提供了通过 RESTful HTTP 接口访问 SushiSwap 聚合器服务的完整能力。核心功能包括:跨 40 多个 EVM 兼容区块链网络的**代币交换报价**、**最优路径发现**、**可执行交易数据生成**、**实时代币价格查询**以及**代币元数据获取**。该 API 聚合了多个去中心化交易所(DEX)的流动性,确保用户获得最佳交易价格和最低滑点。适用于需要将去中心化交易、价格数据或流动性聚合功能集成到其应用程序、交易机器人或数据分析平台中的开发者、量化交易员和 DeFi 项目方。关键词:SushiSwap API, 代币交换, DeFi 聚合器, 区块链交易, 价格预言机, REST API, 智能合约交互, 跨链交易。

DeFi 0 次安装 0 次浏览 更新于 2/24/2026

名称: 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

代理必须始终依赖架构内容,而不是硬编码的假设。


使用方法

  1. 加载 references/openapi.yaml
  2. 动态发现可用的端点、参数和响应结构
  3. 根据用户意图和架构标签选择适当的端点
    • 报价 → 报价端点(例如 /quote/v7/{chainId}
    • 交换执行 → 交换端点(例如 /swap/v7/{chainId}
    • 价格 → 价格端点(例如 /price/v1/{chainId}
    • 代币信息 → 代币端点(例如 /token/v1/{chainId}/{tokenAddress}
  4. 构建严格符合架构的请求,并为所有报价和交换端点包含有效的 referrer 参数
  5. 在执行前验证必需的参数

强制性的 referrer 参数

  • referrer 参数必须在与交换相关的端点(例如 /quote/swap)上指定
  • 代理或集成商必须使用此字段标识自己
  • 不得发送没有 referrer 值的 /quote/swap 请求
  • 代理绝不能尝试省略、伪造或自动生成此值。

费用定制

SushiSwap API 支持在与交换相关的端点(例如 /quote/swap)上定制集成商费用。

默认费用模型

  • 与交换相关的请求默认遵循 80/20 费用分成
    • 80% 归集成商(推荐人)
    • 20% 归 SushiSwap
  • 除非 SushiSwap 明确覆盖,否则此分成适用

自定义费用分成

  • 替代的费用分成需要与 SushiSwap 建立合作伙伴关系
  • 代理和集成商不应假设自定义分成可用。如果用户请求替代费用分成,代理应引导他们联系 SushiSwap 团队,而不是尝试修改请求参数。

错误处理

  • 422: 请求参数无效 → 修复输入
  • 529: 服务器过载 → 使用退避策略重试
  • 500: 内部错误 → 重试或优雅地失败

架构指南

有关架构使用规则和更新行为,请参阅:

references/OPENAPI.md