Introducing the Forward Curve and Pair Differential Endpoints

FXMacroData now includes a cleaner rates-and-curves API surface, giving traders and analysts a direct way to move from raw yield levels to the part of the rates story that usually matters most for FX: what the market is implying about the path ahead, and how that path compares across currencies. Instead of rebuilding the same rate-spread workflow manually for every pair, you can now query the curve shape and the cross-country differential directly from the API.

That matters because spot FX rarely trades off one yield in isolation. A move in GBP/USD, EUR/USD, or USD/JPY is usually driven by relative repricing: which front end is shifting faster, which curve is flattening or steepening, and whether the expected policy path is becoming more supportive for one side of the pair than the other.

What’s New

The new rates-and-curves surface adds two trader-facing building blocks:

• Forward curve analytics: /v1/curves/{currency}?view=forwards returns implied forward-rate segments derived from stored government bond tenor nodes, so you can inspect what a market is pricing between one maturity bucket and the next.
• Pair differential history: /v1/rate_differentials/{base}/{quote} returns the matched spread between two currencies using a shared measure such as risk-free rate, 2-year government bond yield, 10-year government bond yield, or policy rate.
• Auto measure selection: when you request measure=auto, the pair endpoint resolves to the best shared market across the two currencies instead of forcing you to guess which rate family has clean overlap.
• Basis-point output built in: the pair response includes both percentage-point and basis-point spreads, which is the format most FX desks actually use when discussing carry and front-end repricing.

Why It Matters for Traders

The forward curve is where the market stops describing today and starts pricing tomorrow. If the Bank of England is on hold but intermediate forwards are still elevated, the market may be saying cuts will come slowly. If the Federal Reserve is easing but the curve beyond the first few years stays firm, the market may be treating the move as tactical rather than structural. That distinction matters for how long a currency move can persist.

The pair differential endpoint solves the next problem. Even if one curve looks hawkish in isolation, FX needs a comparison set. A sterling curve is only sterling-positive if it is repricing more aggressively than the dollar, euro, or yen curve that sits on the other side of the trade. That is why a matched spread history is more useful than two disconnected time series.

Practical Example 1: Reading the UK Forward Curve Before a Sterling Event Week

Suppose you are preparing for a heavy UK macro week and want to know whether sterling support is only a spot-yield story or whether the market is still pricing a firm medium-term path. The curves endpoint gives you that forward view in one request.

curl -H "X-API-Key: YOUR_API_KEY" "https://api.fxmacrodata.com/v1/curves/gbp?view=forwards&curve_family=government_nominal&method=derived_from_spot_nodes"

Here is the response as of the 1 October 2026 Bank of England curve observation, trimmed to three of the nine segments. The full payload also carries research and data_quality blocks plus per-leg timestamps and vintage fields.

{
  "currency": "GBP",
  "curve_family": "government_nominal",
  "view": "forwards",
  "method": "derived_from_spot_nodes",
  "requested_date": "2026-10-05",
  "as_of": "2026-10-01",
  "node_count": 10,
  "segment_count": 9,
  "sources": ["Bank of England"],
  "data": [
    {"label": "1y1y", "start_maturity": "1Y", "end_maturity": "2Y", "horizon_years": 1.0,
     "date": "2026-10-01", "val": 4.8522, "val_bps": 485.22},
    {"label": "5y2y", "start_maturity": "5Y", "end_maturity": "7Y", "horizon_years": 2.0,
     "date": "2026-10-01", "val": 5.63, "val_bps": 563.0},
    {"label": "10y10y", "start_maturity": "10Y", "end_maturity": "20Y", "horizon_years": 10.0,
     "date": "2026-10-01", "val": 6.6079, "val_bps": 660.79}
  ]
}

