API to Get Ireland Bond Yields

API to Get Ireland Bond Yields

You need reliable, machine-readable Ireland sovereign bond yields that plug straight into models, dashboards, and backtests. By the end of this guide you will know how to fetch current and historical Irish government bond yields, compute spreads, retrieve intraday snapshots, and build yield curves using Bonds API, with copy-pasteable requests you can drop into production.

What you get: Ireland sovereign bond yields in a developer-friendly API

Bonds API provides Irish government bond yields (ISO2: IE) across treasury bill and bond maturities via a REST interface at https://bonds-api.com. Data are returned as JSON and authenticated with an API key over HTTPS. Yields are expressed in percent (for example 4.52 means 4.52%, not 452 bps), and spreads are expressed in basis points (bps). Dates are YYYY-MM-DD; timestamps in responses are UTC unless otherwise stated.

Illustration: API to Get Ireland Bond Yields

Use cases include:

  • Building an Ireland (IE) yield curve across bills and bonds.
  • Monitoring 10Y yields and intraday snapshots for trading dashboards.
  • Computing Ireland-vs-benchmark spreads for risk and macro analysis.
  • Backtesting strategies with daily time series across business days.

For documentation and tools, see bonds-api.com and the developer console at MCP. To obtain an API key, Register and Get started with Bonds API.

Practical integration details for Ireland (IE)

Base URL: https://bonds-api.com/api/v1/ — all endpoints use GET and require the X-API-Key header. Do not put your key in query parameters when using the API documented in this guide.

  • Maturities: common points include 1M, 3M, 6M, 1Y, 2Y, 5Y, 10Y, 30Y (coverage may extend to other tenors). Use either the curve endpoint for the full set or latest with specific maturities.
  • Business days and holidays: Daily time series reflect trading/business days. Weekends and Irish market holidays will naturally have gaps; use the returned dates to align your time axis.
  • Update frequency: Latest yields refresh on trading days. Intraday endpoint provides multiple snapshots within a day with UTC timestamps.
  • Caching: Cache intraday snapshots for minutes; cache daily endpoints (latest, curve, timeseries) through the trading day and invalidate after market close or when a new date appears. Always honor the date fields in responses before overwriting stored values.

Below are all seven endpoints you’ll use to build a complete Ireland fixed-income workflow.

1) Get current Ireland yields: /latest

Fetch the latest available Irish yields. You can specify maturities to limit the payload or omit to return all available for the country.

cURL

curl -s "https://bonds-api.com/api/v1/latest?countries=US&maturities=10Y&api_key=YOUR_API_KEY"

Python (requests)

import requests

resp = requests.get(
"https://bonds-api.com/api/v1/latest",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"countries": "IE", "maturities": "2Y,10Y"}
)
data = resp.json()
# Example: data["data"]["IE"]["10Y"]["yield"] is a percentage (e.g., 4.52)

JavaScript (fetch)

const url = new URL("https://bonds-api.com/api/v1/latest");
url.search = new URLSearchParams({ countries: "IE", maturities: "2Y,10Y" }).toString();

fetch(url, { headers: { "X-API-Key": "YOUR_API_KEY" } })
.then(r => r.json())
.then(json => {
const ie10y = json.data.IE["10Y"].yield; // percent
const date = json.data.IE["10Y"].date; // YYYY-MM-DD
console.log("IE 10Y", ie10y, "on", date);
});

PHP (file_get_contents)

<?php
$context = stream_context_create([
"http" => [
"method" => "GET",
"header" => "X-API-Key: YOUR_API_KEY\r\n"
]
]);
$url = "https://bonds-api.com/api/v1/latest?countries=IE&maturities=2Y,10Y";
$json = file_get_contents($url, false, $context);
$data = json_decode($json, true);
// $data["data"]["IE"]["2Y"]["yield"] is percent
?>

JSON response (fields)

{
    "success": true,
    "date": "2026-11-06",
    "rates": {
        "US_10Y": 4.86
    },
    "dates": {
        "US_10Y": "2026-11-06"
    },
    "currencies": {
        "US_10Y": "USD"
    },
    "meta": {
        "request_id": "0e38a9bc-578f-424a-9172-e122d4bf4a2f",
        "timestamp": "2026-11-07T01:05:25+00:00"
    }
}

How to read it:

  • yield: percentage (e.g., 4.52 means 4.52%).
  • date: last available trading date in YYYY-MM-DD.
  • source: origin of the rate (e.g., official).

