API Endpoints

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

GET /v1/rates Get all exchange rates for a base currency

Parameter	Type	Default	Description
`base`	string	USD	Base currency code
`symbols`	string	all	Comma-separated currency codes to filter

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

GET /v1/convert Convert an amount between two currencies

Parameter	Type	Required	Description
`from`	string	Yes	Source currency code
`to`	string	Yes	Target currency code
`amount`	number	Yes	Amount to convert

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

GET /v1/currencies List all supported currencies with names

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

GET /v1/historical Get historical rates for a specific date

Parameter	Type	Required	Description
`date`	string	Yes	Date in YYYY-MM-DD format
`base`	string	No	Base currency (default: USD)
`symbols`	string	No	Comma-separated currency codes

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

GET /v1/timeseries Get day-by-day rates over a date range

Parameter	Type	Required	Description
`start`	string	Yes	Start date (YYYY-MM-DD)
`end`	string	Yes	End date (YYYY-MM-DD)
`base`	string	No	Base currency (default: USD)
`symbols`	string	No	Comma-separated currency codes

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"

GET /v1/fluctuation Get rate fluctuations and change percentages

Parameter	Type	Required	Description
`start`	string	Yes	Start date (YYYY-MM-DD)
`end`	string	Yes	End date (YYYY-MM-DD)
`base`	string	No	Base currency (default: USD)
`symbols`	string	No	Comma-separated currency codes

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'
  }
});

Currency Exchange API

API Endpoints

Code Examples

JavaScript (fetch)

Python (requests)

RapidAPI (JavaScript)

Simple, Transparent Pricing