Errors, Limits and Troubleshooting

Status	Shape	Meaning
400	{ "error": "..." }	Missing or invalid request fields.
401	{ "error": "..." }	Missing/invalid X-Client-Id or X-API-Key.
403	{ "error": "..." }	Merchant account or KYC is not approved for API access.
429	{ "error": "...", "usage": "..." }	Rate limit exceeded.
500	{ "error": "..." }	Provider, RPC or route-building failure.

Free tier limits

• 60 requests/minute
• 1,000 requests/day
• 30,000 requests/month

Common fixes

• Use both headers. The client id is public; the API key is secret.
• For cross-chain Solana or Tron routes, always pass toAddress.
• Use supported chain slugs exactly: ethereum, bsc, polygon, arbitrum, base, solana, tron.
• Keep slippageBps between 0 and 1000.