xe.com APIxe.com ↗
Access live mid-market rates, currency conversion, historical time-series, and currency metadata from xe.com across 7 endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/09357179-44fd-4bda-a0b3-32f011cff868/get_all_rates' \ -H 'X-API-Key: $PARSE_API_KEY'
Get all mid-market exchange rates relative to USD. Returns a timestamp and a rates object mapping currency codes to their USD-relative rate.
No input parameters required.
{
"type": "object",
"fields": {
"rates": "object mapping currency codes (e.g. EUR, GBP, JPY) to their exchange rate relative to 1 USD",
"timestamp": "integer, Unix timestamp in milliseconds"
},
"sample": {
"data": {
"rates": {
"EUR": 0.8588873473,
"GBP": 0.7476199689,
"JPY": 158.4491134924,
"USD": 1
},
"timestamp": 1778843160000
},
"status": "success"
}
}About the xe.com API
The XE.com API exposes 7 endpoints covering live mid-market exchange rates, currency conversion, historical chart data, and currency metadata sourced from xe.com. The get_all_rates endpoint returns rates for every supported currency relative to USD in a single call, while get_live_exchange_rate computes cross-rates for any arbitrary pair on demand. Coverage includes fiat currencies, cryptocurrencies, and obsolete currencies flagged through the get_currency_symbols endpoint.
Live Rates and Currency Conversion
The get_live_exchange_rate endpoint accepts from, to, and an optional amount parameter, returning mid_market_rate, converted_amount, and a millisecond-precision timestamp. The convert_currency endpoint is functionally similar but requires amount, making it the straightforward choice when you always have a conversion quantity. Both return the same six-field response shape. For bulk needs, get_all_rates returns the full rates object mapping every currency code to its USD-relative value alongside a single timestamp.
Historical and Trend Data
get_historical_chart_data takes from and to currency codes and returns a batchList array where each batch contains a startTime, an interval in milliseconds (daily, hourly, or 15-minute granularity), and a rates array of numbers. This lets you reconstruct a multi-resolution time series for a given pair. The get_popular_currency_pairings endpoint accepts an optional base currency and returns current rate, trend direction (up, down, or null), rateChange, and percentageChange for commonly tracked pairs — useful for building dashboards that surface movement at a glance.
Currency Metadata
get_currency_symbols returns an object keyed by currency code. Each entry includes boolean flags: isObsolete, isSellable, isBuyable, and isCrypto (present when applicable). This is the right endpoint for filtering out defunct currencies or separating crypto from fiat before populating a UI selector. get_currency_details maps a single currency code to its ISO 2-letter country code — a small but useful lookup when you need to associate a currency with a specific country for display or routing logic.
- Display live EUR/USD and GBP/JPY rates on a fintech dashboard using
get_live_exchange_rate - Populate a multi-currency checkout with converted totals via
convert_currencywith a specifiedamount - Build a currency trend widget showing rate movement direction and percentage change from
get_popular_currency_pairings - Chart historical exchange rate fluctuations at daily, hourly, and 15-minute resolution using
get_historical_chart_data - Filter a currency selector to exclude obsolete and non-buyable currencies using
isSellableandisObsoleteflags fromget_currency_symbols - Map currency codes to country flags or locales using the
countryfield fromget_currency_details - Sync a full rates snapshot for all currencies in one request with
get_all_ratesfor offline or cached processing
| 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 XE.com have an official developer API?+
What granularities does `get_historical_chart_data` return?+
batchList array where each batch carries a startTime, an interval value in milliseconds, and a rates array. The intervals cover daily, hourly, and 15-minute periods, so you get three overlapping time-series batches in a single response. There are no query parameters to select a specific granularity — all three are returned together.Does `get_popular_currency_pairings` let me specify which pairs to retrieve?+
base currency code can be passed as input; you cannot specify an explicit list of target currencies. The endpoint returns whichever pairings XE.com surfaces as popular for that base. You can fork this API on Parse and revise it to filter or extend the returned pairs to match a custom list.Are bid/ask spread prices or bank transfer rates available?+
get_all_rates, get_live_exchange_rate, and convert_currency — return mid-market rates only. Bid, ask, and retail transfer rates are not exposed. You can fork this API on Parse and revise it to add an endpoint targeting spread or transfer rate data if that surface becomes available.What does the `isCrypto` flag in `get_currency_symbols` cover?+
isCrypto boolean is present on entries that represent cryptocurrency codes rather than fiat currencies. It is only included in the response object when it applies, so its absence on a given currency code indicates fiat. The endpoint does not return additional metadata such as blockchain network, contract address, or trading volume — those fields are not part of the response. You can fork this API on Parse and revise it to add a crypto-specific detail endpoint if needed.