The shape is the story. On that date the UK spot nodes ran from 4.35% at 1 year to 5.42% at 10 years, but the implied forwards climbed faster: 4.85% for the 1y1y segment, 5.63% for 5y2y and 6.61% for 10y10y, before falling back to 4.51% at the 30y10y end. A forward strip that rises through the belly says the gilt market is not pricing a quick return to lower rates, and much of that steepness sits in term premium rather than near-dated policy expectations. For a trader, that is useful context when deciding whether a soft sterling reaction to one data release is a genuine regime change or just noise against a still-firm rates backdrop.

Practical Example 2: Measuring the EUR/USD Pair Differential Directly

Now suppose you want the cross-country comparison instead of the single-country curve. You are watching EUR/USD and want to know whether the euro-dollar spread is narrowing or widening on the best shared short-rate measure available across both currencies.

curl -H "X-API-Key: YOUR_API_KEY" "https://api.fxmacrodata.com/v1/rate_differentials/eur/usd?measure=auto&start_date=2026-09-01&end_date=2026-10-05&limit=100"

The response below was returned on 5 October 2026, and the latest matched observation is 1 October. Rows are newest first, and the list is trimmed to two of the 22 matched dates.

{
  "base": "EUR",
  "quote": "USD",
  "measure_requested": "auto",
  "measure_used": "risk_free_rate",
  "start_date": "2026-09-01",
  "end_date": "2026-10-05",
  "matched_points": 22,
  "unit": "%",
  "latest_spread": -1.428,
  "latest_spread_bps": -142.8,
  "base_latest": 2.442,
  "quote_latest": 3.87,
  "sources": {"base": "ECB", "quote": "Federal Reserve Bank of New York"},
  "data": [
    {"date": "2026-10-01", "base_val": 2.442, "quote_val": 3.87, "spread": -1.428, "spread_bps": -142.8,
     "base_announcement_datetime": 1790841600, "quote_announcement_datetime": 1790942400},
    {"date": "2026-09-30", "base_val": 2.437, "quote_val": 3.9, "spread": -1.463, "spread_bps": -146.3,
     "base_announcement_datetime": 1790755200, "quote_announcement_datetime": 1790856000}
  ]
}

The euro leg is the ECB's euro short-term rate and the dollar leg is SOFR as published by the New York Fed. Both sat where policy put them: SOFR traded between 3.62% and 3.68% while the Fed's target range was 3.50% to 3.75%, then moved to 3.85% to 3.90% after the Federal Reserve raised the range to 3.75% to 4.00% on 16 September.

The trader takeaway is that the spread barely moved through a month in which both central banks tightened. The European Central Bank lifted its deposit rate by 25 basis points to 2.50% on 10 September and the Fed matched it a week later, so the euro's rate disadvantage ended September close to where it started, around 143 to 147 basis points. The single-day reading of −117.9 bps on 16 September is a timing effect, not a regime change: the euro rate repriced on that date while SOFR did not reset until the next day. That is exactly why a matched-date spread series is more useful than two disconnected headlines. If EUR/USD rallies on ECB-hike news while the differential is unchanged, the rates channel is not confirming the move.

What These Endpoints Actually Improve

• Less manual curve math: you no longer need to rebuild forward segments from individual tenor pulls every time you want a quick view.
• Cleaner pair comparison: the differential endpoint aligns both legs on exact shared dates instead of leaving you to reconcile two series manually.
• Better carry framing: the output is naturally useful for pair selection, relative-value work, and post-central-bank repricing checks.
• More faithful rates context: traders can move from spot curve shape to pair spread without leaving the FXMacroData rates surface or the bond yields dashboard.

Get Started

Start with the public documentation for UK government bond yields, US risk-free rate, and euro-area risk-free rate, then use the rates-and-curves endpoints to compare what each curve is implying at the pair level. If you want a visual cross-check before a trade, use the bond-yields dashboard alongside the API output.

The result is a faster workflow for anyone trading macro FX through the rates channel: inspect the curve, compare the spread, then decide whether the pair move is being confirmed or challenged by the path the market is pricing.