Troubleshooting

Common issues and solutions for WheelX API integration.

HTTP Error Codes

Code	Meaning	Solution
400	Bad Request	Check request body format and required parameters
404	Not Found	Verify order ID or endpoint path
429	Rate Limited	Implement exponential backoff
500	Server Error	Retry with backoff; contact support if persistent

Common Scenarios

Quote Returns Empty

• Verify chain IDs and token addresses are correct
• Check that the token pair is supported
• Try a smaller amount if liquidity is insufficient

Order Stuck in Processing

• Cross-chain transactions may take several minutes
• Check the source chain block explorer
• Contact support if pending > 30 minutes

Webhook Not Firing

• Verify webhook URL is accessible
• Check webhook secret configuration
• Ensure events are properly subscribed