OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add joellewis/finance_skills --skill currencies-and-fx
Analyze currency markets, exchange rate mechanics, and FX risk management for international portfolios. Use when the user asks about exchange rates, FX hedging, interest rate parity, carry trades, forward premiums, cross rates, or currency overlay programs. Also trigger when users mention 'strong dollar', 'weak euro', 'hedging foreign stocks', 'purchasing power parity', 'currency risk in my portfolio', 'EUR/USD', 'yen carry trade', or ask whether to hedge international investments.
npx skills add joellewis/finance_skills --skill currencies-and-fx
The price of one currency in terms of another for immediate delivery (T+2 settlement). Quoting convention: EUR/USD = 1.10 means 1 euro costs 1.10 US dollars. Some pairs are quoted as the number of foreign currency units per dollar (USD/JPY = 150), while others are quoted as dollars per foreign unit (EUR/USD = 1.10, GBP/USD = 1.27).
The agreed exchange rate for a future currency transaction, determined by the interest rate differential between the two currencies. Forward rates are not forecasts of future spot rates — they are arbitrage-determined prices that reflect the cost of carry.
An arbitrage condition that must hold (and empirically does, closely):
F/S = (1 + r_d) / (1 + r_f)
where F = forward rate, S = spot rate, r_d = domestic interest rate, r_f = foreign interest rate (for the same period). If CIP were violated, riskless arbitrage would be possible by borrowing in one currency, converting, investing, and locking in the return with a forward.
A theoretical (not arbitrage-enforced) condition:
E(S_t) / S_0 = (1 + r_d) / (1 + r_f)
UIP predicts that the expected future spot rate adjusts to offset interest rate differentials. Empirically weak — high-interest-rate currencies tend to appreciate rather than depreciate as UIP predicts, which is why carry trades can be profitable.
Forward Premium = (F - S) / S = (r_d - r_f) / (1 + r_f)
If the domestic interest rate exceeds the foreign rate, the forward rate is at a premium to spot (the foreign currency is more expensive forward). If the domestic rate is lower, the forward is at a discount.
Borrow in a low-interest-rate currency and invest in a high-interest-rate currency, profiting from the interest rate differential. Profitable when UIP fails (i.e., the high-rate currency does not depreciate enough to offset the interest differential). Carry trades exhibit positive returns on average but with significant tail risk — sudden unwinds during risk-off episodes can cause severe losses (negative skewness, fat tails).
Derive the exchange rate between two currencies using their rates against a common third currency:
EUR/GBP = (EUR/USD) / (GBP/USD)
For example, if EUR/USD = 1.10 and GBP/USD = 1.27, then EUR/GBP = 1.10 / 1.27 = 0.8661.
Use forward contracts to eliminate FX risk in international investments. A US investor with EUR assets can sell EUR forward to lock in the conversion rate. The hedging cost equals the interest rate differential between the two currencies (per CIP). When the domestic rate exceeds the foreign rate, hedging earns a positive return; when it is lower, hedging has a cost.
Adjusts the nominal exchange rate for relative price levels:
Real Rate = Nominal Rate × (Foreign Price Level / Domestic Price Level)
Changes in the real exchange rate reflect changes in competitiveness. If the real rate appreciates, domestic goods become more expensive relative to foreign goods.
The long-run anchor for exchange rates. PPP posits that exchange rates should adjust so that identical goods cost the same across countries. Empirically, PPP holds poorly in the short run but provides a reasonable guide to fair value over decades. Deviations from PPP can persist for years.
A systematic hedging program for international portfolios, managed separately from the underlying asset allocation. Overlay managers implement hedging ratios (e.g., hedge 50% of foreign exposure) and may make tactical adjustments based on valuation, carry, and momentum signals.
| Formula | Expression | Use Case |
|---|---|---|
| CIP Forward Rate | F = S × (1+r_d)/(1+r_f) | Arbitrage-determined forward |
| UIP Expected Spot | E(S_t) = S_0 × (1+r_d)/(1+r_f) | Theoretical future spot |
| Forward Premium | (F-S)/S = (r_d-r_f)/(1+r_f) | Forward vs spot differential |
| Cross Rate | A/B = (A/C) / (B/C) | Derive from common currency |
| Real Exchange Rate | q = e × (P*/P) | Competitiveness measure |
| Hedging Cost | ≈ r_d - r_f (annualized) | Cost to hedge FX exposure |
Given: USD/JPY spot = 150, US 1-year rate = 5%, Japan 1-year rate = 0.5% Calculate: 1-year forward rate Solution: F = S × (1 + r_JPY) / (1 + r_USD) F = 150 × (1 + 0.005) / (1 + 0.05) F = 150 × 1.005 / 1.05 F = 150 × 0.95714 = 143.57
The forward rate is 143.57 JPY/USD. The yen is at a forward premium (fewer yen per dollar forward than spot) because Japanese rates are lower. A US investor hedging yen assets back to dollars would receive this favorable forward rate, effectively earning the interest rate differential.
Given: EUR/USD spot = 1.10, EUR 1-year rate = 3%, USD 1-year rate = 5% Calculate: Annual cost/benefit of hedging USD exposure back to EUR Solution: Forward rate: F = 1.10 × (1.03)/(1.05) = 1.10 × 0.98095 = 1.0790
A EUR investor hedging USD assets sells USD forward at 1.0790 EUR/USD. Hedging benefit = (S - F) / S = (1.10 - 1.079) / 1.10 = 1.91%
Because EUR rates (3%) are lower than USD rates (5%), the EUR investor earns a positive hedging return of approximately 2% (the interest rate differential). The hedged return on USD assets for a EUR investor is the USD return plus approximately 2% from the hedge.
The demo prints the calculations covered above; its values match the worked examples in this skill. Run --help for a list of the classes and functions. For programmatic use, import the module rather than running it — the demo only executes under python currencies_and_fx.py.*