API Documentation

Endpoint

Response Format

{
  "success": true,
  "base": "USD",
  "rate_as_of": "2026-07-17",
  "retrieved_at": "2026-07-17T09:00:00.000Z",
  "checked_at": "2026-07-17T10:00:00.000Z",
  "rate_type": "daily_reference",
  "stale": false,
  "stale_reason": null,
  "source": {
    "name": "currency-api",
    "url": "https://github.com/fawazahmed0/exchange-api",
    "mirror": "https://latest.currency-api.pages.dev/v1/currencies/usd.min.json",
    "license": "CC0-1.0"
  },
  "rates": {
    "USD": 1,
    "EUR": 0.92,
    "GBP": 0.79,
    "INR": 83.12,
    "JPY": 149.50,
    "BTC": 0.0000145,
    "ETH": 0.000312
  }
}

Rate Limits & Caching

• ✓ No API key required
• ✓ Daily source snapshot; each successful retrieval is cached for up to one hour
• ✓ CORS enabled — works from any domain
• ✓ Base currency is always USD
• i Versioned OpenAPI document at /api/v1/openapi.json

Code Examples

const res = await fetch("https://usdconverter.com/api/v1/rates");
const data = await res.json();

// Convert 100 USD to EUR
const usdToEur = data.rates.EUR;
const result = 100 * usdToEur;
console.log(`100 USD = ${result.toFixed(2)} EUR`);

import requests

data = requests.get("https://usdconverter.com/api/v1/rates").json()
rates = data["rates"]

# Convert 100 USD to INR
usd_to_inr = rates["INR"]
result = 100 * usd_to_inr
print(f"100 USD = {result:.2f} INR")

curl -s https://usdconverter.com/api/v1/rates | jq '{rate_as_of, retrieved_at, checked_at, stale, eur: .rates.EUR}'

// Convert 500 EUR to GBP
const eurRate = data.rates.EUR; // EUR per 1 USD
const gbpRate = data.rates.GBP; // GBP per 1 USD
const eurToGbp = gbpRate / eurRate;
const result = 500 * eurToGbp;

Source, freshness, and license

The API serves the latest available daily reference snapshot from the currency-api CC0 dataset. rate_as_of is the source dataset date; retrieved_at is the snapshot's last successful fetch time; and checked_at is USDConverter's latest source-check time. None is a live-market timestamp. source.mirror identifies the mirror used for the successful snapshot. When stale is true, stale_reason distinguishes an old source date from a bounded cached fallback. Values are informational, not executable transaction quotes.