API to Get Greece Bond Yields

API to Get Greece Bond Yields

You need reliable, machine-readable Greece (GR) sovereign bond yields to power analytics, dashboards, and trading or risk tools. By the end of this walkthrough, you will be able to pull Greece’s latest yields, query historical dates, build time series and full yield curves, compute spreads versus benchmarks, and retrieve intraday snapshots using Bonds API over simple GET requests.

What you get with the Bonds API for Greece

The Bonds API provides sovereign bond yields as clean JSON over HTTPS for 60+ countries, including Greece (ISO2 code: GR). You can query by maturity (from short bills like 1M through long bonds like 30Y and beyond where available), fetch a complete Greece yield curve, and compute spreads to benchmarks such as US Treasuries or German Bunds.

Illustration: API to Get Greece Bond Yields

For development, all requests are GET and authenticated using an X-API-Key header. Base URL for every endpoint is https://bonds-api.com/api/v1/. To test and explore, visit bonds-api.com and the in-browser console at MCP.

Conventions, units, and practical details

  • Authentication: pass your key via the X-API-Key header (example: X-API-Key: YOUR_API_KEY). Do not send it as a query parameter.
  • Yields: all “yield” fields are expressed in percentage terms (e.g., 4.52 means 4.52%). Spreads are returned in basis points (bps), where 1 bps = 0.01%.
  • Dates and timestamps: date is formatted as YYYY-MM-DD. Intraday timestamps use UTC ISO-8601 (e.g., 2026-11-14T12:00:00Z) and meta.timezone clarifies UTC when present.
  • Business days and holidays: daily endpoints return values for market business days; weekends and local holidays will have no new “date” records. Time series will reflect only available trading days in the requested range.
  • Update frequency: latest and curve endpoints reflect the most recently available official market close; intraday snapshots provide multiple updates throughout the trading day with UTC timestamps.
  • Caching: cache stable daily data (latest, historical, curve) until the next trading day; refresh intraday snapshots more frequently based on your UI needs. Respect 429 rate limit responses by backing off and retrying.
  • Errors: the API returns success=false with an error message for issues such as missing/invalid keys (401), invalid parameters (422), not found (404), or quota/rate-limit problems (403/429). Handle these explicitly in client code.

If you need an API key, you can Register and start building. You can also explore endpoints at bonds-api.com.

Latest Greece Yields: GET /latest

Use this endpoint to fetch the most recent available yields for Greece across one or more maturities. Omit maturities to retrieve all available points.

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": "GR", "maturities": "2Y,10Y"}
)
data = resp.json()
print(data)

JavaScript (fetch)

const url = new URL("https://bonds-api.com/api/v1/latest");
url.searchParams.set("countries", "GR");
url.searchParams.set("maturities", "2Y,10Y");

