{"openapi":"3.1.0","info":{"title":"World Government Bond Yields API","version":"1.0.0","description":"Live long-term (about 10-year) government bond interest rates for around 44 countries, side by side, served from the OECD's official statistics in a single live call. The long-term government bond yield is the benchmark cost of money for an economy, and this puts the whole developed world on one screen — the United States, Germany, the United Kingdom, Japan, Canada, Australia, Brazil, Switzerland, Mexico, Colombia and dozens more — each with its latest published rate and the month it covers. The yields endpoint returns every country ranked by yield together with its spread over the German Bund, the euro-area safe-asset benchmark: in mid-2026 Colombia near 13.2%, Mexico 9.5% and Brazil 9.1% sit at the top while Switzerland near 0.5% sits at the bottom, with the US around 4.5% and the German Bund around 3.0%. The country endpoint returns one country's long-term yield with two years of recent monthly history. The spreads endpoint ranks every country by its yield spread over a chosen benchmark — Germany or the United States — the risk-and-rate-differential picture fixed-income and macro desks watch. This is the international-rates comparison layer for any fixed-income, forex, macro or research app. Live from the OECD, nothing stored. Distinct from single-country central-bank and yield-curve APIs — this is the cross-country sovereign-yield comparison across the developed world. Monthly OECD series; 4 endpoints. No key, no cache.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/worldbonds-api","description":"oanor gateway"}],"tags":[{"name":"Bonds"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/country":{"get":{"operationId":"get_v1_country","tags":["Bonds"],"summary":"One country's long-term yield + history","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"Country code (ISO-3 like USA/DEU/GBR, or common ISO-2 like US/GB)","schema":{"type":"string"},"example":"USA"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"code":"USA","period":"2026-05","source":"OECD","country":"United States","history":[{"value":4.31,"period":"2024-06"},{"value":4.25,"period":"2024-07"},{"value":3.87,"period":"2024-08"},{"value":3.72,"period":"2024-09"},{"value":4.1,"period":"2024-10"},{"value":4.36,"period":"2024-11"},{"value":4.39,"period":"2024-12"},{"value":4.63,"period":"2025-01"},{"value":4.45,"period":"2025-02"},{"value":4.28,"period":"2025-03"},{"value":4.28,"period":"2025-04"},{"value":4.42,"period":"2025-05"},{"value":4.38,"period":"2025-06"},{"value":4.39,"period":"2025-07"},{"value":4.26,"period":"2025-08"},{"value":4.12,"period":"2025-09"},{"value":4.06,"period":"2025-10"},{"value":4.09,"period":"2025-11"},{"value":4.14,"period":"2025-12"},{"value":4.21,"period":"2026-01"},{"value":4.13,"period":"2026-02"},{"value":4.25,"period":"2026-03"},{"value":4.32,"period":"2026-04"},{"value":4.48,"period":"2026-05"}],"measure":"long-term (≈10Y) government bond yield","yield_pct":4.48},"meta":{"timestamp":"2026-06-09T11:38:38.164Z","request_id":"8ed65544-0844-49a6-9817-9e4c9177f208"},"status":"ok","message":"Country yield retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/spreads":{"get":{"operationId":"get_v1_spreads","tags":["Bonds"],"summary":"Countries ranked by spread over a benchmark","description":"","parameters":[{"name":"vs","in":"query","required":false,"description":"Benchmark country (DEU or USA; default DEU)","schema":{"type":"string"},"example":"DEU"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"as_of":"2026-05","count":43,"source":"OECD","spreads":[{"code":"COL","country":"Colombia","yield_pct":13.16,"spread_bps":1011},{"code":"MEX","country":"Mexico","yield_pct":9.45,"spread_bps":640},{"code":"BRA","country":"Brazil","yield_pct":9.13,"spread_bps":608},{"code":"ZAF","country":"South Africa","yield_pct":8.995,"spread_bps":595},{"code":"IND","country":"India","yield_pct":6.84,"spread_bps":379},{"code":"CRI","country":"Costa Rica","yield_pct":6.6325,"spread_bps":359},{"code":"ROU","country":"Romania","yield_pct":6.15,"spread_bps":310},{"code":"POL","country":"Poland","yield_pct":5.74,"spread_bps":269},{"code":"HUN","country":"Hungary","yield_pct":5.65,"spread_bps":260},{"code":"CHL","country":"Chile","yield_pct":5.4647,"spread_bps":242},{"code":"AUS","country":"Australia","yield_pct":4.99,"spread_bps":194},{"code":"GBR","country":"United Kingdom","yield_pct":4.9416,"spread_bps":190},{"code":"CZE","country":"Czechia","yield_pct":4.7383,"spread_bps":169},{"code":"NZL","country":"New Zealand","yield_pct":4.68,"spread_bps":163},{"code":"USA","country":"United States","yield_pct":4.48,"spread_bps":143},{"code":"NOR","country":"Norway","yield_pct":4.3299,"spread_bps":128},{"code":"KOR","country":"Korea","yield_pct":4.075,"spread_bps":103},{"code":"ISR","country":"Israel","yield_pct":3.982,"spread_bps":94},{"code":"BGR","country":"Bulgaria","yield_pct":3.95,"spread_bps":90},{"code":"ITA","country":"Italy","yield_pct":3.818,"spread_bps":77},{"code":"LVA","country":"Latvia","yield_pct":3.79,"spread_bps":74},{"code":"GRC","country":"Greece","yield_pct":3.78,"spread_bps":73},{"code":"FRA","country":"France","yield_pct":3.7416,"spread_bps":70},{"code":"BEL","country":"Belgium","yield_pct":3.6,"spread_bps":55},{"code":"SVK","country":"Slovak Republic","yield_pct":3.5583,"spread_bps":51},{"code":"HRV","country":"Croatia","yield_pct":3.55,"spread_bps":50},{"code":"CAN","country":"Canada","yield_pct":3.5415,"spread_bps":50},{"code":"EA20","country":"Euro area (20 countries)","yield_pct":3.4898,"spread_bps":44},{"code":"ESP","country":"Spain","yield_pct":3.4823,"spread_bps":44},{"code":"PRT","country":"Portugal","yield_pct":3.42,"spread_bps":37},{"code":"EST","country":"Estonia","yield_pct":3.4,"spread_bps":35},{"code":"SVN","country":"Slovenia","yield_pct":3.4,"spread_bps":35},{"code":"FIN","country":"Finland","yield_pct":3.38,"spread_bps":33},{"code":"AUT","country":"Austria","yield_pct":3.3033,"spread_bps":26},{"code":"LUX","country":"Luxembourg","yield_pct":3.244,"spread_bps":20},{"code":"IRL","country":"Ireland","yield_pct":3.2411,"spread_bps":19},{"code":"NLD","country":"Netherlands","yield_pct":3.15,"spread_bps":10},{"code":"DNK","country":"Denmark","yield_pct":2.888,"spread_bps":-16},{"code":"LTU","country":"Lithuania","yield_pct":2.88,"spread_bps":-17},{"code":"SWE","country":"Sweden","yield_pct":2.7446,"spread_bps":-30},{"code":"JPN","country":"Japan","yield_pct":2.65,"spread_bps":-40},{"code":"CHN","country":"China (People’s Republic of)","yield_pct":1.82,"spread_bps":-123},{"code":"CHE","country":"Switzerland","yield_pct":0.45,"spread_bps":-260}],"benchmark":{"code":"DEU","country":"Germany","yield_pct":3.0465}},"meta":{"timestamp":"2026-06-09T11:38:39.580Z","request_id":"6baf09c2-396c-456e-8be7-42dd7f442df1"},"status":"ok","message":"Spreads retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/yields":{"get":{"operationId":"get_v1_yields","tags":["Bonds"],"summary":"All countries' latest long-term yields, ranked","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"as_of":"2026-05","count":44,"source":"OECD","yields":[{"code":"COL","period":"2026-04","country":"Colombia","yield_pct":13.16,"spread_vs_bund_bps":1011},{"code":"MEX","period":"2026-05","country":"Mexico","yield_pct":9.45,"spread_vs_bund_bps":640},{"code":"BRA","period":"2026-05","country":"Brazil","yield_pct":9.13,"spread_vs_bund_bps":608},{"code":"ZAF","period":"2026-05","country":"South Africa","yield_pct":8.995,"spread_vs_bund_bps":595},{"code":"IND","period":"2026-03","country":"India","yield_pct":6.84,"spread_vs_bund_bps":379},{"code":"CRI","period":"2026-04","country":"Costa Rica","yield_pct":6.6325,"spread_vs_bund_bps":359},{"code":"ROU","period":"2026-04","country":"Romania","yield_pct":6.15,"spread_vs_bund_bps":310},{"code":"POL","period":"2026-05","country":"Poland","yield_pct":5.74,"spread_vs_bund_bps":269},{"code":"HUN","period":"2026-05","country":"Hungary","yield_pct":5.65,"spread_vs_bund_bps":260},{"code":"CHL","period":"2026-04","country":"Chile","yield_pct":5.4647,"spread_vs_bund_bps":242},{"code":"AUS","period":"2026-05","country":"Australia","yield_pct":4.99,"spread_vs_bund_bps":194},{"code":"GBR","period":"2026-05","country":"United Kingdom","yield_pct":4.9416,"spread_vs_bund_bps":190},{"code":"CZE","period":"2026-04","country":"Czechia","yield_pct":4.7383,"spread_vs_bund_bps":169},{"code":"NZL","period":"2026-05","country":"New Zealand","yield_pct":4.68,"spread_vs_bund_bps":163},{"code":"USA","period":"2026-05","country":"United States","yield_pct":4.48,"spread_vs_bund_bps":143},{"code":"NOR","period":"2026-05","country":"Norway","yield_pct":4.3299,"spread_vs_bund_bps":128},{"code":"KOR","period":"2026-05","country":"Korea","yield_pct":4.075,"spread_vs_bund_bps":103},{"code":"ISR","period":"2026-05","country":"Israel","yield_pct":3.982,"spread_vs_bund_bps":94},{"code":"BGR","period":"2026-04","country":"Bulgaria","yield_pct":3.95,"spread_vs_bund_bps":90},{"code":"ITA","period":"2026-04","country":"Italy","yield_pct":3.818,"spread_vs_bund_bps":77},{"code":"LVA","period":"2026-04","country":"Latvia","yield_pct":3.79,"spread_vs_bund_bps":74},{"code":"GRC","period":"2026-04","country":"Greece","yield_pct":3.78,"spread_vs_bund_bps":73},{"code":"FRA","period":"2026-05","country":"France","yield_pct":3.7416,"spread_vs_bund_bps":70},{"code":"BEL","period":"2026-05","country":"Belgium","yield_pct":3.6,"spread_vs_bund_bps":55},{"code":"SVK","period":"2026-04","country":"Slovak Republic","yield_pct":3.5583,"spread_vs_bund_bps":51},{"code":"HRV","period":"2026-04","country":"Croatia","yield_pct":3.55,"spread_vs_bund_bps":50},{"code":"CAN","period":"2026-05","country":"Canada","yield_pct":3.5415,"spread_vs_bund_bps":50},{"code":"EA20","period":"2026-05","country":"Euro area (20 countries)","yield_pct":3.4898,"spread_vs_bund_bps":44},{"code":"ESP","period":"2026-05","country":"Spain","yield_pct":3.4823,"spread_vs_bund_bps":44},{"code":"PRT","period":"2026-05","country":"Portugal","yield_pct":3.42,"spread_vs_bund_bps":37},{"code":"EST","period":"2026-04","country":"Estonia","yield_pct":3.4,"spread_vs_bund_bps":35},{"code":"SVN","period":"2026-04","country":"Slovenia","yield_pct":3.4,"spread_vs_bund_bps":35},{"code":"FIN","period":"2026-04","country":"Finland","yield_pct":3.38,"spread_vs_bund_bps":33},{"code":"AUT","period":"2026-04","country":"Austria","yield_pct":3.3033,"spread_vs_bund_bps":26},{"code":"LUX","period":"2026-04","country":"Luxembourg","yield_pct":3.244,"spread_vs_bund_bps":20},{"code":"IRL","period":"2026-04","country":"Ireland","yield_pct":3.2411,"spread_vs_bund_bps":19},{"code":"NLD","period":"2026-04","country":"Netherlands","yield_pct":3.15,"spread_vs_bund_bps":10},{"code":"DEU","period":"2026-05","country":"Germany","yield_pct":3.0465,"spread_vs_bund_bps":0},{"code":"DNK","period":"2026-04","country":"Denmark","yield_pct":2.888,"spread_vs_bund_bps":-16},{"code":"LTU","period":"2026-04","country":"Lithuania","yield_pct":2.88,"spread_vs_bund_bps":-17},{"code":"SWE","period":"2026-05","country":"Sweden","yield_pct":2.7446,"spread_vs_bund_bps":-30},{"code":"JPN","period":"2026-05","country":"Japan","yield_pct":2.65,"spread_vs_bund_bps":-40},{"code":"CHN","period":"2026-03","country":"China (People’s Republic of)","yield_pct":1.82,"spread_vs_bund_bps":-123},{"code":"CHE","period":"2026-04","country":"Switzerland","yield_pct":0.45,"spread_vs_bund_bps":-260}],"measure":"long-term (≈10Y) government bond yield","benchmark":"spread over German Bund (DEU)"},"meta":{"timestamp":"2026-06-09T11:38:41.061Z","request_id":"40e4e565-6e63-4a04-9a0b-881d8bb31c18"},"status":"ok","message":"Yields retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"OECD SDMX long-term interest rates (IRLT, monthly; live)","service":"worldbonds-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/yields":"All countries' latest long-term yield, ranked, + spread over the German Bund.","GET /v1/country":"One country's long-term yield + recent monthly history (code=USA, or ISO-2 like US).","GET /v1/spreads":"Every country ranked by spread over a benchmark (vs=DEU or USA)."},"description":"Live long-term (≈10-year) government bond interest rates for ~44 countries side by side, from the OECD's official statistics in a single live call: the US, Germany, UK, Japan, Canada, Australia, Brazil, Switzerland and dozens more, each with its latest rate and the month it covers; every country ranked by yield with its spread over the German Bund; one country's rate with recent monthly history; and every country ranked by its spread over a chosen benchmark (Germany or the US). Live, no key, nothing stored. Distinct from single-country central-bank and yield-curve APIs — this is the cross-country sovereign-yield comparison across the developed world.","upstream_status":"ok","countries_available":44},"meta":{"timestamp":"2026-06-09T11:38:42.499Z","request_id":"f23b607a-ac2d-45df-9252-b090449bcf64"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":800,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1100,"monthly_call_quota":15000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2900,"monthly_call_quota":90000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6900,"monthly_call_quota":500000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/worldbonds-api"}