What the API does
The Swap API turns an order into an executable transaction. You request a quote for a sell token, buy token, and amount, and Rialto returns the best route, the expected output, the fee breakdown, and a ready-to-send transaction for the RialtoRouter contract. The integration boundary is intentionally small: call the quote endpoint, then submit the returned transaction. You never build route calldata, pool calls, fee logic, slippage math, Permit2 witnesses, or settlement actions yourself.Base URL
Execution flows
Rialto supports two execution flows. Each quote tells you which settlement mode applies; choose your handling from the response rather than assuming.- Taker-submitted. The user’s wallet submits the onchain transaction and pays gas. Use this for native-token sells and for any flow where the taker broadcasts.
- Gasless relayer. The user signs a Permit2 message and Rialto broadcasts the transaction and pays gas. Available for ERC20 sells.
Quickstart
- Call the tokens endpoint to discover supported tokens.
- Call the quote endpoint with the sell token, buy token, amount, taker, and slippage.
- Inspect the quote’s issues for balance and allowance blockers. Ask the user to approve if issues.allowance is present.
- If the quote includes a Permit2 payload, have the taker sign the returned EIP-712 message and insert the signature into tx.data at tx.signature_offset.
- Submit the returned transaction from the taker wallet, or for gasless, submit the signature to /gasless/submit and poll /gasless/status/.