Skip to main content
GET
/
timeseries
Historical Exchange Rates
curl --request GET \
  --url https://api.exchangeratesapi.com.au/timeseries \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "timeseries": true,
  "start_date": "2025-08-01",
  "end_date": "2025-08-31",
  "base": "AUD",
  "rates": {
    "2025-08-01": {
      "USD": 0.642100,
      "EUR": 0.561800,
      "GBP": 0.486200
    },
    "2025-08-02": {
      "USD": 0.644000,
      "EUR": 0.563100,
      "GBP": 0.487500
    },
    "2025-08-05": {
      "USD": 0.643800,
      "EUR": 0.562700,
      "GBP": 0.487100
    }
  }
}

​
Overview

The timeseries endpoint returns historical exchange rates for a specified date range. You can optionally filter for specific currencies and limit the date range to a maximum of 365 days. This is perfect for building charts, analytics, and historical analysis.
This endpoint requires authentication. Get your API key to start making requests.

​
Authentication

​
Authorization
string
required
Bearer token with your API key: Bearer your_api_key_here

​
Query Parameters

​
start_date
string
required
Start date in YYYY-MM-DD format. Must be a valid date from 2018-01-01 onwards.Free Plan: No historical access
Starter Plan: Limited to last 30 days
Paid Plans: Full access from 2018-01-01 onwardsExample: 2025-08-01
​
end_date
string
required
End date in YYYY-MM-DD format. Must be after start_date.Free Plan: No access to timeseries (blocked)
Starter Plan: Maximum 7 days range
Professional Plan: Maximum 90 days range
Business/Enterprise Plans: Maximum 365 days rangeExample: 2025-08-31
​
symbols
string
Comma-separated list of currency codes to filter results (case-insensitive). If omitted, all available currencies are returned.Example: USD,EUR,GBP
​
base
string
Base currency for the rates. Currently only AUD is supported.Default: AUD

​
Request

curl "https://api.exchangeratesapi.com.au/timeseries?start_date=2025-08-01&end_date=2025-08-31" \
  -H "Authorization: Bearer your_api_key_here"

​
Response

{
  "success": true,
  "timeseries": true,
  "start_date": "2025-08-01",
  "end_date": "2025-08-31",
  "base": "AUD",
  "rates": {
    "2025-08-01": {
      "USD": 0.642100,
      "EUR": 0.561800,
      "GBP": 0.486200
    },
    "2025-08-02": {
      "USD": 0.644000,
      "EUR": 0.563100,
      "GBP": 0.487500
    },
    "2025-08-05": {
      "USD": 0.643800,
      "EUR": 0.562700,
      "GBP": 0.487100
    }
  }
}

​
Response Fields

​
success
boolean
Indicates if the request was successful
​
timeseries
boolean
Always true for timeseries responses
​
start_date
string
Start date from the request in YYYY-MM-DD format
​
end_date
string
End date from the request in YYYY-MM-DD format
​
base
string
Base currency (always “AUD”)
​
rates
object
Object with dates as keys and rate objects as values

​
Response Headers

  • Cache-Control: no-store - Response should not be cached
  • X-Request-Id: <uuid> - Unique request identifier for debugging

​
Error Responses

{
  "success": false,
  "error": {
    "code": 400,
    "type": "bad_request",
    "info": "Missing required parameters: start_date, end_date"
  }
}

​
Rate Limits

This endpoint is subject to your plan’s monthly request limits:
PlanMonthly RequestsHistorical Access
Free300Blocked (no access)
Starter5,000Last 30 days
Professional50,000Full history (2018+)
Business500,000Full history (2018+)
Free Plan: No access to timeseries endpoint (blocked)
Starter Plan: 30 days access with 7-day maximum range
Professional Plan: Full history (2018+) with 90-day maximum range
Business/Enterprise Plans: Full history (2018+) with 365-day maximum range

​
Important Notes

  • Weekend & Holiday Gaps: The RBA doesn’t publish rates on weekends or Australian public holidays. Missing dates are not included in the response.
  • Maximum Range: Date ranges cannot exceed 365 days
  • Data Availability: Historical data is available from January 1, 2018 onwards
  • Currency Filtering: Use the symbols parameter to reduce response size and focus on specific currencies
  • Precision: Rates are provided with up to 6 decimal places (varies by currency; IDR and VND are whole numbers from RBA source data)

​
Use Cases

  • Historical Analysis: Analyze currency trends over time
  • Chart Generation: Build time-series charts and graphs
  • Backtesting: Test trading strategies with historical data
  • Reporting: Generate monthly/quarterly currency reports
  • Research: Academic and financial research projects
  • Compliance: ATO reporting with official RBA historical rates

Authorizations

​
Authorization
string
header
required

API key authentication using Bearer token

Query Parameters

​
start_date
string
required

Start date (YYYY-MM-DD)

​
end_date
string
required

End date (YYYY-MM-DD)

​
symbols
string

Comma-separated list of currency codes to filter

​
base
enum<string>
default:AUD

Base currency (currently only AUD supported)

Available options:
AUD

Response

Historical exchange rates

​
success
boolean
required
Example:

true

​
timeseries
boolean
required
Example:

true

​
start_date
string
required
​
end_date
string
required
​
base
string
required
Example:

"AUD"

​
rates
object
required

Object with dates as keys and rate objects as values