Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.exchangeratesapi.com.au/llms.txt

Use this file to discover all available pages before exploring further.

​
Get Your API Key

1

Sign Up

Visit app.exchangeratesapi.com.au and sign up using your email address.
No credit card required for the free tier (300 requests/month)
2

Verify Your Email

Check your email inbox and click the magic link to verify your account. This will automatically log you into the dashboard.
3

Generate API Key

In the dashboard, click “Generate New API Key”. Your API key will have a unique prefix (e.g., buderim_abc123...).
Copy your API key immediately - it’s only shown once for security reasons
4

Make Your First Request

Test your API key with a simple request to get the latest exchange rates:
curl https://api.exchangeratesapi.com.au/latest \
  -H "Authorization: Bearer your_api_key_here"

​
Your First API Call

Let’s start with the most common use case - getting current exchange rates: 
curl https://api.exchangeratesapi.com.au/latest \
  -H "Authorization: Bearer your_api_key_here"

​
Expected Response

{
  "success": true,
  "timestamp": 1725080400,
  "base": "AUD",
  "date": "2025-08-31",
  "rates": {
    "USD": 0.643512,
    "EUR": 0.562934,
    "GBP": 0.487421,
    "JPY": 96.832100,
    "NZD": 1.094200,
    "CAD": 0.893421,
    "CHF": 0.578234,
    "CNY": 4.623451,
    "TWI": 60.500000
  }
}

​
Currency Conversion

Convert amounts between currencies: 
curl "https://api.exchangeratesapi.com.au/convert?from=AUD&to=USD&amount=100" \
  -H "Authorization: Bearer your_api_key_here"

​
Conversion Response

{
  "success": true,
  "query": {
    "from": "AUD",
    "to": "USD",
    "amount": 100
  },
  "info": {
    "timestamp": 1725080400,
    "rate": 0.643512
  },
  "date": "2025-08-31",
  "result": 64.3512
}

​
Historical Data

Get exchange rates from any date since 2018: 
curl https://api.exchangeratesapi.com.au/2024-12-01 \
  -H "Authorization: Bearer your_api_key_here"

​
Error Handling

Always check the success field in responses: 
const response = await fetch('https://api.exchangeratesapi.com.au/latest', {
  headers: {
    'Authorization': 'Bearer your_api_key_here'
  }
});

const data = await response.json();

if (!data.success) {
  switch (data.error.code) {
    case 401:
      console.error('Invalid API key');
      break;
    case 429:
      console.error('Rate limit exceeded');
      break;
    case 400:
      console.error('Bad request:', data.error.info);
      break;
    default:
      console.error('API error:', data.error.info);
  }
} else {
  // Process successful response
  console.log('Current rates:', data.rates);
}

​
Free Tier Testing

Want to try the API without signing up? Use our free conversion endpoint (3 requests/hour per IP): 
curl "https://api.exchangeratesapi.com.au/convert?from=AUD&to=USD&amount=100"
# No authentication required for free tier

​
Next Steps

API Reference

Explore all available endpoints and parameters

Authentication

Learn about API key security and best practices

Rate Limits

Understand plan limits and upgrade options

SDKs

Use our official SDKs for popular languages