2) Get Ireland’s yield on a specific date: /historical

Useful for point-in-time backfills and reconciling portfolio valuations on a given date.

cURL

Python

import requests

params = {"country": "IE", "maturity": "10Y", "date": "2025-06-15"}
resp = requests.get(
"https://bonds-api.com/api/v1/historical",
headers={"X-API-Key": "YOUR_API_KEY"},
params=params
)
hist = resp.json()
# hist["yield"] is percent on 2025-06-15

JavaScript

const params = { country: "IE", maturity: "10Y", date: "2025-06-15" };
const qs = new URLSearchParams(params).toString();

fetch(`https://bonds-api.com/api/v1/historical?${qs}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(j => console.log(j.country, j.maturity, j.date, j.yield));

PHP (Guzzle)

<?php
require 'vendor/autoload.php';
$client = new \GuzzleHttp\Client(['base_uri' => 'https://bonds-api.com/api/v1/']);
$res = $client->request('GET', 'historical', [
'headers' => ['X-API-Key' => 'YOUR_API_KEY'],
'query' => ['country' => 'IE', 'maturity' => '10Y', 'date' => '2025-06-15']
]);
$data = json_decode($res->getBody(), true);
// $data['yield'] is percent
?>

JSON response

Interpretation:

  • yield: 4.38 means 4.38% on 2025-06-15.
  • source: data provenance.

3) Get a daily time series for Ireland: /timeseries

Pull daily yields for a maturity between two dates to power charts, quant screens, and backtests. The series contains trading days; non-trading days will not appear.

cURL

Python

import requests

params = {
"country": "IE",
"maturity": "10Y",
"start": "2025-11-07",
"end": "2026-11-07"
}
resp = requests.get("https://bonds-api.com/api/v1/timeseries",
headers={"X-API-Key": "YOUR_API_KEY"},
params=params)
ts = resp.json()
# ts["series"] is a list of {"date": "YYYY-MM-DD", "yield": percent}

JavaScript

const tsParams = {
country: "IE",
maturity: "10Y",
start: "2025-11-07",
end: "2026-11-07"
};
fetch(`https://bonds-api.com/api/v1/timeseries?${new URLSearchParams(tsParams)}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(j => j.series.forEach(pt => console.log(pt.date, pt.yield)));

PHP

<?php
$q = http_build_query([
'country' => 'IE',
'maturity' => '10Y',
'start' => '2025-11-07',
'end' => '2026-11-07'
]);
$opts = ['http' => ['header' => "X-API-Key: YOUR_API_KEY\r\n"]];
$ctx = stream_context_create($opts);
$json = file_get_contents("https://bonds-api.com/api/v1/timeseries?$q", false, $ctx);
$data = json_decode($json, true);
?>

JSON response

Interpretation:

  • series: array of daily observations (trading days only), yields in percent.

4) Compute Ireland’s spread vs a benchmark: /spread

Compare Irish yields to a benchmark sovereign (e.g., German Bund DE, US Treasury US) at a given maturity. Spreads are returned in basis points (bps).

cURL

Python

import requests

params = {"country": "IE", "benchmark": "US", "maturity": "10Y"}
resp = requests.get("https://bonds-api.com/api/v1/spread",
headers={"X-API-Key": "YOUR_API_KEY"},
params=params)
sp = resp.json()
# sp["spread_bps"] is in basis points (e.g., 215 means 2.15%)

JavaScript

