Skip to main content
The swap APIs return the following errors when a request cannot be fulfilled.

React and React Native request errors

The swap method from useSwap rejects its Promise if signing or request submission fails. If signing takes longer than the request expiry window, the hook throws a PrivyClientError with code embedded_wallet_request_expired. This can happen when a mobile app is backgrounded during signing. Prompt the user to retry; the expired request is not submitted. For failures after action creation, see execution errors and action status polling.

Validation errors

Routing errors

Execution errors

A swap that passes validation is accepted as a wallet action and executed asynchronously. The following conditions are not returned on the request — they surface as a rejected wallet action, before anything is submitted on-chain. Poll the wallet action or subscribe to the swap.rejected webhook to detect them.