API Documentation

Authentication

Authorization: Bearer YOUR_API_KEY

Base URL

https://xratesapi.com/api/v1

Error Handling

{
  "success": false,
  "error": {
    "code": 401,
    "message": "Invalid API key."
  }
}

Official SDKs

Check the API status and availability. This endpoint does not require authentication and can be used for health checks and monitoring.

Parameters

No parameters required.

Example Request

curl https://xratesapi.com/api/v1/status

Example Response

{
  "success": true,
  "status": "operational",
  "message": "XRates API is running.",
  "timestamp": "2026-03-09T12:00:00Z"
}

Retrieve the latest exchange rates. Returns the most recent exchange rate data available for the specified base currency and target symbols.

Sources publish on different schedules, so each currency is returned at its own most recent rate. The date field is the newest date in the response. Currencies that no source has updated in the last 7 days are omitted.

Parameters

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://xratesapi.com/api/v1/latest?base=USD&symbols=EUR,GBP"

Example Response

{
  "success": true,
  "base": "USD",
  "date": "2026-03-09",
  "rates": {
    "EUR": 0.9214,
    "GBP": 0.7843
  }
}

Retrieve historical exchange rates for a specific date. The date must be provided in YYYY-MM-DD format.

Weekends and holidays. Central banks don't publish rates on weekends and public holidays. For those dates each currency carries its last published rate from up to 7 days earlier — a Saturday returns Friday's rates, Easter Monday returns the Thursday before. The response date is the date you requested. A date in the future, or with no data in the 7 days before it, returns 404.

Parameters

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://xratesapi.com/api/v1/2026-03-01?base=USD&symbols=EUR,GBP"

Example Response

{
  "success": true,
  "historical": true,
  "base": "USD",
  "date": "2026-03-01",
  "rates": {
    "EUR": 0.8621,
    "GBP": 1.3298
  }
}

Retrieve a list of all supported currencies with their full names. Useful for building currency selectors and validating currency codes.

Parameters

No parameters required.

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://xratesapi.com/api/v1/currencies"

Example Response

{
  "success": true,
  "currencies": {
    "USD": "United States Dollar",
    "EUR": "Euro",
    "GBP": "British Pound Sterling",
    "JPY": "Japanese Yen",
    "CHF": "Swiss Franc",
    "CAD": "Canadian Dollar",
    "AUD": "Australian Dollar",
    "CNY": "Chinese Yuan",
    "RUB": "Russian Ruble",
    "..."
  }
}

Convert an amount from one currency to another using the latest exchange rates, or the rates of a past date. Returns both the converted amount and the exchange rate used. A weekend or holiday date uses the last published rates, the same way as historical rates.

Parameters

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://xratesapi.com/api/v1/convert?from=USD&to=EUR&amount=100"

Example Response

{
  "success": true,
  "query": {
    "from": "USD",
    "to": "EUR",
    "amount": 100
  },
  "info": {
    "rate": 0.9214,
    "timestamp": "2026-03-09T12:00:00Z"
  },
  "date": "2026-03-09",
  "result": 92.14
}

Retrieve daily exchange rates between two dates. Useful for building charts and analyzing currency trends over time. Maximum date range is 365 days. Every calendar day in the range is included: weekends and holidays carry the last published rate, so there are no gaps in the series.

Parameters

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://xratesapi.com/api/v1/timeseries?start_date=2026-01-01&end_date=2026-01-31&base=USD&symbols=EUR"

Example Response

{
  "success": true,
  "timeseries": true,
  "base": "USD",
  "start_date": "2026-01-01",
  "end_date": "2026-01-31",
  "rates": {
    "2026-01-01": {
      "EUR": 0.8612
    },
    "2026-01-02": {
      "EUR": 0.8625
    },
    "2026-01-03": {
      "EUR": 0.8598
    },
    "...": "..."
  }
}

Retrieve currency fluctuation data between two dates. Returns the start rate, end rate, change amount, and change percentage for each specified currency. Maximum date range is 365 days. If a start or end date falls on a weekend or holiday, the last rate published before it is used.

Parameters

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://xratesapi.com/api/v1/fluctuation?start_date=2026-01-01&end_date=2026-01-31&base=USD&symbols=EUR"

Example Response

{
  "success": true,
  "fluctuation": true,
  "base": "USD",
  "start_date": "2026-01-01",
  "end_date": "2026-01-31",
  "rates": {
    "EUR": {
      "start_rate": 0.8612,
      "end_rate": 0.9214,
      "change": 0.0042,
      "change_pct": 0.4878
    }
  }
}