CurrencyBeaconCurrencyBeacon exchange-rate API
GET/convert
Convert a currency amount
Converts an amount using current rates or rates for a specified historical date.
Query latest, historical, conversion, time-series, and supported-currency data with caller-owned CurrencyBeacon credentials.
Request
- operationId
convertCurrency- Server
https://api.currencybeacon.com/v1- Authentication
- apiKey
Request parameters
from
querystringrequired
Three-letter code of the currency to convert from.
USD
to
querystringrequired
Three-letter code of the target currency.
USD
amount
querynumberrequired
Amount to convert.
10
date
querystringdate
Date used for a historical lookup or conversion, in YYYY-MM-DD format.
2025-01-02
Responses
200
ConversionResponseapplication/json
Request succeeded and returns this Endpoint's JSON response.
Properties: amountdatefrommetaresponsetimestamptovalue
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
{
"amount": 10,
"date": "2026-08-15",
"from": "USD",
"meta": {
"code": 200,
"disclaimer": "Usage subject to terms: https://currencybeacon.com/terms"
},
"response": {
"amount": 10,
"date": "2026-08-15",
"from": "USD",
"timestamp": 1786770980,
"to": "EUR",
"value": 8.6426828
},
"timestamp": 1786770980,
"to": "EUR",
"value": 8.6426828
}