const spParams = { country: "IE", benchmark: "US", maturity: "10Y" };
fetch(`https://bonds-api.com/api/v1/spread?${new URLSearchParams(spParams)}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(j => {
console.log(`IE vs ${j.benchmark} ${j.maturity} spread: ${j.spread_bps} bps`);
});

PHP

<?php
$q = http_build_query(['country' => 'IE', 'benchmark' => 'US', 'maturity' => '10Y']);
$ctx = stream_context_create(['http' => ['header' => "X-API-Key: YOUR_API_KEY\r\n"]]);
$res = file_get_contents("https://bonds-api.com/api/v1/spread?$q", false, $ctx);
$data = json_decode($res, true);
// $data['spread_bps'] is integer basis points
?>

JSON response

Interpretation:

  • spread_bps: spread in basis points (215 bps = 2.15%).
  • country_yield, benchmark_yield: percent yields at the same maturity.

5) Get the full Ireland yield curve: /curve

Retrieve the full set of available maturities for Ireland on the latest available date (or specify a historical date).

cURL

Python

import requests

resp = requests.get("https://bonds-api.com/api/v1/curve",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "IE"})
curve = resp.json()
curve_points = curve["curve"] # dict keyed by tenor, values in percent
inverted = curve["inverted"] # boolean
curve_date = curve["date"] # YYYY-MM-DD

JavaScript

fetch("https://bonds-api.com/api/v1/curve?country=IE", {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(j => {
console.log("Curve date:", j.date, "inverted:", j.inverted);
Object.entries(j.curve).forEach(([tenor, y]) => console.log(tenor, y));
});

PHP

<?php
$ctx = stream_context_create(['http' => ['header' => "X-API-Key: YOUR_API_KEY\r\n"]]);
$json = file_get_contents("https://bonds-api.com/api/v1/curve?country=IE", false, $ctx);
$data = json_decode($json, true);
// $data['curve'] is an associative array of tenor -> yield (percent)
?>

JSON response

Interpretation:

  • curve: tenor-to-yield map in percent.
  • inverted: true if short maturities yield more than long maturities overall.
  • date: curve date (trading day).

6) Get intraday snapshots for Ireland: /intraday

Fetch multiple yield observations within a single trading day, helpful for monitoring, alerts, and calculating realized intraday volatility.

cURL

Python

import requests

params = {"country": "IE", "maturity": "10Y", "date": "2026-11-07"}
resp = requests.get("https://bonds-api.com/api/v1/intraday",
headers={"X-API-Key": "YOUR_API_KEY"},
params=params)
intra = resp.json()
# intra["snapshots"] is a list of {"yield": percent, "fetched_at": ISO 8601 UTC}

JavaScript

const p = { country: "IE", maturity: "10Y", date: "2026-11-07" };
fetch(`https://bonds-api.com/api/v1/intraday?${new URLSearchParams(p)}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(j => {
j.snapshots.forEach(s => console.log(s.fetched_at, s.yield));
});

PHP

<?php
$q = http_build_query(['country' => 'IE', 'maturity' => '10Y', 'date' => '2026-11-07']);
$ctx = stream_context_create(['http' => ['header' => "X-API-Key: YOUR_API_KEY\r\n"]]);
$json = file_get_contents("https://bonds-api.com/api/v1/intraday?$q", false, $ctx);
$data = json_decode($json, true);
// $data['meta']['timezone'] == 'UTC'; timestamps are UTC
?>

JSON response

Interpretation:

  • snapshots: list of intraday observations; fetched_at is ISO 8601 UTC.
  • yield: percent at that instant; suitable for plotting or alerting.

7) Analyze fluctuations for Ireland: /fluctuation

Summarize the change, minimum, and maximum yield for Ireland over a period. Accepts multiple countries, but we focus on IE here.

cURL

Python

import requests

params = {
"countries": "IE",
"maturity": "10Y",
"start": "2025-11-07",
"end": "2026-11-07"
}
resp = requests.get("https://bonds-api.com/api/v1/fluctuation",
headers={"X-API-Key": "YOUR_API_KEY"},
params=params)
fl = resp.json()
# Access IE results via fl["data"]["IE"]["change"] etc.

JavaScript