fetch(url.toString(), {
method: "GET",
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(json => console.log(json))
.catch(console.error);

PHP (file_get_contents)

<?php
$url = "https://bonds-api.com/api/v1/latest?countries=GR&maturities=2Y,10Y";
$opts = [
"http" => [
"method" => "GET",
"header" => "X-API-Key: YOUR_API_KEY\r\n"
]
];
$ctx = stream_context_create($opts);
$json = file_get_contents($url, false, $ctx);
echo $json;
?

Sample JSON response

{
    "success": true,
    "date": "2026-11-13",
    "rates": {
        "US_10Y": 5.15
    },
    "dates": {
        "US_10Y": "2026-11-13"
    },
    "currencies": {
        "US_10Y": "USD"
    },
    "meta": {
        "request_id": "488cbdc8-5735-48fc-8033-0cf7ab928ae5",
        "timestamp": "2026-11-14T00:05:49+00:00"
    }
}

How to read: yields are percentages; date is the effective market date for the yield; source indicates the data origin (e.g., “official”).

Yield on a Specific Date: GET /historical

Retrieve the Greece yield for a given maturity on a specific calendar date (usually a business day). If the date is a non-trading day, expect a 404 error rather than a backfilled value.

cURL

Python

import requests

params = {"country": "GR", "maturity": "10Y", "date": "2025-06-15"}
r = requests.get("https://bonds-api.com/api/v1/historical",
headers={"X-API-Key": "YOUR_API_KEY"},
params=params)
print(r.json())

JavaScript

const url = new URL("https://bonds-api.com/api/v1/historical");
url.searchParams.set("country", "GR");
url.searchParams.set("maturity", "10Y");
url.searchParams.set("date", "2025-06-15");

fetch(url, { headers: { "X-API-Key": "YOUR_API_KEY" } })
.then(r => r.json())
.then(console.log)
.catch(console.error);

PHP

<?php
$url = "https://bonds-api.com/api/v1/historical?country=GR&maturity=10Y&date=2025-06-15";
$opts = ["http" => ["method" => "GET", "header" => "X-API-Key: YOUR_API_KEY\r\n"]];
$ctx = stream_context_create($opts);
echo file_get_contents($url, false, $ctx);
?

Sample JSON response

How to read: yield is a percentage on that precise date; if the date is not available for Greece 10Y, you will receive a structured error.

Time Series Between Two Dates: GET /timeseries

Build historical studies or charts with a continuous series of Greece yields across a date range. Only trading days will appear in the series.

cURL

Python

import requests

params = {
"country": "GR",
"maturity": "10Y",
"start": "2025-11-14",
"end": "2026-11-14"
}
resp = requests.get("https://bonds-api.com/api/v1/timeseries",
headers={"X-API-Key": "YOUR_API_KEY"},
params=params)
print(resp.json())

JavaScript

const url = new URL("https://bonds-api.com/api/v1/timeseries");
url.searchParams.set("country", "GR");
url.searchParams.set("maturity", "10Y");
url.searchParams.set("start", "2025-11-14");
url.searchParams.set("end", "2026-11-14");

fetch(url, { headers: { "X-API-Key": "YOUR_API_KEY" } })
.then(r => r.json())
.then(json => {
// iterate over json.series for {date, yield}
console.log(json.series);
});

PHP

<?php
$q = http_build_query([
"country" => "GR",
"maturity" => "10Y",
"start" => "2025-11-14",
"end" => "2026-11-14"
]);
$url = "https://bonds-api.com/api/v1/timeseries?$q";
$opts = ["http" => ["method" => "GET", "header" => "X-API-Key: YOUR_API_KEY\r\n"]];
$ctx = stream_context_create($opts);
echo file_get_contents($url, false, $ctx);
?

Sample JSON response

How to read: series is an array of date/yield pairs in percent. Use these directly for charting or for computing durations, carry/roll analyses, or realized volatility.

Full Greece Yield Curve: GET /curve

Fetch an entire curve snapshot for Greece as of the latest available date or a specified date. This is ideal for pricing, interpolation, and curve shape analysis.

cURL

Python

import requests

resp = requests.get(
"https://bonds-api.com/api/v1/curve",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "GR"}
)
curve = resp.json()
print(curve)

JavaScript

const url = new URL("https://bonds-api.com/api/v1/curve");
url.searchParams.set("country", "GR");

fetch(url, { headers: { "X-API-Key": "YOUR_API_KEY" } })
.then(r => r.json())
.then(json => {
// json.curve is a map of maturity to yield percentage
console.log(json.curve);
});

PHP

<?php
$url = "https://bonds-api.com/api/v1/curve?country=GR";
$opts = ["http" => ["method" => "GET", "header" => "X-API-Key: YOUR_API_KEY\r\n"]];
$ctx = stream_context_create($opts);
echo file_get_contents($url, false, $ctx);
?

Sample JSON response

How to read: curve contains key/value pairs of maturity to yield (percent). The inverted boolean indicates whether the curve is generally downward-sloping from short to long maturities (true) or not (false).

Intraday Greece Yields: GET /intraday

Retrieve multiple yield snapshots within a single day for a specific Greece maturity. Use this to observe market moves in real time or for intraday risk signals.

cURL

Python

import requests

params = {"country": "GR", "maturity": "10Y", "date": "2026-11-14"}
resp = requests.get("https://bonds-api.com/api/v1/intraday",
headers={"X-API-Key": "YOUR_API_KEY"},
params=params)
print(resp.json())

JavaScript

const url = new URL("https://bonds-api.com/api/v1/intraday");
url.searchParams.set("country", "GR");
url.searchParams.set("maturity", "10Y");
url.searchParams.set("date", "2026-11-14");

fetch(url, { headers: { "X-API-Key": "YOUR_API_KEY" } })
.then(r => r.json())
.then(json => {
// json.snapshots is an array of {yield, fetched_at, source}
console.log(json.snapshots);
});

PHP

<?php
$url = "https://bonds-api.com/api/v1/intraday?country=GR&maturity=10Y&date=2026-11-14";
$opts = ["http" => ["method" => "GET", "header" => "X-API-Key: YOUR_API_KEY\r\n"]];
$ctx = stream_context_create($opts);
echo file_get_contents($url, false, $ctx);
?

Sample JSON response

How to read: snapshots is a list of intraday observations with UTC timestamps. count indicates the number of snapshots; meta.timezone clarifies temporal context for plotting.

Spreads vs Benchmarks: GET /spread

Compute the Greece spread versus a benchmark (e.g., US Treasuries with ISO2=US or German Bunds with ISO2=DE) at a specified maturity, defaulting to 10Y if omitted.

cURL

Python

import requests

params = {"country": "GR", "benchmark": "US", "maturity": "10Y"}
resp = requests.get("https://bonds-api.com/api/v1/spread",
headers={"X-API-Key": "YOUR_API_KEY"},
params=params)
print(resp.json())

JavaScript

const url = new URL("https://bonds-api.com/api/v1/spread");
url.searchParams.set("country", "GR");
url.searchParams.set("benchmark", "US");
url.searchParams.set("maturity", "10Y");

fetch(url, { headers: { "X-API-Key": "YOUR_API_KEY" } })
.then(r => r.json())
.then(console.log);

PHP

<?php
$url = "https://bonds-api.com/api/v1/spread?country=GR&benchmark=US&maturity=10Y";
$opts = ["http" => ["method" => "GET", "header" => "X-API-Key: YOUR_API_KEY\r\n"]];
$ctx = stream_context_create($opts);
echo file_get_contents($url, false, $ctx);
?

Sample JSON response

How to read: spread_bps is in basis points (e.g., 215 bps = 2.15%). The country_yield and benchmark_yield are in percent.

Change and Extremes Over a Period: GET /fluctuation

Summarize the change in Greece yields over a period and capture the minimum and maximum yields observed. Useful for risk reports and scenario summaries.

cURL

Python

import requests

params = {
"countries": "GR",
"maturity": "10Y",
"start": "2025-11-14",
"end": "2026-11-14"
}
r = requests.get("https://bonds-api.com/api/v1/fluctuation",
headers={"X-API-Key": "YOUR_API_KEY"},
params=params)
print(r.json())

JavaScript

const url = new URL("https://bonds-api.com/api/v1/fluctuation");
url.searchParams.set("countries", "GR");
url.searchParams.set("maturity", "10Y");
url.searchParams.set("start", "2025-11-14");
url.searchParams.set("end", "2026-11-14");

fetch(url, { headers: { "X-API-Key": "YOUR_API_KEY" } })
.then(r => r.json())
.then(console.log);

PHP

<?php
$params = http_build_query([
"countries" => "GR",
"maturity" => "10Y",
"start" => "2025-11-14",
"end" => "2026-11-14"
]);
$url = "https://bonds-api.com/api/v1/fluctuation?$params";
$opts = ["http" => ["method" => "GET", "header" => "X-API-Key: YOUR_API_KEY\r\n"]];
$ctx = stream_context_create($opts);
echo file_get_contents($url, false, $ctx);
?

Sample JSON response

How to read: change is in percentage points between the start and end yields (e.g., 0.31 = +31 bps). min and max represent the extremes during the interval.

Building a Greece yield curve and spreads dashboard

Combine /latest across several maturities to render a compact snapshot. The /curve endpoint can return the full Greece curve in one call, which often simplifies UI layering and interpolation. If you need to chart historical curves, use /curve with explicit date parameters over a set of dates and cache those responses to speed up backtesting and page loads.

For time-based analytics (momentum, realized volatility, mean-reversion screens), use /timeseries for the target maturity. Pair it with /fluctuation to quickly pre-screen periods with large changes before pulling full series for deeper study.

Spreads are central to cross-market analysis. With /spread, you can compute the Greece 10Y spread versus US or DE in basis points, enabling relative-value heatmaps and alerting. Consider caching spreads for end-of-day reports while refreshing intraday spreads more frequently during local trading hours.

Intraday monitoring benefits from /intraday snapshots with UTC timestamps; align your display time zone in the frontend and annotate market open/close markers for the Athens session if relevant to your users.

When dealing with non-trading days and holidays, handle missing data gracefully. For example, your trendlines may interpolate visually, but your analytics should avoid fabricating values. The API responds only with actual available dates, which you can treat as the authoritative trading calendar for Greece in your system.

To iterate faster, explore endpoints with MCP and review payloads directly. When ready, retrieve your key and integrate securely using the X-API-Key header. You can also consult bonds-api.com for general documentation.

Official sample (verbatim)

The following request and JSON are provided verbatim from an official sample block. They illustrate a latest-yield call for a US maturity with fields tailored to that example.

How to read: rates are in percent; date and dates fields indicate the reference date; timestamp is UTC.

Sovereign bond fundamentals for Greece-focused workflows

Sovereign bond yields reflect the curve of interest rates at which the Hellenic Republic borrows in euros across maturities. Short-dated bills (1M–6M) often react to policy expectations and liquidity conditions, while mid-to-long maturities (5Y–30Y) express term premia, growth/inflation expectations, and risk sentiment.

For Greece, common analytics include:

  • Curve shape: via /curve or /latest across key points (2Y, 5Y, 10Y, 30Y); check “inverted” for a quick regime read.
  • Relative value: use /spread versus DE or US to monitor cross-market dislocations or hedging efficiency.
  • Risk summaries: use /fluctuation to report end-to-end changes and extremes over your portfolio’s risk horizon.
  • Trading signals: combine /intraday snapshots with thresholds to trigger alerts when Greece 10Y moves by N bps within a session.
  • Backtests: rely on /timeseries for clean historical data aligned to trading days.

To begin integrating, get your API key here: Register. Then plug it into the X-API-Key header as shown above.

Error handling and reliability patterns

Implement structured error handling around the common error responses. For example, a 422 indicates a parameter issue such as an invalid date format (use YYYY-MM-DD) or an unknown ISO2 code; a 404 signals that no data exists for the requested combination (e.g., non-trading date). Log 401/403/429 events distinctly and retry with exponential backoff only where appropriate (never hammer the endpoint).

For production dashboards, consider:

  • Local caches keyed by country+maturity+date to reduce duplicate traffic.
  • Batch retrieval using /latest with multiple maturities, or /curve where you need the whole term structure in a single call.
  • Separating end-of-day flows (daily refresh) from intraday flows (minute-to-hour refresh depending on user needs).

FAQ

Q: What units are the yields and spreads in?
A: Yields are percentages (e.g., 4.52 means 4.52%). Spreads are basis points (bps), where 100 bps = 1.00%.

Q: Which time zone applies to timestamps?
A: Dates are YYYY-MM-DD without time; intraday timestamps are UTC ISO-8601. The intraday payload also includes meta.timezone for clarity.

Q: How do I build a Greece yield curve efficiently?
A: Use GET /curve with country=GR to get all available maturities in one response. For custom grids, GET /latest with maturities=1Y,2Y,5Y,10Y,30Y is also effective.

Q: How should I handle non-trading days?
A: Expect no new data for weekends and Greece market holidays. Time series include only trading dates. If you request a non-trading date via /historical, handle a 404 gracefully.

Q: Can I compare Greece to other markets?
A: Yes. Use GET /spread with country=GR and benchmark=US or DE to retrieve a spread in bps at the specified maturity (10Y if omitted).

Ready to integrate Greece bond yields into your tooling? Use the X-API-Key header and the endpoints above to ship your first workflow. If you do not have a key, you can Get started with Bonds API. Explore interactively at bonds-api.com and test live calls in the 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.