CurrencyBeaconCurrencyBeacon exchange-rate API
GET/historical
Get historical exchange rates
Returns rates for a specified historical date and can be limited by symbols.
Query latest, historical, conversion, time-series, and supported-currency data with caller-owned CurrencyBeacon credentials.
Request
- operationId
getHistoricalRates- Server
https://api.currencybeacon.com/v1- Authentication
- apiKey
Request parameters
date
querystringdaterequired
Date used for a historical lookup or conversion, in YYYY-MM-DD format.
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
HistoricalRatesResponseapplication/json
Request succeeded and returns this Endpoint's JSON response.
Properties: basedatemetaratesresponse
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
{
"base": "USD",
"date": "2025-01-02",
"meta": {
"code": 200,
"disclaimer": "Usage subject to terms: https://currencybeacon.com/terms"
},
"rates": {},
"response": {
"base": "USD",
"date": "2025-01-02",
"rates": {}
}
}