Skip to main content

Documentation

Choose between Ring smart contracts, the Ring Swap SDK, and the partner Routing API.

Structured reference
TOC available

Build with Ring

Choose an integration method based on who should discover the route, build the transaction, and submit it.

MethodBest forYour responsibilityStart here
Smart contractsProtocols that need Ring Swap inside an onchain workflowSelect the network and router, manage approvals, set limits and deadlines, and test the complete call pathSmart contract quick start
Ring Swap SDKTypeScript applications and services that build their own quotes and tradesFetch pool state, construct the route and trade, then submit through the selected routerRing Swap SDK
Routing APIApproved partners that want a hosted quote with proposed transaction calldataAuthenticate requests, decode and validate the response, simulate it, and submit only an approved transactionRouting API

Before you build

All three methods use chain-specific addresses. Start with the maintained contract deployments, then use Pools by Network for pool discovery. Verify addresses and contract relationships onchain before use.

Ring Swap routes use FewToken addresses. Resolve and validate wrappers through the published, independently verified FewFactory for the selected chain. Do not rely on a symbol, token list, or third-party pool alone.

Read Security and Risk before building a flow that can move user funds.

If your integration directly targets Uniswap v4 PoolManager, PositionManager, or hooks, use the Uniswap v4 Integration section instead.

On this page

Tools