> ## Documentation Index
> Fetch the complete documentation index at: https://docs.houdiniswap.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Error Codes & Troubleshooting
> Common errors, their causes, and how to resolve them
## Error Response Format
All API errors return a JSON object with the following structure:
```json theme={null}
{
"name": "Error",
"message": "Error message",
"code": 500
}
```
| Field | Description |
| --------- | --------------------------------- |
| `name` | Always `"Error"` |
| `message` | Human-readable error description |
| `code` | HTTP status code (400, 500, etc.) |
Use the `message` field to understand the specific error. The `code` field reflects the HTTP status code.
***
## Common Errors
### Token & Address Errors
| Message | Solution |
| --------------------------------------------- | ------------------------------------------------------------------------- |
| Unsupported `from` Token | Check `/tokens?hasCex=true` or `/tokens?hasDex=true` for supported tokens |
| Unsupported `to` Token | Check `/tokens?hasCex=true` or `/tokens?hasDex=true` for supported tokens |
| addressTo is invalid | Validate using `addressValidation` regex from `/chains` |
| addressFrom is invalid | Validate using `addressValidation` regex from `/chains` |
| `to` and `from` cannot be both the same token | From and To tokens only able to be the same token if private |
| Token not found | Token ID/symbol doesn't exist |
| Network not found | Check `/chains` for supported networks |
| Address is not valid for this chain | Validate using `addressValidation` regex from `/chains` |
### Quote & Amount Errors
| Message | Solution |
| -------------------------------------------- | ------------------------------------------------------------ |
| Invalid Quote | Quote expired or invalid, request a new one |
| Path is invalid | Route not available, try different pair |
| `amount` is out of bounds for swap | Check `min` and `max` from quote response |
| Unable to perform exchange, quote over X USD | Reduce swap amount |
| Amount is too low, minimum is X USD | Increase swap amount |
| Could not retrieve price quotes | Try different amount or pair. For Private mode, try Standard |
### Order Errors
| Message | Solution |
| --------------- | ----------------------------- |
| Order not found | Verify `houdiniId` is correct |
| Swap not found | Swap ID doesn't exist |
### Exchange & Routing Errors
| Message | Solution |
| -------------------------------------------------------------------------------- | ------------------------------------------ |
| Unable to perform exchange, no available paths | Try different pair or amount |
| Unable to perform exchange, no available paths. Tip: try toggling OFF Exact mode | Disable fixed/exact mode |
| Unable to generate swap\_hop\_1 (anon) | Private routing failed - try Standard swap |
| Unable to generate swap\_hop\_2 (anon) | Private routing failed - try Standard swap |
### Authentication & Account Errors
| Message | Solution |
| -------------------------- | -------------------------- |
| Please define your API key | Add `Authorization` header |
| Incorrect credentials | Verify API key and secret |
### Service Errors
| Message | Solution |
| --------------------------------------------- | ------------------------------------ |
| Something went wrong. Please contact support! | Retry or contact support |
| Your request has timed-out | Retry the request |
| Services temporary unavailable | Wait and retry |
| Anonymous exchanges are temporarily disabled | Use Standard swap or contact support |
### DEX-Specific Errors
| Message | Solution |
| ------------------------------------- | ------------------------------------------------ |
| This chain is currently not supported | Check `/tokens?hasDex=true` for supported chains |
| Swap not supported | Pair not available for DEX swap |
***
## HTTP Status Codes
| Status | Meaning | Common Causes |
| ------- | --------------------- | ---------------------------------- |
| **400** | Bad Request | Invalid parameters, malformed JSON |
| **401** | Unauthorized | Missing or invalid API credentials |
| **403** | Forbidden | API key lacks permissions |
| **404** | Not Found | Resource doesn't exist |
| **429** | Too Many Requests | Rate limit exceeded |
| **500** | Internal Server Error | Server-side issue |
| **503** | Service Unavailable | Maintenance or partner downtime |
***
## Need Help?
Complete endpoint documentation
Understand order states
Integration guides for each swap type
Get help with specific issues