SearchCtrl+K

APIs/Currency APIs/Currency Time Series/Reference

Currency Time Series API Reference

Retrieve day-by-day historical exchange rates for a custom date range. Returns a list of daily rate snapshots for all requested currency symbols, ordered chronologically.

GEThttps://api.apifreaks.com/v1.0/currency/time-series

Test

startDate is required (YYYY-MM-DD). endDate defaults to yesterday if omitted. Pass symbols to filter specific currencies and base to change the base currency (default: USD).

Getting Started

Authentication

Authorize every request with your API key, passed either as a header or as a query parameter:

Header - X-apiKey
Query parameter - apiKey

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/currency/time-series?startDate=2025-01-01' \
  -H 'X-apiKey: API-KEY'

Response

{
  "startDate": "2025-01-01",
  "endDate": "2025-01-07",
  "base": "USD",
  "historicalRatesList": [
    {
      "date": "2025-01-01",
      "rates": {
        "EUR": "0.96605",
        "PKR": "278.4"
      }
    },
    {
      "date": "2025-01-02",
      "rates": {
        "EUR": "0.9739",
        "PKR": "278.4"
      }
    },
    {
      "date": "2025-01-03",
      "rates": {
        "EUR": "0.97005",
        "PKR": "278.4"
      }
    },
    {
      "date": "2025-01-04",
      "rates": {
        "EUR": "0.97005",
        "PKR": "278.4"
      }
    },
    {
      "date": "2025-01-05",
      "rates": {
        "EUR": "0.9704",
        "PKR": "278.4"
      }
    },
    {
      "date": "2025-01-06",
      "rates": {
        "EUR": "0.96305",
        "PKR": "278.4"
      }
    },
    {
      "date": "2025-01-07",
      "rates": {
        "EUR": "0.967",
        "PKR": "278.4"
      }
    }
  ]
}

API Request

Query Parameters

startDate is required. All other parameters are optional. The maximum date range is 1 year (365 days).

formatoptionalStringdefault: json

Response format: `json` (default) or `xml`.

startDaterequiredString

Start date in `YYYY-MM-DD` format. Required. Must be on or before yesterday.

endDateoptionalStringdefault: Yesterday

End date in `YYYY-MM-DD` format. Defaults to yesterday. Maximum range is 1 year (365 days).

baseoptionalStringdefault: USD

Base currency code. Defaults to `USD`. Supports fiat, crypto, and metals.

symbolsoptionalArray

Comma-separated currency codes. Omit to get all available rates.

API Response Schema

A successful request returns 200 OK with a chronological list of daily exchange rate snapshots.

startDate

Stringmandatory

Start date of the time series interval (YYYY-MM-DD).

endDate

Stringmandatory

End date of the time series interval (YYYY-MM-DD).

base

Stringmandatory

Base currency code. Always uppercase.

date (String), rates (Object)

Custom Response Headers

Besides the response body, every response carries custom headers you can use to track credit usage, and concurrency usage on endpoints that enforce a concurrency limit. See the Custom Response Headers documentation and the endpoints with concurrency limits for more details.

X-Concurrent-Threadsheaderconcurrency-limited endpoints

Specifies the maximum number of concurrent requests allowed.

X-Concurrent-Threads-Activeheaderconcurrency-limited endpoints

Indicates the number of active concurrent requests being processed.

X-AF-Credits-Costheaderall responses

Specifies the number of credits consumed by the current request.

Error Status & Codes

See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.

400

You can only retrieve time series data for a maximum interval of 1 Year

400

Starting date cannot be after current date or ending date

400

Provided Dates are in Invalid Format. Dates must be in a valid format YYYY-MM-DD!

404

Rates of provided base and symbols are not found for given intervals.

Currency Time Series API Reference

Retrieve day-by-day historical exchange rates for a custom date range. Returns a list of daily rate snapshots for all requested currency symbols, ordered chronologically.

GEThttps://api.apifreaks.com/v1.0/currency/time-series

