Calculator overview
Inputs and outputs
This summary comes from the calculator's published input and output contract.
Inputs
- FXH Hedge Method
-
Default Compare both Allowed Forward contract, Money-market hedge, Compare both
About this input
Selects the forward route, money-market route, or a side-by-side comparison.
- FXH Exposure Direction
-
Default Foreign-currency receivable Allowed Foreign-currency receivable, Foreign-currency payable
About this input
Determines cash-flow sign, transaction-cost direction, and preferred comparison result.
- FXH Quote Convention
-
Default Domestic per foreign Allowed Domestic per foreign, Foreign per domestic
About this input
Identifies whether entered spot and forward are domestic/foreign or their reciprocal.
- FXH Foreign Exposure
-
Unit foreign currency Default 1000000 Range 0.01 to 1000000000
About this input
Positive contractual foreign amount received or paid at maturity.
- FXH Spot Rate Conditional
-
Unit selected quote convention Default 1.1 Range 1E-06 to 1000000
About this input
Spot conversion rate used only by the money-market replication and comparison.
- FXH Forward Rate Conditional
-
Unit selected quote convention Default 1.11083743842365 Range 1E-06 to 1000000
About this input
Contracted settlement rate used only by the forward route and comparison.
- FXH Domestic Annual Rate Conditional
-
Unit fraction/year Default 0.05 Range -0.95 to 1
About this input
Domestic borrowing/investment rate for money-market replication.
- FXH Foreign Annual Rate Conditional
-
Unit fraction/year Default 0.03 Range -0.95 to 1
About this input
Foreign borrowing/investment rate for money-market replication.
- FXH Hedge Tenor Years Conditional
-
Unit years Default 0.5 Range 0.01 to 10
About this input
Compounding horizon used by the money-market route.
- FXH Domestic Compounding Per Year Conditional
-
Unit periods/year Default 2 Range 1 to 365
About this input
Domestic compounding periods per year.
- FXH Foreign Compounding Per Year Conditional
-
Unit periods/year Default 2 Range 1 to 365
About this input
Foreign compounding periods per year.
- FXH Forward Transaction Cost Bps Conditional
-
Unit basis points of domestic maturity amount Default 0 Range 0 to 10000
About this input
Direction-specific proportional cost applied to the forward maturity amount.
- FXH Money Market Transaction Cost Bps Conditional
-
Unit basis points of domestic maturity amount Default 0 Range 0 to 10000
About this input
Direction-specific proportional cost applied to the money-market maturity amount.
- FXH Comparison Alert Threshold Conditional
-
Unit absolute relative deviation Default 0.02 Range 0 to 1
About this input
Compare-mode threshold for the quoted-forward deviation from modeled interest parity.
Outputs
- FXH Normalized Spot Rate Conditional
-
Unit domestic per foreign
About this output
Spot rate after any reciprocal-quote conversion.
- FXH Normalized Forward Rate Conditional
-
Unit domestic per foreign
About this output
Contracted forward after any reciprocal-quote conversion.
- FXH Implied Parity Forward Rate Conditional
-
Unit domestic per foreign
About this output
Spot times domestic accumulation divided by foreign accumulation.
- FXH Forward Locked Domestic Amount Conditional
-
Unit domestic currency
About this output
Direction-adjusted domestic maturity amount from the forward route after costs.
- FXH Money Market Locked Domestic Amount Conditional
-
Unit domestic currency
About this output
Replicated domestic maturity amount after costs.
- FXH Method Difference Domestic Conditional
-
Unit domestic currency
About this output
Compare-mode forward result minus money-market result.
- FXH Forward Deviation Percent Conditional
-
Unit fraction
About this output
Contracted normalized forward divided by modeled parity forward less one.
- FXH Upfront Domestic Funding Conditional
-
Unit domestic currency at inception
About this output
Foreign present value converted at normalized spot.
- FXH Selected Locked Domestic Amount
-
Unit domestic currency
About this output
Active single-method result or mechanically preferred compare-mode amount.
- FXH Selected Signed Domestic Cash Flow
-
Unit domestic currency
About this output
Positive for a receivable and negative for a payable.
- FXH Effective Domestic Rate Per Foreign
-
Unit domestic per foreign
About this output
Selected locked amount divided by foreign exposure.
- FXH Selected Hedge Route
-
No unit declared
About this output
Active route or compare-mode mechanical preference.
- Model Status
-
No unit declared
About this output
OK identifies finite active routes; CHECK flags a compare-mode parity deviation; NOT VALID identifies intake or compounding failure.
Methodology
Purpose and model boundary
This model calculates the domestic-currency amount locked for a single foreign-currency receivable or payable through a contracted forward, a money-market replication, or a comparison of both. It normalizes reciprocal quote conventions, applies route-specific transaction-cost inputs, and identifies the mechanically preferable cash amount in comparison mode. It is not an executable quote, hedge recommendation, liquidity assurance, or hedge-accounting conclusion.
Inputs and units
The hedge route is forward contract, money-market hedge, or compare both. Exposure direction is foreign-currency receivable or payable. Spot and forward may be entered as domestic currency per foreign unit or foreign currency per domestic unit. Foreign exposure is a positive foreign-currency amount. Domestic and foreign annual rates are fractions with independently entered integer compounding frequencies, and tenor is in years. Transaction costs are basis points of domestic maturity amount. The comparison threshold is an absolute relative deviation.
Only route-relevant inputs are active. A forward-only calculation ignores spot, funding rates, tenor, compounding frequencies, money-market cost, and comparison threshold. A money-market-only calculation ignores contracted forward, forward cost, and comparison threshold. Compare mode activates both routes and the threshold.
Governing relationships
Entered quotes are normalized to domestic currency per foreign unit:
S = entered spot and F = entered forward for domestic-per-foreign quotes
S = 1 / entered spot and F = 1 / entered forward for foreign-per-domestic quotes
For annual rate r, compounding frequency m, and tenor T, the accumulation factor is:
A(r,m,T) = (1 + r/m)^(mT)
The domestic and foreign factors are A_d and A_f. Covered-interest-parity replication gives:
F_CIP = S × A_d / A_f
Upfront domestic funding = foreign exposure / A_f × S
Let s = -1 for a receivable and s = +1 for a payable, and let route cost b be basis points. The cost-adjusted maturity locks are:
Forward lock = exposure × F × (1 + s × b_forward/10000)
Money-market lock = exposure × F_CIP × (1 + s × b_money/10000)
Thus costs reduce a receivable and increase a payable. The route difference is forward lock minus money-market lock. Forward deviation is F/F_CIP - 1; values within 1e-12 are reported as zero.
In compare mode the workbook selects the larger lock for a receivable and the smaller lock for a payable. Values equal within 1e-12 × max(1, both amounts) select the forward amount and label the routes Economically equivalent. Signed selected cash flow is positive for a receivable and negative for a payable.
Calculation sequence
- Validate selectors, exposure, and only the fields active for the selected route.
- Normalize each active quote to domestic currency per foreign unit.
- For an active money-market route, calculate domestic and foreign accumulation, parity forward, and upfront domestic funding.
- Calculate each active locked maturity amount with direction-specific transaction costs.
- In compare mode, calculate route difference and parity deviation, then choose the mechanically favorable amount by exposure direction.
- Report the selected signed cash flow, effective domestic amount per foreign unit, and selected route.
- Build the locked-amount route comparison chart and evaluate the comparison threshold.
Outputs and interpretation
Normalized spot and forward expose the common quote basis. Implied parity forward is the rate produced by the entered spot and funding assumptions. Route-specific locked amounts are cost-adjusted domestic maturity amounts. Method difference and forward deviation are available only in compare mode. The selected amount and route follow the mechanical rule above; they are not advice. Effective domestic rate is selected amount divided by foreign exposure.
The chart compares only active route amounts. It contains no live market or forecast series.
Validation and status logic
The workbook evaluates status in this order:
| Condition | Returned status |
|---|---|
| A selector or any route-visible FX, rate, tenor, frequency, cost, or threshold field fails | NOT VALID: correct hedge selectors and every visible FX, rate, tenor, frequency, cost, or threshold input |
| Active accumulation, reciprocal quote, parity, or selected hedge arithmetic is nonpositive or nonnumeric | NOT VALID: active compounding, quote inversion, or hedge arithmetic is nonpositive or nonfinite |
| Compare mode is active and absolute forward deviation exceeds the entered alert threshold | CHECK: quoted forward deviates from modeled interest parity beyond the alert threshold |
| None of the preceding conditions applies | OK |
Input and derived failures take precedence over the comparison check. The threshold comparison is strict: equality does not trigger CHECK.
Assumptions and limitations
- The foreign exposure is certain and settles once at the entered tenor.
- Borrowing and investing use the same entered rate within each currency.
- Bid/ask, funding, and credit effects enter only through the two user-entered transaction-cost rates.
- There is no holiday calendar, spot lag, broken-date interpolation, cross-currency basis, collateral, capital, liquidity, tax, rollover, option, or counterparty-default treatment.
- Covered interest parity is a simplifying replication identity and may differ from executable market pricing.
- The preferred comparison result is a cash-amount rule, not a recommendation or approval.
Restrictions and non-computing states
Foreign exposure must be 0.01 through 1,000,000,000. Active spot and forward quotes must be 0.000001 through 1,000,000. Active annual rates are -0.95 through 1; tenor is 0.01 through 10 years; active compounding frequencies are whole numbers from 1 through 365; costs are 0 through 10,000 basis points; and comparison threshold is 0 through 1. A reciprocal zero, nonpositive accumulation/parity factor, or nonpositive selected amount prevents a result.
Errors and warnings
This calculator refuses an unknown option, missing visible field, or value outside its allowed range before calculation. Workbook NOT VALID separates active-input failure from nonpositive or nonfinite replication arithmetic. Workbook CHECK means both routes calculated and the forward quote exceeded the entered parity-deviation threshold. A connection or calculation-service failure is not an unhedged or zero-value cash flow.
References
Quote-convention and public exchange-rate context follows the Federal Reserve H.10 Foreign Exchange Rates; no H.10 observation is embedded. Covered-interest-parity context follows the BIS article Covered Interest Parity, FX Swaps and Cross-Currency Swaps. The workbook independently implements the replication identity and embeds no market feed or proprietary curve.
Found a problem, or have an idea?
Tell us if a result looks wrong, a label is unclear, or something is missing. We read every message.
LogicCommons is in beta. If a result, label, or reference looks wrong, tell us here; we read every message.