Convert

Changed on
get/v1/convert/{from_ccy}/{to_ccy}

Request

  • Base URL
    https://api.exchangerate.dev (the document declares no server; this is the origin it was published from)
  • URL
    https://api.exchangerate.dev/v1/convert/{from_ccy}/{to_ccy}
  • Auth
    none declared

Path parameters

from_ccystring required
to_ccystring required

Query parameters

number
OR
string

Response

Successful Response

resultstring
fromstring required
tostring required
amountnumber required
ratenumber required
convertednumber required
derivedboolean required
derivation_bps_maxnumber nullable
source'live' | 'ecb_daily' | 'market_daily' required

Public source enum — wire contract (D2). NO cached value (cache lives in X-Cache).

ecb_daily is the only reference source (October 2026). market_daily labels the stored daily close of the live market feed, for the currencies with no reference fix, in date history and 1d time series; it is never a live rate.

sourcesobject required
staleboolean required
market_session'open' | 'weekend' | 'interbank_closed' required

Computed from a clock, no feed (D9). interbank_closed = a known non-weekend closure (e.g. an ECB/TARGET2 holiday detected via an empty Tier-C response — INGESTION §4).

timestampstring required
data_updated_atstring required
noticestring required

Changes

  • db0de0a0d416Revision changes
    • warning

      added the new market_daily enum value to the response property for the response status

    • warning

      added the new market_daily enum value to the / response property for the response status

    • info

      removed the banxico_daily enum value from the response property for the response status

    • info

      removed the banxico_daily enum value from the / response property for the response status

    • info

      removed the dof_daily enum value from the response property for the response status

    • info

      removed the dof_daily enum value from the / response property for the response status

    • info

      removed the fred_daily enum value from the response property for the response status

    • info

      removed the fred_daily enum value from the / response property for the response status

    • info

      removed the nbp_daily enum value from the response property for the response status

    • info

      removed the nbp_daily enum value from the / response property for the response status

  • b61aa708e371Revision changes
    • info

      added the required property to the response with the status