Where can I access historical 3-Year Government Bond Yield data for Japan?

Historical 3-Year Government Bond Yield data for Japan is available at /api/v1/announcements/jpy/gov_bond_3y.

Japan 3-Year Government Bond Yield API Data

Why FX traders watch it

Japan's 3-Year Government Bond Yield is monitored by the Bank of Japan when assessing the health of the economy and calibrating monetary policy. Surprises relative to consensus can move the jpy in the short term.

How to interpret the data

A reading above market expectations typically signals stronger-than-anticipated conditions and is broadly supportive of the jpy. A miss versus consensus can shift rate expectations and weigh on the jpy.

Coverage window

Currently documented history runs from 2016-06-15 to 2025-06-04 for this endpoint.

History start

2016-06-15

Latest documented date

2025-06-04

Data Source

Primary Source

MOF

Official Series ID

JGB_3Y

External Link

View Official Data Page

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, plus pagination metadata so larger series can be fetched page by page.

{
  "currency": "JPY",
  "indicator": "gov_bond_3y",
  "has_official_forecast": false,
  "start_date": "2016-06-15",
  "end_date": "2025-06-04",
  "earliest_available_date": "2016-06-15",
  "latest_available_date": "2025-06-04",
  "pagination": {
    "limit": 20,
    "offset": 0,
    "returned_count": 1,
    "total_count": 1,
    "has_more": false,
    "next_offset": null
  },
  "cb_target": null,
  "data": [
    {
      "date": "2025-06-04",
      "announcement_id": "jpy_gov_bond_3y_2025-06-04",
      "val": 4.2,
      "announcement_datetime": 1722456000,
      "pct_change": null,
      "pct_change_12m": null
    }
  ]
}

Request Parameters & Usage

Access and authentication

USD is free without a key. All other currencies require a Professional API key.

Public USD endpoint — anonymous callers receive the most recent 365 days. Add `?api_key=YOUR_API_KEY` to extend the window for USD or to access any other currency. Date filters are applied before pagination. The default page size is 20 rows and the maximum is 100. Forecasts are served separately by /v1/predictions/jpy; join via `announcement_id`.

Path parameters

Parameter	Required	Type	Description
`currency`	YES	string	3-letter currency code.
`indicator`	YES	string	Indicator slug. Use /v1/data_catalogue/{currency} to list available slugs per currency.

Query parameters

Parameter	Required	Format	Description
`start_date`	NO	string (YYYY-MM-DD)	Earliest observation date to include. Date filters are applied before pagination. Defaults to 365 days ago.
`end_date`	NO	string (YYYY-MM-DD)	Latest observation date to include. Defaults to today.
`limit`	NO	integer	Maximum number of rows to return per page. Defaults to 20; maximum 100.
`offset`	NO	integer	Zero-based row offset after date filtering. Use with pagination.next_offset to request the next page.
`api_key`	Pro (USD: free for last 365 days)	string	Professional API key. Required for non-USD currencies and for USD requests that need history older than 365 days.

Pagination behavior

Use start_date and end_date to narrow the series first, then page through the filtered result with limit and offset. The response includes earliest_available_date and latest_available_date for the full series coverage, plus a pagination object with returned_count, total_count, has_more, and next_offset.

Response fields

Field	Type	Description
`currency`	string	3-letter currency code.
`indicator`	string	Indicator slug as requested.
`has_official_forecast`	boolean	True if the central bank publishes an official forecast for this indicator.
`start_date`	string	Earliest date in the filtered result set (YYYY-MM-DD).
`end_date`	string	Latest date in the filtered result set (YYYY-MM-DD).
`earliest_available_date`	string \| null	Earliest date available for this series before any date filter or pagination is applied.
`latest_available_date`	string \| null	Latest date available for this series before pagination is applied.
`pagination.limit`	integer	Page size used for this response.
`pagination.offset`	integer	Zero-based offset used for this response.
`pagination.returned_count`	integer	Number of rows included in data[].
`pagination.total_count`	integer	Total number of rows matching the path and date filters before pagination.
`pagination.has_more`	boolean	True when another page is available.
`pagination.next_offset`	integer \| null	Offset to use for the next page, or null when there are no more rows.
`cb_target`	object \| null	Central bank target metadata (e.g. inflation target range), if applicable.
`data[].date`	string	Observation date (YYYY-MM-DD).
`data[].announcement_id`	string	Stable announcement identifier in the form `{currency}_{indicator}_{date}` — use it to join predictions from /v1/predictions/{currency} and revision history.
`data[].val`	number \| null	Observed value in the indicator's native unit.
`data[].announcement_datetime`	integer \| null	Unix timestamp (UTC) of the official data release.
`data[].pct_change`	number \| null	Period-over-period percentage change.
`data[].pct_change_12m`	number \| null	12-month rolling percentage change.

Example Usage

To retrieve the first page of 3-Year Government Bond Yield data for JPY from 2023:

GET https://fxmacrodata.com/api/v1/announcements/jpy/gov_bond_3y?start_date=2023-01-01&end_date=2023-12-31&limit=20&offset=0&api_key=YOUR_API_KEY

Summarize article with AI:

ChatGPT Perplexity Claude Grok Gemini Mistral

AI Answer-Ready

Key Facts

Page: Gov Bond 3y
Section: API Data Docs
Canonical URL: https://fxmacrodata.com/api-data-docs/jpy/gov_bond_3y
Source: MOF
Last Updated: 2025-06-04

Provenance And Trust

Cite the canonical URL and source field above. Where available, this page maps to official publisher releases and timestamped updates.

What Changed

Latest change vs prior release: 0.0000 (0.00%)

Quick Q&A

What is this page about? This page explains Gov Bond 3y with directly usable context for trading, research, and API workflows.

What source should be cited? Use the canonical URL and the listed source field; cite official publisher references when available.

How fresh is this content? The last updated value above reflects the page metadata or latest available data timestamp.

Can this be used in AI assistants? Yes. This section is intentionally structured for retrieval and citation in chat assistants.

Prompt Packs

Use these in ChatGPT, Claude, Gemini, Mistral, Perplexity, or Grok for consistent source-aware outputs.

3-Year Government Bond Yield (JPY)

API Endpoint

Optional Indicator Availability (JPY)

About 3-Year Government Bond Yield (JPY)