# Investing.com API: Get government bond yields

> Gets current government bond yields from Investing.com's world government bonds table, optionally filtered by country and maturity term.

Unofficial. Not affiliated with or endorsed by Investing.com.

- Page: https://fous.com/methods/investing.com/get-bond-yields
- Method: `investing.com/get_bond_yields`, version 1
- Website: investing.com
- Returns: country, term, yield, previous yield, change, daily high/low, quote time, bond page URL
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `term` | string | no |  | Bond maturity, such as 10-year, 3-month, or overnight. Leave blank for all terms. Default "". |
| `country` | string | no |  | Country to show, such as Germany or United States. Leave blank for all countries shown. Default "". |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{}
```

Its output:

```json
{
  "bonds": [
    {
      "term": "1-year",
      "country": "Australia",
      "page_url": "https://www.investing.com/rates-bonds/australia-1-year-bond-yield",
      "price_time": "2026-09-28T23:37:53-04:00",
      "yield_percent": 4.888,
      "day_low_percent": 4.871,
      "day_high_percent": 4.911,
      "previous_yield_percent": 4.895,
      "change_percentage_points": -0.007
    },
    {
      "term": "2-year",
      "country": "Australia",
      "page_url": "https://www.investing.com/rates-bonds/australia-2-year-bond-yield",
      "price_time": "2026-09-28T23:37:53-04:00",
      "yield_percent": 5.035,
      "day_low_percent": 5.032,
      "day_high_percent": 5.101,
      "previous_yield_percent": 5.061,
      "change_percentage_points": -0.026
    },
    {
      "term": "3-year",
      "country": "Australia",
      "page_url": "https://www.investing.com/rates-bonds/australia-3-year-bond-yield",
      "price_time": "2026-09-28T23:37:27-04:00",
      "yield_percent": 5,
      "day_low_percent": 4.996,
      "day_high_percent": 5.083,
      "previous_yield_percent": 5.033,
      "change_percentage_points": -0.033
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"investing.com/get_bond_yields","input":{}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What's the current 10-year German Bund yield and how much has it moved today?
- Pull the latest Japan 2-year government bond yield from investing.com, including the daily high and low.
- Show me all the sovereign bond yields for Italy across every maturity right now.
- I need today's 3-month yields for every country listed, with the previous close and change.
- Check investing.com for the US 30-year Treasury yield and the time it was last quoted.

## Input schema

```json
{
  "type": "object",
  "properties": {
    "term": {
      "type": "string",
      "default": "",
      "description": "Bond maturity, such as 10-year, 3-month, or overnight. Leave blank for all terms."
    },
    "country": {
      "type": "string",
      "default": "",
      "description": "Country to show, such as Germany or United States. Leave blank for all countries shown."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "bonds"
  ],
  "properties": {
    "bonds": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "country",
          "term",
          "yield_percent",
          "previous_yield_percent",
          "change_percentage_points",
          "day_high_percent",
          "day_low_percent",
          "price_time",
          "page_url"
        ],
        "properties": {
          "term": {
            "type": "string",
            "description": "Maturity in words, such as 10-year."
          },
          "country": {
            "type": "string",
            "description": "Country of the bond."
          },
          "page_url": {
            "type": "string",
            "description": "Page for this bond."
          },
          "price_time": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Quote time with time-zone offset, or null when unavailable."
          },
          "yield_percent": {
            "type": [
              "number",
              "null"
            ],
            "description": "Current quoted yield in percent."
          },
          "day_low_percent": {
            "type": [
              "number",
              "null"
            ],
            "description": "Daily low yield in percent."
          },
          "day_high_percent": {
            "type": [
              "number",
              "null"
            ],
            "description": "Daily high yield in percent."
          },
          "previous_yield_percent": {
            "type": [
              "number",
              "null"
            ],
            "description": "Previous quoted yield in percent."
          },
          "change_percentage_points": {
            "type": [
              "number",
              "null"
            ],
            "description": "Displayed change in yield, in percentage points."
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
```

## See more

- [Investing.com API: Get commodity prices](https://fous.com/methods/investing.com/get-commodity-prices.md): Gets current quoted prices for energy, metals, and agricultural commodities from Investing.com's real-time futures page, optionally for one commodity. Some quotes may be delayed or indicative; units are null when the contract specification is missing.
- [Investing.com API: Get economic calendar](https://fous.com/methods/investing.com/get-economic-calendar.md): Lists scheduled and recent economic releases from the Investing.com economic calendar for a date range (up to 31 days, default this week), countries and importance, with actual, forecast and previous values as displayed, in the requested time zone.
- [U.S. Treasury API: Get Treasury yields](https://fous.com/methods/home.treasury.gov/get-treasury-yields.md): Gets official daily Treasury par yield curve rates for a date, or the latest published date on or before it.
- [Trading Economics API: Get country economic overview](https://fous.com/methods/tradingeconomics.com/get-country-overview.md): Returns seven key economic indicators for a country from its public Trading Economics overview: GDP growth rate, inflation rate, interest rate, unemployment rate, government debt to GDP, currency and stock market. Indicators absent from the overview are null; the US dollar index is not reported as a USD exchange rate.
- [Investopedia API: Define finance term](https://fous.com/methods/investopedia.com/define-term.md): Explains a finance, business, or investing term using its Investopedia dictionary article.
- [U.S. Treasury API: Get reporting exchange rates](https://fous.com/methods/treasury.gov/get-reporting-exchange-rates.md): Gets the U.S. Treasury quarterly reporting exchange rate for a country or currency on a given date. If that quarter has no published record, it uses the latest preceding quarter.
- [Bankrate API: List best savings, CD or money market rates](https://fous.com/methods/bankrate.com/list-best-savings-rates.md): Lists Bankrate's current high-yield savings, CD (for a chosen term) or money market account rates in Bankrate's listed order, with APY, minimum deposit and whether the listing is sponsored.
- [Google API: Get quote](https://fous.com/methods/google.com/get-quote.md): Gets the current quoted price and key figures for a stock, fund, index, or cryptocurrency on Google Finance, by name or ticker. Prices may be delayed, and figures Google does not show are null.
- [All Investing.com methods](https://fous.com/methods/investing.com.md)
