sushiswap-api
REST API for optimized token swapping (including executable transaction generation), swap quoting, and pricing using the SushiSwap Aggregator. Use this skill when the user wants to: - Get a swap quote between two tokens on 40+ evm networks - Generate executable swap transaction data - Fetch token prices for a specific network or token - Retrieve token metadata - Discover supported AMM liquidity sources - Integrate SushiSwap swapping or pricing logic via HTTP/REST (and not the SushiSwap Javascript API)
About this skill
This skill provides a comprehensive REST API integration for the SushiSwap Aggregator, offering AI agents direct HTTP access to optimized token swaps, real-time price discovery, and transaction generation capabilities. It acts as a gateway to SushiSwap's powerful backend, which aggregates liquidity from multiple decentralized exchanges (DEXs) to determine the most efficient execution routes for token exchanges. AI agents can leverage this skill for a variety of decentralized finance (DeFi) use cases, including obtaining precise swap quotes between any two tokens across over 40 supported EVM networks, generating complete executable transaction data for these swaps, fetching current token prices for specific networks or tokens, retrieving detailed token metadata, and discovering available AMM liquidity sources. It is specifically designed for integration via HTTP/REST, offering an alternative to the SushiSwap JavaScript API. Developers and users benefit from this skill by enabling their AI agents to programmatically interact with the SushiSwap ecosystem. This allows for the automation of complex DeFi operations such as portfolio rebalancing, arbitrage trading, or building custom DeFi applications that require accurate pricing and efficient token exchange without needing to handle underlying blockchain complexities directly or rely on client-side JavaScript implementations. The skill ensures optimized routes and accurate data for critical DeFi actions.
Best use case
The primary use case for this skill is to empower AI agents with automated and optimized token swapping, pricing, and transaction generation capabilities across numerous EVM networks through a robust REST API. It benefits developers building trading bots, DeFi portfolio managers, or any application requiring programmatic access to decentralized exchange functionalities with efficiency and accuracy.
REST API for optimized token swapping (including executable transaction generation), swap quoting, and pricing using the SushiSwap Aggregator. Use this skill when the user wants to: - Get a swap quote between two tokens on 40+ evm networks - Generate executable swap transaction data - Fetch token prices for a specific network or token - Retrieve token metadata - Discover supported AMM liquidity sources - Integrate SushiSwap swapping or pricing logic via HTTP/REST (and not the SushiSwap Javascript API)
Users can expect to receive precise swap quotes, executable transaction data, current token prices, or detailed token metadata directly from the SushiSwap Aggregator.
Practical example
Example input
Get a swap quote for 0.1 ETH to USDC on Polygon, and provide the executable transaction data.
Example output
{ "quote": { "amountIn": "0.1 ETH", "amountOut": "320 USDC", "network": "Polygon", "gasCost": "15 USD" }, "transaction": { "to": "0x...", "data": "0x...", "value": "..." } }When to use this skill
- To get an optimized swap quote between two tokens on any of 40+ EVM networks.
- To generate executable blockchain transaction data for a token swap.
- To fetch real-time token prices or retrieve detailed token metadata.
- To integrate SushiSwap's aggregator via HTTP/REST for automated DeFi actions.
When not to use this skill
- When direct on-chain interaction via a Web3 library is preferred over a REST API.
- When using the SushiSwap JavaScript SDK is more suitable for client-side applications.
- For tasks unrelated to token swapping, pricing, or metadata on EVM networks.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/sushiswap-api/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How sushiswap-api Compares
| Feature / Agent | sushiswap-api | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | medium | N/A |
Frequently Asked Questions
What does this skill do?
REST API for optimized token swapping (including executable transaction generation), swap quoting, and pricing using the SushiSwap Aggregator. Use this skill when the user wants to: - Get a swap quote between two tokens on 40+ evm networks - Generate executable swap transaction data - Fetch token prices for a specific network or token - Retrieve token metadata - Discover supported AMM liquidity sources - Integrate SushiSwap swapping or pricing logic via HTTP/REST (and not the SushiSwap Javascript API)
How difficult is it to install?
The installation complexity is rated as medium. You can find the installation instructions above.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
AI Agents for Freelancers
Browse AI agent skills for freelancers handling client research, proposals, outreach, delivery systems, documentation, and repeatable admin work.
Best AI Skills for Claude
Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.
SKILL.md Source
# SushiSwap REST API Integration
The SushiSwap API provides HTTP access to the SushiSwap Aggregator for
**optimized token swaps**, **price discovery**, and **transaction generation**.
It aggregates liquidity from multiple DEXs to determine the best execution route.
---
## Base URL
```
https://api.sushi.com
```
---
## API Schema
The **active API schema** is defined in:
[references/openapi.yaml](references/openapi.yaml)
Agents must **always rely on the schema contents** rather than hardcoded assumptions.
---
## How To Use
1. Load `references/openapi.yaml`
2. Discover available endpoints, parameters, and response shapes dynamically
3. Select the appropriate endpoint based on user intent and schema tags
- Quotes → quote endpoints (e.g. `/quote/v7/{chainId}`)
- Swap execution → swap endpoints (e.g. `/swap/v7/{chainId}`)
- Prices → price endpoints (e.g. `/price/v1/{chainId}`)
- Token info → token endpoints (e.g. `/token/v1/{chainId}/{tokenAddress}`)
4. Construct requests that strictly conform to the schema and include a valid `referrer` parameter for all quote and swap endpoints
5. Validate required parameters before execution
---
## Mandatory `referrer` Parameter
- The `referrer` parameter **must be specified** on swap-related endpoints (e.g. `/quote` & `/swap`)
- The agent or integrator **must identify themselves** using this field
- `/quote` or `/swap` requests **must not be sent** without a `referrer` value
- Agents must never attempt to omit, spoof, or auto-generate this value.
---
## Fee Customization
The SushiSwap API supports customized integrator fees on swap-related endpoints (e.g. `/quote` & `/swap`).
### Default fee model
- Swap-related requests follow an **80/20 fee split by default**
- **80%** to the integrator (referrer)
- **20%** to SushiSwap
- This split applies unless explicitly overridden by SushiSwap
### Custom fee splits
- Alternative fee splits require a **partnership** with SushiSwap
- Agents and integrators should not assume custom splits are available. If users request alternative fee splits, agents should direct them to the SushiSwap
team rather than attempting to modify request parameters.
---
## Error Handling
- `422`: Request parameters are invalid → fix inputs
- `529`: Server overloaded → retry with backoff
- `500`: Internal error → retry or fail gracefully
---
## Schema Guidance
For schema usage rules and update behavior, see:
[references/OPENAPI.md](references/OPENAPI.md)Related Skills
send-usdc
Send USDC to an Ethereum address or ENS name. Use when you or the user want to send money, pay someone, transfer USDC, tip, donate, or send funds to a wallet address or .eth name. Covers phrases like "send $5 to", "pay 0x...", "transfer to vitalik.eth", "tip someone", "send USDC".
sushiswap-sdk
TypeScript SDK for interacting with the SushiSwap Aggregator and related primitives. This SDK is a typed wrapper over the SushiSwap API, providing ergonomic helpers for token amounts, prices, quotes, and swap transaction generation. USE THIS SKILL WHEN: - Building TypeScript or JavaScript applications - You want strongly typed token, amount, and fraction primitives - You need to request swap quotes or executable swap transactions via code - You want safer arithmetic, formatting, and comparisons without floating point errors - You prefer SDK-based integration over raw HTTP requests
---
name: article-factory-wechat
humanizer
Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.
find-skills
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
tavily-search
Use Tavily API for real-time web search and content extraction. Use when: user needs real-time web search results, research, or current information from the web. Requires Tavily API key.
baidu-search
Search the web using Baidu AI Search Engine (BDSE). Use for live information, documentation, or research topics.
agent-autonomy-kit
Stop waiting for prompts. Keep working.
Meeting Prep
Never walk into a meeting unprepared again. Your agent researches all attendees before calendar events—pulling LinkedIn profiles, recent company news, mutual connections, and conversation starters. Generates a briefing doc with talking points, icebreakers, and context so you show up informed and confident. Triggered automatically before meetings or on-demand. Configure research depth, advance timing, and output format. Walking into meetings blind is amateur hour—missed connections, generic small talk, zero leverage. Use when setting up meeting intelligence, researching specific attendees, generating pre-meeting briefs, or automating your prep workflow.
self-improvement
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks.
botlearn-healthcheck
botlearn-healthcheck — BotLearn autonomous health inspector for OpenClaw instances across 5 domains (hardware, config, security, skills, autonomy); triggers on system check, health report, diagnostics, or scheduled heartbeat inspection.
linkedin-cli
A bird-like LinkedIn CLI for searching profiles, checking messages, and summarizing your feed using session cookies.