--- name: "valuation_fx" area: "valuation" title: "Convert amounts between currencies" price: "free" method: "POST" url: "https://api.conecto.chat/v1/tools/valuation_fx" mcp_server: "https://api.conecto.chat/mcp/valuation" auth: "Authorization: Bearer " docs_url: "https://conecto.chat/tools/valuation/valuation_fx" --- # Convert amounts between currencies (`valuation_fx`) Amounts converted between currencies at the ECB's euro reference rates, on a date or at a past year's average. Amounts converted at the ECB's euro reference rates: on a date (the latest rates published on or before it; none come out on weekends and TARGET holidays), or at a past year's average, for a year's figures like revenue. Peers and targets that report in different currencies are compared in one currency: convert their figures before valuation_multiples or valuation_benchmark. Today's rates when neither date nor year is given. Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing. ## Use it when Before comparing a target and peers that report in different currencies, like pounds and euros. - For the risk-free rate, use [valuation_rates](https://conecto.chat/tools/valuation/valuation_rates.md). ## Say this to your agent > Harbour Lane Coffee reports in pounds and our peers in euros. Put its 2025 revenue and EBITDA into euros. ## Inputs | Name | Type | Required | Description | Allowed values | Default | |---|---|---|---|---|---| | `amounts` | array of objects | yes | 1 to 50 items. | | | | `amounts[].amount` | number | yes, in each item of `amounts` | | | | | `amounts[].currency` | string | yes, in each item of `amounts` | ISO code, e.g. GBP. Matches ^[A-Za-z]{3}$. | | | | `amounts[].label` | string | no | 1 to 200 characters. | | | | `to` | string | yes | The currency to convert into, e.g. EUR. Matches ^[A-Za-z]{3}$. | | | | `date` | string | no | Rates on this day. Matches ^\\d{4}-\\d{2}-\\d{2}$. | | | | `year` | integer | no | A past year's average. 1,999 to 2,100. | | | ## Example Written for Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. MCP: call `valuation_fx` on the MCP server `https://api.conecto.chat/mcp/valuation` with these arguments: ```json { "to": "EUR", "date": "2025-12-31", "amounts": [ { "amount": 18450000, "currency": "GBP", "label": "Harbour Lane Coffee revenue" } ] } ``` REST: ```bash curl https://api.conecto.chat/v1/tools/valuation_fx \ -H "Authorization: Bearer $CONECTO_KEY" \ -H "Content-Type: application/json" \ -d '{"to": "EUR", "date": "2025-12-31", "amounts": [{"amount": 18450000, "currency": "GBP", "label": "Harbour Lane Coffee revenue"}]}' ``` ## Response ```json { "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93", "tool": "valuation_fx", "status": "succeeded", "replayed": false, "cost_usd": "$0.00", "balance_usd": "$19.75", "result": { "to": "EUR", "basis": "ECB euro reference rates on 2025-12-31", "rates": { "GBP": { "per_euro": 0.8726, "date": "2025-12-31" } }, "amounts": [ { "label": "Harbour Lane Coffee revenue", "amount": 18450000, "currency": "GBP", "converted": 21143708.46, "rate": 1.146 } ], "source": { "name": "European Central Bank, euro foreign exchange reference rates", "url": "https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html", "terms": "ECB statistics, free to reuse with the source named" } } } ``` `result`: to, basis, rates (each currency per euro, with its day or year), amounts (label, amount, currency, converted, rate) and source; a note when the day had no rates and an earlier day's were used. ## Errors | Code | Status | When | Fix | |---|---|---|---| | `invalid_input` | 400 | A currency the ECB publishes no rate for, both date and year, this year as a year, or a date in the future. | The message lists the currencies; give a date for this year's figures. | | `unavailable` | 503 | The ECB didn't answer, or has no rate for that time. | Try again in a minute, or another date. | The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md ## Related - [valuation_dcf](https://conecto.chat/tools/valuation/valuation_dcf.md): A DCF valuation from free cash flows and a WACC: present values, terminal value, enterprise and equity value, and a sensitivity grid. Free up to 1,000,000 reads a month. - [valuation_wacc](https://conecto.chat/tools/valuation/valuation_wacc.md): The WACC from the risk-free rate, the market premium and a beta relevered from peers, with each step written out. Free up to 1,000,000 reads a month. - [valuation_rates](https://conecto.chat/tools/valuation/valuation_rates.md): Today's risk-free curve and its recent average from the Bundesbank, the ECB or the US Treasury, as decimals. Free up to 1,000,000 reads a month. - [valuation_multiples](https://conecto.chat/tools/valuation/valuation_multiples.md): Peer multiples with their quartiles and the enterprise and equity value they imply for the target, less any discount. Free up to 1,000,000 reads a month. - [valuation_lbo](https://conecto.chat/tools/valuation/valuation_lbo.md): A buyout financed with debt, year by year: sources and uses, each debt tranche, the exit, MOIC, IRR and an IRR grid by entry and exit multiple. Free up to 1,000,000 reads a month. - [valuation_benchmark](https://conecto.chat/tools/valuation/valuation_benchmark.md): The target's KPIs against its peers: quartiles, percentile, gap to the median and whether each is a strength or a potential. Free up to 1,000,000 reads a month. - [valuation_scores](https://conecto.chat/tools/valuation/valuation_scores.md): Altman, Piotroski and Beneish scores from a company's figures, and whether it is growing, mature or distressed. Free up to 1,000,000 reads a month. - [valuation_forecast](https://conecto.chat/tools/valuation/valuation_forecast.md): Model forecasts with 80% and 95% intervals for revenue, EBITDA or monthly sales, with a confidence label and the plan checked against the range. Free up to 1,000,000 reads a month. - [valuation_beta](https://conecto.chat/tools/valuation/valuation_beta.md): Betas of listed peers from closing prices the business gives, with R squared, the t-statistic and the unlevered beta. Free up to 1,000,000 reads a month. - [valuation_football_field](https://conecto.chat/tools/valuation/valuation_football_field.md): The valuation ranges side by side, with the overall range, the overlap, markers and a slide for the deck. Free up to 1,000,000 reads a month.