name: sushiswap-sdk
description: >
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
The SushiSwap SDK is a TypeScript wrapper around the SushiSwap API.
It provides strongly typed primitives and utilities for working with
tokens, prices, swap quotes, and transaction generation.
This SDK does not replace the API — it builds on top of it with safer,
more expressive abstractions.
Install the required packages using your package manager of choice:
pnpm add sushi viem
npm add sushi viem
yarn add sushi viem
bun add sushi viem
- Import the appropriate SushiSwap SDK helpers from
sushi/evm
- Select the correct SDK method based on user intent:
- Swap quote →
getQuote()
- Swap execution →
getSwap()
- Provide all required parameters exactly as defined by the SDK types
- Always include a valid
referrer
value
- Validate inputs (chainId, token addresses, amount, slippage) before execution
- Use returned transaction data exactly as provided for simulation or execution
The SDK is a thin wrapper over the SushiSwap REST API — all routing, pricing, and calldata generation is still performed by the API.
The SushiSwap SDK exposes the list of supported swap networks via:
import { SWAP_API_SUPPORTED_CHAIN_IDS } from 'sushi/evm'
- Agents and integrators should always check this list before attempting to:
- Fetch a quote
- Generate swap transaction data
- If a requested chainId is not included:
- The agent must fail early or prompt the user to select a supported network
- Agents must not attempt to guess or hardcode supported chains
This list reflects the networks currently supported by the SushiSwap Aggregator API. The supported networks may change over time and should not be cached indefinitely.
--
- The
referrer
parameter must be specified when calling getQuote()
or getSwap()
- The agent or integrator must identify themselves using this field
- Swap-related SDK calls must not be executed without a
referrer
value
- The SDK must not auto-generate or omit this value on behalf of the integrator
The SushiSwap SDK supports customized swap fees when using
getQuote()
or
getSwap()
.
- 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
- 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.
For detailed SDK examples & execution flow, see:
references/REFERENCE.md