const f = { countries: "IE", maturity: "10Y", start: "2025-11-07", end: "2026-11-07" };
fetch(`https://bonds-api.com/api/v1/fluctuation?${new URLSearchParams(f)}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(j => {
const ie = j.data.IE;
console.log("Change:", ie.change, "Min:", ie.min, "Max:", ie.max);
});

PHP

<?php
$q = http_build_query([
'countries' => 'IE',
'maturity' => '10Y',
'start' => '2025-11-07',
'end' => '2026-11-07'
]);
$ctx = stream_context_create(['http' => ['header' => "X-API-Key: YOUR_API_KEY\r\n"]]);
$json = file_get_contents("https://bonds-api.com/api/v1/fluctuation?$q", false, $ctx);
$data = json_decode($json, true);
// $data['data']['IE'] has start_yield, end_yield, change, min, max (percent)
?>

JSON response

Interpretation:

  • All yields and the change are in percentage points (e.g., change 0.31 means +31 bps).

Error handling and response semantics

All endpoints return JSON with success=true on success; on error, success=false and an error message. Common HTTP statuses include 401 (missing/invalid API key), 403 (quota exceeded), 404 (no data for the requested combination), 422 (invalid parameters), 429 (rate limit), and 500 (server error).

Recommended practices:

  • Validate ISO2 country codes and maturity strings before requests.
  • Retry idempotent GETs on transient 429/500 with jittered backoff.
  • Preserve the date fields when storing data to ensure time-aware caches and reproducibility.

Building an Ireland yield curve and using it in analytics

The /curve endpoint returns a complete tenor map for Ireland on a given date, which is ideal for:

  • Bootstrapping discount curves or interpolating par/spot rates.
  • Calculating curve slopes (e.g., 2s10s = 10Y - 2Y in percentage points).
  • Monitoring inversion via the inverted flag and your own slope metrics.

Alternatively, you can combine /latest for selected tenors to build partial curves for fast UI loads, and refresh the full /curve less frequently.

Business-day alignment, holidays, and caching

Daily endpoints reflect trading days; weekends and Irish holidays are absent. When aggregating or filling missing days in analytics, rely on the explicit dates in responses. For time series visualization, avoid auto-filling weekends to prevent misleading flat-lining.

Caching suggestions:

  • Intraday: cache for several minutes; invalidate on new snapshots.
  • Latest and curve: cache per date; refresh after market close or when a new date first appears.
  • Time series: cache result sets keyed by (country, maturity, start, end).

Fundamentals: what these yields represent

Sovereign bond yields are the annualized return implied by current prices on government-issued debt. Short maturities (1M–1Y) reflect policy expectations and liquidity conditions. Intermediate to long maturities (2Y–30Y) embed macro growth, inflation, and term premia. Many risk and allocation decisions hinge on 10Y yields and curve slopes (e.g., 2Y vs 10Y). All yields returned by Bonds API are expressed in percent.

Official sample

The following official sample illustrates a latest-rates request and response. Copy it verbatim for reference.

End-to-end examples and use cases

  • Financial dashboards: Poll /latest for IE 2Y and 10Y during trading hours; show daily change and a mini intraday chart via /intraday.
  • Risk and asset allocation: Use /curve to compute slope metrics (2s10s, 5s30s) and feed them into regime models; store /timeseries for historical analysis.
  • Macro research: Pull /timeseries for IE 10Y for multi-year windows and overlay with spreads from /spread versus DE or US to track convergence/divergence.
  • Portfolio analytics: At EOD, call /historical for pricing dates to ensure point-in-time valuations; summarize recent range and change using /fluctuation.

Explore tools and docs on bonds-api.com or use the developer console at Bonds API MCP.

Security, performance, and reliability tips

  • Authentication: Send your API key only in the X-API-Key header over HTTPS.
  • Timeouts: Set reasonable client timeouts (e.g., 10s) and retries on transient failures.
  • Data hygiene: Treat yields as floats in percent; convert spreads to percent by dividing bps by 100 if needed.
  • Clock and timezone: Dates are YYYY-MM-DD; timestamps, when present, are UTC. Normalize incoming timestamps to UTC in storage and visualization layers.

Quick reference: error response shape

Typical cases include 401 (Missing or invalid X-API-Key), 403 (Account quota exceeded), 404 (No data for requested country/maturity/date), 422 (Invalid parameter), 429 (Rate limit exceeded), 500 (Server error).

FAQ

What units are yields and spreads returned in?
Yields are returned in percent (e.g., 4.52 means 4.52%). Spreads from /spread are in basis points (bps), where 100 bps = 1.00%.

How should I handle weekends and holidays for Ireland?
Daily series include trading days only. Do not assume continuity across weekends or holidays; always use the explicit date field in responses to align data.

How often does the data update during the day?
/latest and /curve update on trading days with the newest available data. For within-day monitoring, use /intraday, which returns multiple UTC-timestamped snapshots for the requested date.

Can I request multiple maturities at once?
Yes. Use /latest with the maturities parameter (e.g., 2Y,10Y). For the full set of available tenors, call /curve.

What’s the best way to compute a 2s10s slope for Ireland?
Call /curve for IE, then subtract curve["2Y"] from curve["10Y"] (both in percent). Or, call /latest with maturities=2Y,10Y if you only need those two points.

Ready to integrate Ireland sovereign yields into your stack? Get your API key and start building in minutes: Register. You can also Register for Bonds API and Get started with Bonds API, then explore requests in the developer console at MCP.

Start building with bond data today

Get your API key and access sovereign bond yields across 60+ countries. 7-day free trial, no credit card required.