A comprehensive REST API skill for executing optimized token swaps and accessing multi-chain price data via the SushiSwap Aggregator.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install sushiswap-api
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install sushiswap-api using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is SushiSwap REST API Integration?
The SushiSwap REST API skill provides a high-performance interface for AI agents to interact with the SushiSwap Aggregator. This integration enables agents to perform optimized token swaps, discover real-time pricing, and generate executable transaction data across more than 40 EVM-compatible networks. By leveraging Openclaw Skills, developers can build autonomous agents that find the best execution routes for decentralized finance operations without needing deep local integration of the SushiSwap Javascript SDK.
This skill is designed for precision and reliability, strictly following the OpenAPI specification to ensure that agents always have access to the most current endpoints and parameter requirements. It serves as a bridge between high-level agent logic and the complex world of multi-DEX liquidity aggregation.
SushiSwap REST API Integration Use Cases
- Fetching optimized swap quotes for token pairs on any supported EVM network.
- Generating ready-to-sign transaction data for executing swaps directly from an AI agent.
- Accessing real-time token price discovery and historical metadata for portfolio tracking.
- Identifying the best liquidity sources across multiple AMMs for specific asset trades.
- Building automated trading workflows that require programmatic access to DeFi liquidity.
How SushiSwap REST API Integration Works
- The AI agent initializes the skill by loading the openapi.yaml schema to discover active endpoints and data shapes.
- The user provides a swap or pricing intent, which the agent translates into a specific API call (e.g., quote, swap, or price endpoint).
- The skill validates required inputs, including the mandatory referrer parameter necessary for swap-related requests.
- The request is dispatched to the SushiSwap Aggregator, which scans dozens of liquidity sources to find the most efficient route.
- The skill returns the structured JSON response to the agent, providing either market data or the transaction payload for blockchain execution.
SushiSwap REST API Integration Setup
To deploy this skill, ensure the OpenAPI definition is accessible to your agent environment. Follow these steps to configure your workspace for Openclaw Skills:
# Ensure your project directory has a references folder
mkdir -p references
# Download or copy the SushiSwap openapi.yaml to the references folder
# This file is essential for the agent to discover available REST endpoints
cp path/to/source/openapi.yaml ./references/openapi.yaml
Ensure that you have a valid referrer string ready for all swap and quote operations to comply with the API requirements.
SushiSwap REST API Integration Data Schema & Taxonomy
The skill organizes its operations based on specific functional categories defined in the SushiSwap API schema. Below is a summary of the data taxonomy:
| Data Category | Endpoint Prefix | Purpose |
|---|---|---|
| Quotes | /quote/v7/{chainId} |
Returns execution routes and expected output amounts. |
| Swaps | /swap/v7/{chainId} |
Provides the tx object for on-chain execution. |
| Prices | /price/v1/{chainId} |
Fetches current market rates for tokens. |
| Metadata | /token/v1/{chainId} |
Retrieves token decimals, names, and symbols. |
| Connectivity | /v0/config |
Lists supported chains and AMM liquidity sources. |
SushiSwap REST API Integration Advanced Features
- Multi-chain support for over 40 EVM networks, enabling extensive cross-chain asset analysis.
- Dynamic liquidity aggregation that routes trades through the most efficient DEX combinations.
- Built-in integrator fee model with an 80/20 split for users of Openclaw Skills.
- Robust error handling specifically designed for 422, 529, and 500 status codes for agent resilience.
- Support for custom fee split overrides for authenticated partners and high-volume integrators.
SKILL.md
Loading
Related Openclaw Skills
Doppel
A skill enabling AI agents to register, navigate, and collaboratively build within the Doppel 3D virtual metaverse.
Doppel Social Outreach
A strategic outreach skill designed to promote AI agent world builds across social platforms to maximize reputation and recruitment.
Doppel ERC-8004 Onchain Identity
An automated workflow to register AI agents on the ERC-8004 protocol for permanent, verifiable onchain identity and reputation tracking.
doppel-block-builder
A specialized tool for AI agents to construct permanent 3D structures on an integer grid within shared Doppel worlds using MML.
SushiSwap SDK
A comprehensive TypeScript wrapper for the SushiSwap Aggregator API designed to facilitate safe and efficient swap integrations.
SkillGuard
SkillGuard provides automated security auditing for AI agent skills to prevent prompt injection and malicious code execution.
Featured*
