Errors and rate limits

Common failure modes and how clients should react.

Common errors

• Validation errors: invalid chain/token/amount.

• Route unavailable: no candidates pass validation.

• Execution blocked: slippage, health gate, or safety checks.

• Temporary upstream failures: engine degraded.

Client guidance

• Treat quote calls as non-idempotent only when they trigger execution.

• Retry quote requests with backoff.

• Do not retry executions blindly.

Rate limits

Apply limits per:

• IP (baseline)

• API key (developer usage)

• wallet (abuse prevention)