Currency Exchange API

API Endpoints

All endpoints return JSON with a consistent { success, data } wrapper. Authenticate via X-API-Key header or ?apikey= query parameter.

curl -H "X-API-Key: YOUR_KEY" \
  "https://currency-api.YOUR_DOMAIN.workers.dev/v1/rates?base=USD"

curl -H "X-API-Key: YOUR_KEY" \
  "https://currency-api.YOUR_DOMAIN.workers.dev/v1/convert?from=USD&to=EUR&amount=100"

curl -H "X-API-Key: YOUR_KEY" \
  "https://currency-api.YOUR_DOMAIN.workers.dev/v1/currencies"

curl -H "X-API-Key: YOUR_KEY" \
  "https://currency-api.YOUR_DOMAIN.workers.dev/v1/historical?date=2024-01-15&base=USD"

curl -H "X-API-Key: YOUR_KEY" \
  "https://currency-api.YOUR_DOMAIN.workers.dev/v1/timeseries?start=2024-01-01&end=2024-01-31&base=USD&symbols=EUR,GBP"

curl -H "X-API-Key: YOUR_KEY" \
  "https://currency-api.YOUR_DOMAIN.workers.dev/v1/fluctuation?start=2024-01-01&end=2024-01-31&base=USD&symbols=EUR,GBP,JPY"

Code Examples

Quick integration examples in popular languages.

JavaScript (fetch)

const response = await fetch('https://currency-api.YOUR_DOMAIN.workers.dev/v1/convert?from=USD&to=EUR&amount=100', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const { data } = await response.json();
console.log(`${data.amount} ${data.from} = ${data.result} ${data.to}`);

Python (requests)

import requests

resp = requests.get(
    "https://currency-api.YOUR_DOMAIN.workers.dev/v1/rates",
    params={"base": "EUR"},
    headers={"X-API-Key": "YOUR_API_KEY"}
)
rates = resp.json()["data"]["rates"]
print(f"EUR to USD: {rates['USD']}")

RapidAPI (JavaScript)

const response = await fetch('https://currency-exchange-api.p.rapidapi.com/v1/convert?from=USD&to=JPY&amount=1000', {
  headers: {
    'x-rapidapi-key': 'YOUR_RAPIDAPI_KEY',
    'x-rapidapi-host': 'currency-exchange-api.p.rapidapi.com'
  }
});

Simple, Transparent Pricing

Start free, scale as you grow. All plans include every endpoint.