API Documentation — LiveCurrencyRate

Getting Started

The LiveCurrencyRate API provides free access to exchange rates for 191 currencies. All responses are JSON. Sign up for a free API key to start making requests.

BASE URL https://www.livecurrencyrate.com/api

Authentication

All API requests to /api/rates and /api/convert require an API key via the X-API-KEY header.

Header

X-API-KEY: your_api_key_here

Sign up free to get your API key — 100 requests/day included.

GET /api/rates

Retrieve live exchange rates for a given base currency. Returns all available target currencies with their current rates.

Parameters

base

string

Optional

ISO 4217 currency code. Defaults to USD.

Request

HTTP

GET https://www.livecurrencyrate.com/api/rates?base=USD
X-API-KEY: your_api_key_here

Response 200 OK

JSON

{
  "base": "USD",
  "rates": {
    "EUR": 0.924185,
    "GBP": 0.792341,
    "JPY": 149.856200,
    "AED": 3.672500,
    // ... 191 currencies
  },
  "updated_at": "2026-03-23T10:00:00+00:00"
}

Error 503

JSON

{
  "error": "Service temporarily unavailable. Please try again later."
}

GET /api/convert

Convert a specific amount from one currency to another.

Parameters

from

string

Required

Source currency code (e.g. USD).

to

string

Required

Target currency code (e.g. EUR).

amount

number

Required

Amount to convert. Must be > 0.01.

Request

HTTP

GET https://www.livecurrencyrate.com/api/convert?from=USD&to=EUR&amount=100
X-API-KEY: your_api_key_here

Response 200 OK

JSON

{
  "base": "USD",
  "target": "EUR",
  "amount": 100,
  "rate": 0.924185,
  "converted": 92.42
}

Error 422

JSON

{
  "error": "Invalid currency. Please check your currency codes."
}

GET /api/currencies Public — no key needed

Get a sorted list of all supported currency codes.

Parameters

No parameters required.

Request

HTTP

GET https://www.livecurrencyrate.com/api/currencies

Response 200 OK

JSON

{
  "currencies": [
    "AED", "AFN", "ALL", "AMD",
    // ... 191 currencies
    "ZMW", "ZWL"
  ]
}

Error 503

JSON

{
  "error": "Service temporarily unavailable. Please try again later."
}

Code Examples

JavaScript — Fetch API

const API_KEY = 'your_api_key_here';

// Get exchange rates
const response = await fetch('https://www.livecurrencyrate.com/api/rates?base=USD', {
    headers: { 'X-API-KEY': API_KEY }
});
const data = await response.json();
console.log(data.rates.EUR); // 0.924185

// Convert currency
const convert = await fetch('https://www.livecurrencyrate.com/api/convert?from=USD&to=EUR&amount=100', {
    headers: { 'X-API-KEY': API_KEY }
});
const result = await convert.json();
console.log(result.converted); // 92.42

Python — Requests

import requests

API_KEY = 'your_api_key_here'
headers = {'X-API-KEY': API_KEY}

# Get exchange rates
response = requests.get('https://www.livecurrencyrate.com/api/rates',
    params={'base': 'USD'}, headers=headers)
rates = response.json()['rates']
print(rates['EUR'])  # 0.924185

# Convert currency
response = requests.get('https://www.livecurrencyrate.com/api/convert', params={
    'from': 'USD',
    'to': 'EUR',
    'amount': 100
}, headers=headers)
result = response.json()
print(result['converted'])  # 92.42

PHP — file_get_contents

$apiKey = 'your_api_key_here';
$opts = ['http' => ['header' => "X-API-KEY: $apiKey\r\n"]];
$ctx = stream_context_create($opts);

// Get exchange rates
$response = file_get_contents('https://www.livecurrencyrate.com/api/rates?base=USD', false, $ctx);
$data = json_decode($response, true);
echo $data['rates']['EUR']; // 0.924185

// Convert currency
$url = 'https://www.livecurrencyrate.com/api/convert' . '?' . http_build_query([
    'from' => 'USD',
    'to' => 'EUR',
    'amount' => 100
]);
$result = json_decode(file_get_contents($url, false, $ctx), true);
echo $result['converted']; // 92.42

Bash — cURL

# Get exchange rates
curl -H "X-API-KEY: your_api_key_here" \
  "https://www.livecurrencyrate.com/api/rates?base=USD"

# Convert currency
curl -H "X-API-KEY: your_api_key_here" \
  "https://www.livecurrencyrate.com/api/convert?from=USD&to=EUR&amount=100"

# List all currencies (no API key needed)
curl "https://www.livecurrencyrate.com/api/currencies"

HTTP Status Codes

200

OK

Request successful. Response body contains the data.

401

Unauthorized

Missing or invalid API key. Include a valid X-API-KEY header.

403

Forbidden

Account restricted or email not verified. Contact support.

422

Unprocessable Entity

Invalid parameters — missing required fields or invalid currency codes.

429

Too Many Requests

Daily request limit exceeded (100/day). Resets at midnight UTC.

503

Service Unavailable

Rate data is temporarily unavailable. Retry after a few moments.

Notes & Limits

Update Frequency

Rates refreshed every 3 hours from trusted financial data providers.

Rate Limit

100 requests per day per API key. Counter resets at midnight UTC.

Currency Codes

All codes follow the ISO 4217 standard (3 uppercase letters, e.g. USD, EUR, GBP).

Reliability

High-availability infrastructure ensures 99.9% uptime.