Back to API Index

2-Year Government Bond Yield (JPY)

Reference information for 2-Year Government Bond Yield.

Latest reading: 0.77 Percent · Last updated: · Source: MOF

Category: Government Bond Yields

API Endpoint

/api/v1/announcements/jpy/gov_bond_2y

Use the production OpenAPI schema for the authoritative REST route metadata.

https://fxmacrodata.com/api/openapi.json

Browse the full endpoint reference

Compare 2-Year Government Bond Yield across all supported currencies →

Optional Indicator Availability (JPY)

Optional indicators use per-currency fetcher capability checks and may be temporarily hidden while source coverage is being remediated.

foreign_reserves
Available
cb_assets
Available
inflation_mom
Unavailable Not implemented on this currency fetcher yet.

About 2-Year Government Bond Yield (JPY)

The 2-year government bond yield for Japan reflects the market's expectation for the Bank of Japan's policy rate over the next two years. It is the most policy-sensitive point on the yield curve.

Why FX traders watch it

The 2-year yield is the primary market tool for pricing central bank expectations. Rising 2-year yields indicate markets expect the Bank of Japan to keep rates high or hike, supporting the jpy via interest rate differentials.

How to interpret the data

Yields moving higher are jpy-positive through the interest rate differential channel. The 2y-10y spread is a widely tracked recession indicator: an inverted curve (2y > 10y) historically precedes economic slowdowns.

Historical 2-Year Government Bond Yield (JPY)

Source: MOF  ·  Daily  ·  Percent

Data provided by FXMacroData via the /api/v1/announcements/jpy/gov_bond_2y endpoint. For access, see pricing.

Data Source

Primary Source

MOF

Official Series ID

JGB_2Y

Data Format and Properties

Data Frequency

Daily

Unit of Measure

Percent

JSON Response Structure

The endpoint returns a chronological list of observations in JSON format. 

{
    "currency": "JPY",
    "indicator": "gov_bond_2y",
    "has_official_forecast": false,
    "start_date": "2023-01-01",
    "end_date": "2023-12-31",
    "data": [
        {
            "date": "2024-07-01",
            "val": 4.2,
            "announcement_datetime": 1722456000
        }
    ]
}

Request Parameters & Usage

Parameter Required Format Description
start_date NO YYYY-MM-DD Optional lower bound for the requested history.
end_date NO YYYY-MM-DD Optional upper bound. Defaults to the current date.
api_key CONDITIONAL string Required for non-USD announcement requests. USD announcement requests are public without an API key.

Example Usage

To retrieve 2-Year Government Bond Yield data for JPY from 2023: 

GET https://fxmacrodata.com/api/v1/announcements/jpy/gov_bond_2y?start_date=2023-01-01&end_date=2023-12-31&api_key=YOUR_API_KEY

Frequently Asked Questions

How often is Japan 2-Year Government Bond Yield updated?
2-Year Government Bond Yield for Japan is released on a daily schedule by Bank of Japan (or the relevant national statistics agency). FXMacroData ingests each new value within seconds of the official publication and exposes the exact announcement timestamp on every record.
What unit is 2-Year Government Bond Yield reported in?
The series is published in Percent. The exact unit is also returned on every API response under the indicator metadata.
Where does FXMacroData source Japan 2-Year Government Bond Yield data?
Data is fetched directly from Bank of Japan or the official national statistics publication for Japan. The source URL is preserved on every announcement record so downstream consumers can trace the value back to its primary release.
How do I query 2-Year Government Bond Yield for Japan via the API?
Issue a GET request to /api/v1/announcements/jpy/gov_bond_2y?api_key=YOUR_API_KEY. The response contains a chronological list of observations with values, release dates, and announcement timestamps. USD announcement data is public; other currencies require a Professional API key.