Error shape
Errors are returned as JSON:Status codes
| Status | Example error | Meaning |
|---|---|---|
| 400 | varies | Invalid params, unsupported token, no route, or swap-building error. |
| 401 | unauthorized | Missing, malformed, invalid, disabled, or expired API key. |
| 403 | forbidden | API key is valid but not allowed to call this endpoint. |
| 429 | rate limit exceeded | Per-key rate limit exceeded. |
| 500 | internal server error | Unexpected backend error. |
Notes
- Integrator API keys are created through the wallet-signed onboarding flow and may require Rialto approval before activation.
- API keys may be scoped to quote-only, execution, or integrator access, and may have rate limits or expiry.
- Quotes depend on live liquidity and may become stale quickly. Request a fresh quote if the user waits.
- In direct flow, submit transactions from the taker wallet. In gasless flow, the taker signs Permit2 and Rialto relays the transaction.