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)
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/0xmasayoshi/sushiswap-apiWhat This Skill Does
The sushiswap-api skill provides OpenClaw agents with direct, programmatic access to the SushiSwap Aggregator via RESTful interfaces. This skill is designed to handle the complexities of decentralized finance by enabling optimized token swaps, real-time price discovery, and the generation of executable transaction data across over 40 EVM-compatible networks. By leveraging the SushiSwap infrastructure, the agent acts as an intermediary, querying liquidity sources to find the most efficient trade routes, retrieving metadata for specific tokens, and constructing transaction payloads that conform to standard blockchain execution requirements. The skill emphasizes robustness by strictly adhering to an OpenAPI schema, ensuring that request construction is always aligned with the latest API specifications without requiring manual updates to the agent logic.
Installation
To integrate this skill into your environment, use the OpenClaw command-line interface. Run the following command in your terminal:
clawhub install openclaw/skills/skills/0xmasayoshi/sushiswap-api
After installation, ensure the agent has permissions to access external network endpoints, as the skill requires connectivity to api.sushi.com to perform its primary functions.
Use Cases
- Token Swapping: Users can request the agent to swap one token for another, where the agent retrieves a quote and prepares the transaction data for the user's wallet.
- Portfolio Monitoring: Fetch real-time pricing data to update a user's dashboard or assess the value of their holdings across multiple chains.
- DeFi Analysis: Discover supported liquidity sources or fetch detailed metadata for tokens, such as contract addresses and precision, which is useful for building trading bots or analytical dashboards.
- Transaction Generation: Automatically generate the raw data needed for a swap transaction, allowing for seamless integration with wallet software to sign and broadcast the transaction.
Example Prompts
- "What is the current exchange rate for ETH to USDC on the Arbitrum network?"
- "Find the best route to swap 1000 USDT for DAI on Mainnet and give me the transaction details."
- "Show me the contract details and current price for the PEPE token on the Base network."
Tips & Limitations
- Mandatory Referrer: You must always provide a
referrerparameter in your requests. This identifies the integrator to the API, and requests will fail without it. Never attempt to spoof this value. - Fee Structure: The default fee model is an 80/20 split between the integrator and SushiSwap. If you have a partnership for a different split, do not attempt to hardcode this in parameters; follow official SushiSwap partnership guidelines.
- Error Handling: When encountering a 422 error, inspect your input parameters carefully as the schema requirements are strict. For 529 errors, implement an exponential backoff strategy before retrying.
- Schema Dependency: Always rely on
references/openapi.yamlfor current endpoints. Avoid hardcoding logic that might become stale as the API evolves.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-0xmasayoshi-sushiswap-api": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, external-api