Currency Rates API

Quick Start

1. Create an account or log in
2. Go to API Settings and enable API access
3. Copy your unique API key
4. Make requests to the API endpoint

API Endpoint

Example Request

curl "https://currencypal.net/api/rates/cpk_your_api_key_here?base=CAD"

const response = await fetch('https://currencypal.net/api/rates/YOUR_API_KEY?base=USD');
const data = await response.json();
console.log(data.rates);

$response = file_get_contents('https://currencypal.net/api/rates/YOUR_API_KEY?base=EUR');
$data = json_decode($response, true);
print_r($data['rates']);

Example Response

{
    "success": true,
    "base": "USD",
    "timestamp": "2025-12-13T16:00:00+00:00",
    "rates": {
        "AED": 3.6725,
        "CAD": 1.402,
        "EUR": 0.8605,
        "GBP": 0.7596,
        "JPY": 154.4657,
        ...
    },
    "usage": {
        "requests_used": 15,
        "requests_limit": 50,
        "requests_remaining": 35
    }
}

Error Responses

{
    "success": false,
    "error": "Invalid or inactive API key",
    "code": "INVALID_API_KEY"
}

{
    "success": false,
    "error": "Monthly API request limit reached",
    "code": "RATE_LIMIT_EXCEEDED",
    "limit": 50,
    "used": 50,
    "resets_at": "2025-12-31T23:59:59+00:00"
}

{
    "success": false,
    "error": "Invalid base currency: XYZ",
    "code": "INVALID_CURRENCY"
}

Rate Limits

API request limits are based on your subscription plan and reset on the first day of each month.

Supported Currencies

The API supports 162+ currencies including all major world currencies. Rates are updated regularly from reliable exchange rate sources.

Common currency codes: USD, EUR, GBP, CAD, AUD, JPY, CHF, CNY, INR, MXN, BRL, and many more.