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.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Term optional
term Bond maturity, such as 10-year, 3-month, or overnight. Leave blank for all terms.
(default)
- Country optional
country Country to show, such as Germany or United States. Leave blank for all countries shown.
(default)
Input as JSON
{}Output
{ "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 } ]}Code
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":{}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "investing.com/get_bond_yields" , "input": {}})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "investing.com/get_bond_yields" , "input": {} }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run investing.com/get_bond_yields# with {}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
investing.com/get_bond_yields- Returns
- country, term, yield, previous yield, change, daily high/low, quote time, bond page URL
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method investing.com/get_bond_yields with the inputs above.
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.
See more
All Investing.com methodsGets 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/get_commodity_pricesLists 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.
investing.com/get_economic_calendarGets official daily Treasury par yield curve rates for a date, or the latest published date on or before it.
home.treasury.gov/get_treasury_yieldsReturns 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.
tradingeconomics.com/get_country_overviewExplains a finance, business, or investing term using its Investopedia dictionary article.
investopedia.com/define_termGets 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.
treasury.gov/get_reporting_exchange_ratesLists 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.
bankrate.com/list_best_savings_ratesGets 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.
google.com/get_quote