Troubleshooting

When working with 0x Cross Chain API, you may encounter some common issues. Below are tips to help diagnose and resolve them:

Issue	Possible Cause	Suggested Fix
Transaction fails or gets dropped	Insufficient SOL/ETH/etc. for gas fees, network congestion, insufficient balance or allowance	Ensure your wallet has enough SOL/ETH for fees, ensure you have enough balance for the trade, ensure you set proper allowance (see issues in API response)
Signature verification errors	Wrong signer, unsigned transaction, or corrupted transaction data	Verify the transaction is signed by the correct keypair (or keypairs)
RPC timeout or errors during transaction submission	Network issues or overloaded RPC node	Try switching to a different RPC endpoint or add retries
Unexpected API errors or bad responses	Incorrect API key or malformed request payload	Double-check API keys, endpoint URLs, and request parameters

Debugging Tips

• Log your transaction hash and monitor it on corresponding transaction explorer (e.g. Basescan)

• Check API response error messages carefully; they often indicate what went wrong.

• Make sure to monitor the status of your transaction via /status endpoint. Sometimes it might take more time to complete or refund a cross chain transfer.

If you continue to experience issues, consider reaching out to the 0x developer support for assistance.