CurrencyBeaconCurrencyBeacon exchange-rate API
GET/timeseries
Get an exchange-rate time series
Returns daily rates for a requested date range.
Query latest, historical, conversion, time-series, and supported-currency data with caller-owned CurrencyBeacon credentials.
Request
- operationId
getTimeseries- Server
https://api.currencybeacon.com/v1- Authentication
- apiKey
Request parameters
start_date
querystringdaterequired
Time-series start date in YYYY-MM-DD format.
2025-01-02
end_date
querystringdaterequired
Time-series end date in YYYY-MM-DD format; it must not precede the start date.
2025-01-02
base
querystring
Three-letter base currency code; the service defaults to USD when it is omitted.
USD
symbols
querystring
Optional comma-separated currency-code list used to limit returned rates.
EUR,GBP
Responses
200
TimeseriesResponseapplication/json
Request succeeded and returns this Endpoint's JSON response.
Properties: metaresponse
400
ErrorResponseapplication/json
The request parameters are invalid.
Properties: messagemetaresponse
401
ErrorResponseapplication/json
The caller credential is missing, invalid, or not activated.
Properties: messagemetaresponse
403
ErrorResponseapplication/json
The caller plan or permission does not allow this request.
Properties: messagemetaresponse
404
ErrorResponseapplication/json
The requested Endpoint or resource does not exist.
Properties: messagemetaresponse
429
ErrorResponseapplication/json
The caller exceeded a service quota or rate limit.
Properties: messagemetaresponse
500
ErrorResponseapplication/json
The upstream service encountered an internal error.
Properties: messagemetaresponse
{
"meta": {
"code": 200,
"disclaimer": "Usage subject to terms: https://currencybeacon.com/terms"
},
"response": {}
}