# Average Exchange Rates

Returns the average, lowest and highest daily rate of every requested currency per month, quarter or year. Accounting standards such as IFRS (IAS 21) and US GAAP (ASC 830) allow translating income and expenses at the average rate of a period, and this endpoint returns exactly that figure.

Request Method: GET
Request URL: https://api.fxapi.com/v1/average

# Request Parameters

Parameter Type Mandatory Description
apikey string ️ Your API Key
date_from string ️ First day, format YYYY-MM-DD, 1999-01-01 or later
date_to string ️ Last day, format YYYY-MM-DD, yesterday at the latest, at most 1830 days after date_from
period string month (default), quarter, year, or total for one average over the whole span
base_currency string The base currency all rates are expressed in
Default: USD
currencies string A list of comma-separated currency codes (EUR,GBP,JPY)
By default all currencies are returned
type string Filter by type: fiat, metal, crypto
format string json (default) or csv (period,date_from,date_to,days,source,base_currency,currency,average,min,max)

Every daily rate is first expressed against base_currency and only then averaged, so the average EUR rate in GBP is the mean of the daily EUR/GBP rates. The first and last period are cut to your span; each period's date_from, date_to and days tell you exactly which days went into it. A request costs one request of your quota.

# Sample Request

curl -G https://api.fxapi.com/v1/average \
    -d date_from=2026-01-01 \
    -d date_to=2026-02-28 \
    -d period=month \
    -d base_currency=EUR \
    -d currencies=USD,GBP \
    -H "apikey: YOUR-API-KEY"

# Sample Response

{
    "meta": {
        "source": "market",
        "base_currency": "EUR",
        "period": "month",
        "date_from": "2026-01-01",
        "date_to": "2026-02-28"
    },
    "data": [
        {
            "period": "2026-01",
            "date_from": "2026-01-01",
            "date_to": "2026-01-31",
            "days": 31,
            "currencies": {
                "GBP": {"code": "GBP", "value": 0.8312, "min": 0.8254, "max": 0.8377},
                "USD": {"code": "USD", "value": 1.0405, "min": 1.0298, "max": 1.0521}
            }
        },
        {
            "period": "2026-02",
            "date_from": "2026-02-01",
            "date_to": "2026-02-28",
            "days": 28,
            "currencies": {
                "GBP": {"code": "GBP", "value": 0.8287, "min": 0.8231, "max": 0.8340},
                "USD": {"code": "USD", "value": 1.0461, "min": 1.0372, "max": 1.0553}
            }
        }
    ]
}