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

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"
    }
}