x-rates.com APIx-rates.com ↗
Access current and historical exchange rates, currency conversion, monthly averages, and 24-hour trend data from x-rates.com via a structured JSON API.
curl -X GET 'https://api.parse.bot/scraper/8c172966-02db-4c7c-9e9f-4c9e3f6a8be9/get_current_rates_table?from=EUR&amount=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetches the current exchange rates table for a given base currency against all other supported currencies. Returns rate and inverse rate for each currency pair.
| Param | Type | Description |
|---|---|---|
| from | string | Base currency code (e.g. USD, EUR, GBP). |
| amount | number | Amount to calculate rates for. |
{
"type": "object",
"fields": {
"rates": "array of objects with currency, code, rate, and inverse_rate",
"amount": "number, the amount used for calculation",
"timestamp": "string or null, UTC timestamp of rates",
"base_currency": "string, the base currency code"
},
"sample": {
"data": {
"rates": [
{
"code": "EUR",
"rate": 0.85389,
"currency": "Euro",
"inverse_rate": 1.171111
},
{
"code": "GBP",
"rate": 0.739677,
"currency": "British Pound",
"inverse_rate": 1.351941
}
],
"amount": 1,
"timestamp": "May 14, 2026 09:05 UTC",
"base_currency": "USD"
},
"status": "success"
}
}About the x-rates.com API
This API exposes 7 endpoints covering current exchange rates, historical snapshots, currency conversion, monthly averages, and trend data sourced from x-rates.com. The get_current_rates_table endpoint returns rate and inverse_rate for every supported currency pair against a chosen base currency, while get_24h_percent_changes surfaces direction and magnitude of moves for major pairs over the last 24 hours.
Current and Historical Rate Tables
get_current_rates_table accepts a from base currency code (e.g. USD, EUR, GBP) and an optional amount, returning an array of objects each containing currency, code, rate, and inverse_rate, along with a UTC timestamp and the base_currency used. get_historical_rates_table mirrors this structure but requires a date parameter in YYYY-MM-DD format, making it straightforward to reconstruct the rate environment on any past date supported by x-rates.com.
Conversion and Averages
convert_currency takes from, to, and an optional amount and returns both a numeric converted_value and a result_text string (e.g. '85.389017EUR'). get_monthly_average accepts a currency pair and an optional year (defaults to the current year), returning a monthly_averages array where each entry includes month, average_rate, and days — useful for period-over-period analysis without needing to aggregate daily snapshots yourself.
Trend Data and 24-Hour Changes
get_graph_data returns data_points for the current year, each with a label (month abbreviation) and a rate, giving a year-to-date picture of a currency pair's movement. get_24h_percent_changes requires no inputs and delivers a trends array with pair, change, and direction for major pairs, plus a UTC timestamp. get_supported_currencies returns the complete list of currency names and codes with a total count.
- Display a live multi-currency rate card using
get_current_rates_tablewith a user-selected base currency - Back-fill historical portfolio valuations by querying
get_historical_rates_tablefor specific past dates - Build a currency converter widget using
convert_currencywithfrom,to, andamountinputs - Generate monthly exchange rate trend charts using
get_monthly_averagedata across multiple years - Show year-to-date rate movement graphs by plotting
data_pointsfromget_graph_data - Alert users to significant FX moves by monitoring
changeanddirectionfromget_24h_percent_changes - Populate a currency selector dropdown by fetching the full list from
get_supported_currencies
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does x-rates.com have an official developer API?+
What does `get_monthly_average` return, and does it cover multiple years in a single call?+
monthly_averages array for one currency pair and one year at a time. Each entry includes month, average_rate, and days. To compare across years you need to make one call per year using the year parameter in YYYY format.Does the API expose tick-level or intraday rate data?+
How current is the `timestamp` returned by the rate endpoints?+
timestamp field reflects the UTC time of the rate snapshot as reported by x-rates.com. It can be null if no timestamp is present in the source data for that request. The site updates rates periodically rather than in real time, so the timestamp may lag the true market rate by some minutes.Does the API support currency cross-rates not involving USD as a base?+
get_current_rates_table and get_historical_rates_table accept any supported currency in the from parameter, not just USD. You can retrieve a list of all valid codes with get_supported_currencies. Cross-rate accuracy depends on what x-rates.com publishes for that base currency.