Back to Documentation

Troubleshooting Guide

Quickly diagnose and resolve common FXRateSync API integration issues.

Authentication Errors

401 Unauthorized

The API key is missing or invalid.

  • Ensure you are sending the X-API-Key header with every request.
  • Double-check that your key has no extra spaces or hidden characters.
  • Verify the key in your dashboard and regenerate it if necessary.

Rate Limiting

429 Too Many Requests

You have exceeded the rate limit for your plan.

  • Implement exponential back-off and retries.
  • Upgrade to a higher plan for increased limits.
  • Cache frequent requests to reduce load.

Validation Errors

400 Bad Request

The request parameters are missing or invalid.

  • Check that from and to currency codes are supported.
  • Ensure amount is a positive number.
  • Review the API parameter reference.

Server Errors

5XX Errors

Intermittent server errors can occur during maintenance windows.

  • Retry the request with exponential back-off.
  • Monitor the status page for incidents.

Still Stuck?

Contact our support team at hello@fxratesync.io with your correlation ID, timestamp, and the full error message.