Convert Exchange Rates

On this page, we’ll dive into the convert exchange rates endpoint you can use to directly convert a value to another currency's value.

GET/v3/convert

Convert Exchange Rates

Returns calculated values for today or any given date for all currencies.

Required attributes

Name
value
Type
string
Description
The value you want to convert

Optional attributes

Name
date
Type
string
Description
Date to retrieve historical rates from (format: 2021-12-31)
Name
base_currency
Type
string
Description
The base currency to which all results are behaving relative to By default all values are based on USD
Name
currencies
Type
string
Description
A list of comma seperated currency codes which you want to get (EUR,USD,CAD) By default all available currencies will be shown
Name
type
Type
string
Description
They type of currency you want to get (fiat, metal or crypto) By default all types will be shown

Response Properties

The response is equal to the response from /latest endpoint.

Request

GET

/v3/convert

curl -G https://api.currencyapi.com/v3/convert?value=12 \
    -H "apikey: YOUR-API-KEY"

Full Response

{
    "meta": {
        "last_updated_at": "2022-01-01T23:59:59Z"
    },
    "data": {
        "AED": {
            "code": "AED",
            "value": 3.67306
        },
        "AFN": {
            "code": "AFN",
            "value": 91.80254
        },
        "ALL": {
            "code": "ALL",
            "value": 108.22904
        },
        "AMD": {
            "code": "AMD",
            "value": 480.41659
        },
        "...": "150+ more currencies"
    }
}