{
  "id": "currency",
  "version": "71a53c37fe27",
  "status": "published",
  "name": "Currency Converter",
  "question": "Convert money between currencies",
  "summary": "Converts money between the euro and the 29 currencies the European Central Bank quotes, at the ECB reference rates or your own rate.",
  "category": "convert",
  "subcategory": "currency",
  "url": "https://www.acalculator.org/convert/currency",
  "markdown": "https://www.acalculator.org/convert/currency.md",
  "kind": "function",
  "method": "converted amount = amount × rate. The ECB rate for a pair is (to per euro) ÷ (from per euro), from the ECB euro reference rates.",
  "assumptions": [
    "The default rate comes from the ECB euro reference rates of 28 September 2026. The ECB publishes them for information purposes only, not for transactions.",
    "The ECB quotes each currency against the euro. A rate between two other currencies is a cross rate this site works out from the two euro rates; the ECB does not publish it.",
    "Banks, cards, and exchange offices add a margin or a fee, so the rate you get is usually worse. Type their rate into \"Your rate\" to see what you would receive.",
    "The converted amount is rounded to 2 decimal places, without trailing zeros (24.4 means 24.40); the calculation keeps full precision."
  ],
  "inputs": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "amount": {
        "title": "Amount",
        "description": "The amount of money to convert, in the \"from\" currency.",
        "type": "number",
        "minimum": 0,
        "maximum": 1000000000000
      },
      "from": {
        "title": "From",
        "description": "The currency you have.",
        "type": "string",
        "enum": [
          "USD",
          "EUR",
          "AUD",
          "BRL",
          "CAD",
          "CNY",
          "CZK",
          "DKK",
          "HKD",
          "HUF",
          "ISK",
          "INR",
          "IDR",
          "ILS",
          "JPY",
          "MYR",
          "MXN",
          "NZD",
          "NOK",
          "PHP",
          "PLN",
          "GBP",
          "RON",
          "SGD",
          "ZAR",
          "KRW",
          "SEK",
          "CHF",
          "THB",
          "TRY"
        ]
      },
      "to": {
        "title": "To",
        "description": "The currency you want.",
        "type": "string",
        "enum": [
          "USD",
          "EUR",
          "AUD",
          "BRL",
          "CAD",
          "CNY",
          "CZK",
          "DKK",
          "HKD",
          "HUF",
          "ISK",
          "INR",
          "IDR",
          "ILS",
          "JPY",
          "MYR",
          "MXN",
          "NZD",
          "NOK",
          "PHP",
          "PLN",
          "GBP",
          "RON",
          "SGD",
          "ZAR",
          "KRW",
          "SEK",
          "CHF",
          "THB",
          "TRY"
        ]
      },
      "rate": {
        "title": "Your rate (optional)",
        "description": "How many units of the \"to\" currency one unit of the \"from\" currency buys at your bank or card. Leave it empty to use the ECB reference rate.",
        "type": "number",
        "minimum": 1e-9,
        "maximum": 1000000000
      }
    }
  },
  "outputs": {
    "result": {
      "label": "Converted amount",
      "description": "The amount in the \"to\" currency.",
      "format": "number"
    },
    "rate": {
      "label": "Rate used",
      "description": "How many units of the \"to\" currency one unit of the \"from\" currency buys in this answer.",
      "format": "number"
    },
    "inverse": {
      "label": "Inverse rate",
      "description": "How many units of the \"from\" currency one unit of the \"to\" currency buys.",
      "format": "number"
    },
    "ecbRate": {
      "label": "ECB rate of 28 September 2026",
      "description": "The ECB euro reference rate of 28 September 2026 for this pair: (to per euro) ÷ (from per euro).",
      "format": "number"
    }
  },
  "defaultAnswer": {
    "inputs": {
      "amount": 100,
      "from": "USD",
      "to": "EUR"
    },
    "outputs": {
      "result": 87.88890841975743,
      "rate": 0.8788890841975743,
      "inverse": 1.1378,
      "ecbRate": 0.8788890841975743
    },
    "text": "100 in US dollar (USD) is 87.89 in Euro (EUR), at a rate of 0.878889. The ECB reference rates of 28 September 2026 give a rate of 0.878889."
  },
  "examples": [
    {
      "given": {
        "amount": 100,
        "from": "USD",
        "to": "EUR",
        "rate": 0.9
      },
      "expect": {
        "result": 90,
        "rate": 0.9,
        "inverse": 1.1111111111111112
      },
      "source": "hand calculation in content.mdx: 100 × 0.9 = 90; 1 ÷ 0.9 = 1.111111"
    },
    {
      "given": {
        "amount": 250,
        "from": "GBP",
        "to": "JPY",
        "rate": 208.1
      },
      "expect": {
        "result": 52025
      },
      "source": "hand calculation in content.mdx: 250 × 208.1 = 52,025"
    },
    {
      "given": {
        "amount": 100,
        "from": "EUR",
        "to": "EUR"
      },
      "expect": {
        "result": 100,
        "rate": 1,
        "ecbRate": 1
      },
      "source": "hand calculation in content.mdx: a currency converts to itself at 1"
    }
  ],
  "sources": [
    "European Central Bank, euro foreign exchange reference rates of 28 September 2026. https://www.ecb.europa.eu/stats/eurofxref/eurofxref-daily.xml",
    "European Central Bank, \"Euro foreign exchange reference rates\": published at about 16:00 CET on TARGET working days, for information purposes only. https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html",
    "European Central Bank, disclaimer and copyright: free reuse with the ECB cited as the source; changes to the data must be stated. https://www.ecb.europa.eu/services/using-our-site/disclaimer/html/index.en.html"
  ],
  "related": [],
  "changelog": []
}