> For the complete documentation index, see [llms.txt](https://docs.wheelx.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wheelx.fi/api-and-developer/getting-started/troubleshooting.md).

# 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