Test

startDate is required (YYYY-MM-DD). endDate defaults to yesterday if omitted. Pass symbols to filter specific currencies and base to change the base currency (default: USD).

Getting Started

Authentication

Authorize every request with your API key, passed either as a header or as a query parameter:

Header - X-apiKey
Query parameter - apiKey

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/currency/time-series?startDate=2025-01-01' \
  -H 'X-apiKey: API-KEY'

Response

{
  "startDate": "2025-01-01",
  "endDate": "2025-01-07",
  "base": "USD",
  "historicalRatesList": [
    {
      "date": "2025-01-01",
      "rates": {
        "EUR": "0.96605",
        "PKR": "278.4"
      }
    },
    {
      "date": "2025-01-02",
      "rates": {
        "EUR": "0.9739",
        "PKR": "278.4"
      }
    },
    {
      "date": "2025-01-03",
      "rates": {
        "EUR": "0.97005",
        "PKR": "278.4"
      }
    },
    {
      "date": "2025-01-04",
      "rates": {
        "EUR": "0.97005",
        "PKR": "278.4"
      }
    },
    {
      "date": "2025-01-05",
      "rates": {
        "EUR": "0.9704",
        "PKR": "278.4"
      }
    },
    {
      "date": "2025-01-06",
      "rates": {
        "EUR": "0.96305",
        "PKR": "278.4"
      }
    },
    {
      "date": "2025-01-07",
      "rates": {
        "EUR": "0.967",
        "PKR": "278.4"
      }
    }
  ]
}

API Request

Query Parameters

startDate is required. All other parameters are optional. The maximum date range is 1 year (365 days).

formatoptionalStringdefault: json

Response format: `json` (default) or `xml`.

startDaterequiredString

Start date in `YYYY-MM-DD` format. Required. Must be on or before yesterday.

endDateoptionalStringdefault: Yesterday

End date in `YYYY-MM-DD` format. Defaults to yesterday. Maximum range is 1 year (365 days).

baseoptionalStringdefault: USD

Base currency code. Defaults to `USD`. Supports fiat, crypto, and metals.

symbolsoptionalArray

Comma-separated currency codes. Omit to get all available rates.

API Response Schema

A successful request returns 200 OK with a chronological list of daily exchange rate snapshots.

startDate

Stringmandatory

Start date of the time series interval (YYYY-MM-DD).

endDate

Stringmandatory

End date of the time series interval (YYYY-MM-DD).

base

Stringmandatory

Base currency code. Always uppercase.

date (String), rates (Object)

Custom Response Headers

X-Concurrent-Threadsheaderconcurrency-limited endpoints

Specifies the maximum number of concurrent requests allowed.

X-Concurrent-Threads-Activeheaderconcurrency-limited endpoints

Indicates the number of active concurrent requests being processed.

X-AF-Credits-Costheaderall responses

Specifies the number of credits consumed by the current request.

Error Status & Codes

See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.

400

You can only retrieve time series data for a maximum interval of 1 Year

400

Starting date cannot be after current date or ending date

400

Provided Dates are in Invalid Format. Dates must be in a valid format YYYY-MM-DD!

404

Rates of provided base and symbols are not found for given intervals.

Quick Links

Quick Links

Currency Time Series API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

Error Status & Codes

Quick Links

Quick Links

Currency Time Series API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

Error Status & Codes

Currency Time Series API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

Error Status & Codes

More APIs in This Category

Latest Exchange Rates

Historical Exchange Rates

Currency Converter Latest

Currency Converter Historical

Currency Fluctuation API

IP Currency API

Currency Supported

Currency Symbols

Currency Historical Data Limits

Currency Time Series API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

Error Status & Codes

More APIs in This Category

Latest Exchange Rates

Historical Exchange Rates

Currency Converter Latest

Currency Converter Historical

Currency Fluctuation API

IP Currency API

Currency Supported

Currency Symbols

Currency Historical Data Limits