Errors

Error shape

Errors are returned as JSON:

{ "error": "<message>" }

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.

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.