FX Metrics

Trend scores and metrics for currency pairs — the same ByteTrend scores and regimes as for other assets, applied to exchange rates. For the exchange rates themselves, see Latest Rates.

The /api/fx/* endpoints are dedicated to currency pairs. The asset and metric endpoints (/api/assets, /api/metrics) also answer for pairs, so one client can loop over stocks, crypto and currencies alike; prefer /api/fx/* when you only need currencies — it returns the currency-pair shape directly, with no fallback logic.

Endpoints

Method	Path	Description
GET	/api/fx	List of tracked FX pairs with latest scores and trend regime
GET	/api/fx/:symbol	Latest computed metrics for a single FX pair
GET	/api/fx/:symbol/series	Daily metric time series for a single FX pair
GET	/api/fx/:symbol/prices	Close-only price series for a single FX pair

Surface boundary

Concern	Surface
Raw FX rate OHLC and date data	/api/rates, /api/rates/sparklines, /api/rates/:pair
FX scores, trend regimes, and computed metrics	/api/fx/* (this namespace)
Polymorphic FX rows alongside other asset types	/api/assets?type=fx, /api/assets/:fxsymbol, /api/metrics/:fxsymbol/latest, /api/metrics/:fxsymbol

The polymorphic surfaces fall back to FX data when a symbol doesn’t resolve as a registered Asset, so a single client path can iterate across stocks, crypto, FX, and others. /api/fx/* is the recommended surface when the consumer is FX-only.

Symbol form

FX-pair symbols use concatenated form on the wire (e.g. EURUSD); name on the /api/fx endpoints renders slash form (EUR/USD) for display, while FX rows on /api/assets spell the currencies out (Euro / US Dollar).

Trading-day windows

FX metrics are computed over trading days only, Monday to Friday, as for stocks. The Weekly score’s 200-week and 30-week averages and the 30-week volatility cover exactly those numbers of weeks, and the Daily score’s 30-day window covers 30 weekdays. Returns count a fixed number of weekdays, as stocks count trading days: the 12-month return looks back 252 weekdays. A weekday holiday still has a row, so that is about 50 weeks. The rate series also has Saturday and Sunday rows, which carry Friday’s rate forward for currency conversion (see Pair History). Those rows repeat Friday’s metrics, so a weekend date returns the same scores as the Friday before it.

Notes

• Per-row metric fields use the same keys as /api/metrics — see the Latest Metrics reference for descriptions of byteTrendCapr200w, trendRegimeCapr200w, MAs, deviations, etc.
• The ?fields= projection is honoured on /api/fx and /api/fx/:symbol/series, and date and close are always returned, whether or not you name them. The two routes differ on a field name the record doesn’t have: /api/fx returns it as null, while the series routes (/api/fx/:symbol/series, /api/metrics/:symbol) leave it out. A malformed name is a 400 on both — see Value validation.