Documentation
Everything you need to integrate real-time exchange rates.
Quickstart
Get your first API call working in 2 minutes
API Reference
All endpoints, parameters, and response shapes
Currencies
31 currencies supported on day one
Webhooks
Get notified on rate changes
What is xchangr8?
xchangr8 is a fast, reliable exchange rate API built for developers. It provides real-time and historical foreign exchange data for 31 currencies, powered by institutional-grade sources. A single HTTP request gives you fresh rates, conversion results, and time-series data — with sub-100ms response times at the edge.
Whether you are building an e-commerce checkout, a fintech dashboard, or a travel app, xchangr8 handles the FX data layer so you don't have to.
| Base URL | https://api.xchangr8.com |
| Current version | v1 |
| Authentication | API key via X-API-Key header |
| Response format | JSON |
| Update frequency | Every 60 seconds (Starter+), every 10 min (Free) |
Response format
Every response from /v1/latest follows this shape:
# Fetch latest rates with USD as base curl https://api.xchangr8.com/v1/latest \ -H "X-API-Key: xc8_live_YOUR_KEY"
const res = await fetch( 'https://api.xchangr8.com/v1/latest?base=USD', { headers: { 'X-API-Key': 'xc8_live_YOUR_KEY' } } ) const { rates } = await res.json() console.log(`1 USD = ${rates.EUR} EUR`)
import requests r = requests.get( 'https://api.xchangr8.com/v1/latest', params={'base': 'USD'}, headers={'X-API-Key': 'xc8_live_YOUR_KEY'} ) data = r.json()
{ "base": "USD", "timestamp": 1749340800, "freshness": "1m ago", "source": "fastforex", "rates": { "EUR": 0.9201, "GBP": 0.7823, "JPY": 149.85, "AUD": 1.5412 } }