Exchange-rate stress test
fx_stressRead-only
Use this when the user pays, or plans to pay, an employee in local currency and asks about exchange-rate risk or a USD budget (e.g. "what if the real moves 10%", "risque de change sur un salaire en pesos"). Returns the USD cost (gross salary plus statutory employer charges, before any Employer of Record fee) at the official exchange rate of the data snapshot, with its date and source, and if the local currency moves by 5, 10 or 20 percent either way; with a USD budget, the headroom in each case and the move at which the budget is reached. Do not use for currency conversion alone. Data snapshot 2026-10-11. Cost comparison, not legal or tax advice.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | Yes | ISO 3166-1 alpha-2 code ("DE") or country name ("Germany") | |
| budget_usd | No | Annual budget in USD for salary plus employer charges, if the user has one | |
| assumptions | No | Override an adjustable assumption the country declares, e.g. {"basic_share_of_gross": 0.6}. See `assumptions` in an employer_cost answer. | |
| salary_local | Yes | Gross salary in the local currency of the country, a year unless salary_period is "month" | |
| salary_period | No | Whether the salary is a year (default) or a month. Pass a monthly salary as the user gives it, with "month": the statutory number of monthly payments of the country (13th, 14th month) is applied, see salary_basis in the answer. | year |
| payments_per_year | No | With salary_period "month" only: the total number of monthly salaries the contract pays in a year, statutory ones included (e.g. 14). Omit to use the statutory number of the country. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | Yes | ||
| budget | No | ||
| country | Yes | ||
| reading | Yes | ||
| summary | Yes | ||
| scenarios | Yes | ||
| salary_basis | No | ||
| employer_cost | Yes | ||
| exchange_rate | Yes | ||
| total_annual_local | Yes | ||
| salary_annual_local | Yes | ||
| total_at_official_rate | Yes |