Introducing the Bond Yields Endpoint

The FXMacroData bond yields endpoint is now live across eight major currencies. In a single call you can pull the full government yield curve for a currency — from the short-dated 1-year tenor all the way to the 40-year ultra-long — and track inter-market spread dynamics with second-level announcement timestamps for every series update.

What's New

Government bond yield data is served through the standard announcements route: /api/v1/announcements/{currency}/{indicator}, where indicator is one of the gov_bond_* slugs. Supported tenors vary by currency and reflect what each central bank or treasury publishes directly. The full set of available tenors per currency is listed in the API documentation hub.

Each data point in the response contains the standard announcement fields — date, val (yield in percent), and announcement_datetime — so the bond yield series integrates directly with any existing announcement-endpoint workflow without schema changes.

Why It Matters for Traders

Yield differentials between currencies are among the most persistent drivers of FX flows. When the US 10-year yield pulls 50 basis points above its German Bund equivalent, risk-adjusted carry shifts in favour of the dollar and capital allocation follows. The same logic applies across every G10 currency pair — the spread between two sovereign curves shapes the direction and momentum of the corresponding exchange rate.

Beyond spreads, the shape of a single country's yield curve tells you how the market is pricing future policy. A steepening curve — short rates anchored while long rates rise — signals an expectation of higher growth or inflation ahead. A flat or inverted curve often precedes central bank easing cycles. Monitoring those shifts in real time, across currencies, is now a single endpoint call away via the USD 10-year endpoint or any other supported tenor.

Practical Example: USD Yield Curve Snapshot

Suppose you want to reconstruct the current US Treasury yield curve across key maturities. You can pull each tenor individually. Here is a request for the benchmark 10-year yield:

curl "https://fxmacrodata.com/api/v1/announcements/usd/gov_bond_10y?api_key=YOUR_API_KEY"

Representative response:

{
  "currency": "USD",
  "indicator": "gov_bond_10y",
  "data": [
    {
      "date": "2026-04-14",
      "val": 4.38,
      "announcement_datetime": 1744588800
    },
    {
      "date": "2026-04-13",
      "val": 4.42,
      "announcement_datetime": 1744502400
    },
    {
      "date": "2026-04-12",
      "val": 4.45,
      "announcement_datetime": 1744416000
    }
  ]
}

Each row gives you the closing yield for that business day alongside a precise announcement_datetime epoch. To build the full curve, repeat the call for gov_bond_2y, gov_bond_5y, and gov_bond_30y. The 2s10s spread on those numbers is −0.04 percentage points — nearly flat — signalling that the market is pricing in limited long-run rate divergence from the current policy rate.

Practical Example: JPY–USD 10-Year Spread

USD/JPY has historically tracked the differential between US and Japanese 10-year yields closely. Here is how you would pull both sides of that spread in two sequential calls:

# US 10-year
curl "https://fxmacrodata.com/api/v1/announcements/usd/gov_bond_10y?api_key=YOUR_API_KEY"

# Japanese 10-year (JGB)
curl "https://fxmacrodata.com/api/v1/announcements/jpy/gov_bond_10y?api_key=YOUR_API_KEY"

Representative JPY response:

{
  "currency": "JPY",
  "indicator": "gov_bond_10y",
  "data": [
    {
      "date": "2026-04-14",
      "val": 1.52,
      "announcement_datetime": 1744588800
    },
    {
      "date": "2026-04-13",
      "val": 1.49,
      "announcement_datetime": 1744502400
    }
  ]
}

On these numbers the USD–JPY 10-year spread is roughly 2.86 percentage points. Compared with the historical mean, that is still a wide carry premium in favour of the dollar. A trader monitoring USD/JPY can overlay these series against spot to assess whether the exchange rate has already priced in the spread or is lagging behind. The JPY 10Y endpoint sources data directly from the Japanese Ministry of Finance, ensuring official publication accuracy.

Practical Example: AUD Curve Steepness Signal

Before an RBA decision, some traders monitor whether the AUD curve is steepening into the event — a sign that markets expect the cash rate to remain higher for longer. Fetch the 2-year and 10-year:

# AUD 2-year yield
curl "https://fxmacrodata.com/api/v1/announcements/aud/gov_bond_2y?api_key=YOUR_API_KEY"

# AUD 10-year yield
curl "https://fxmacrodata.com/api/v1/announcements/aud/gov_bond_10y?api_key=YOUR_API_KEY"

Representative AUD 2Y response:

{
  "currency": "AUD",
  "indicator": "gov_bond_2y",
  "data": [
    {
      "date": "2026-04-14",
      "val": 3.82,
      "announcement_datetime": 1744588800
    }
  ]
}

With a 10-year AUD yield sitting near 4.55% on the same date, the 2s10s spread is around 73 basis points — a moderately steep curve. A steepening trend heading into an RBA meeting can indicate that the market is betting on easing at the short end while pushing up long-term inflation expectations. Pair this with the AUD policy rate history and the AUD inflation series for a rounded pre-meeting view.

Get Started

All bond yield indicators follow the same endpoint pattern as other FXMacroData announcements — no additional configuration is required. Browse the available tenors for each currency in the API documentation hub and start querying with your existing API key.