API to Get Austria Bond Yields

API to Get Austria Bond Yields

Developers and analysts often need Austria’s sovereign bond yields—latest levels, history, intraday snapshots, yield curves, and cross-country spreads—inside their own dashboards, risk engines, and research notebooks. By the end of this guide, you will know exactly how to query Austria (AT) bond yields from Bonds API, interpret the responses, handle business days and market holidays, and assemble a full Austria yield curve programmatically.

What you get with Bonds API for Austria

Bonds API delivers sovereign bond yields as clean JSON over a REST interface secured by an API key. For Austria (ISO2: AT), you can retrieve:

Illustration: API to Get Austria Bond Yields
  • Current yields for individual maturities (e.g., 2Y, 10Y).
  • End-of-day historical yields for specific dates.
  • Time series across arbitrary start and end dates.
  • Full yield curves spanning bills to long bonds.
  • Intraday snapshots with timestamps.
  • Period fluctuations (change, min, max).
  • Spreads to benchmarks (e.g., vs German Bund or US Treasury).

All endpoints are HTTP GET and reside at the same base URL: https://bonds-api.com/api/v1/. Authenticate with the X-API-Key header. Yields are expressed as percentages unless specified otherwise (spreads are in basis points). Dates are YYYY-MM-DD. Intraday timestamps are ISO 8601 in UTC.

If you want to test calls interactively, visit the MCP. To obtain an API key, use this call to action: Register.

Quick note: official live sample snapshot

The following live sample snapshot is provided for reference and should be copied exactly as-is. It demonstrates a latest-yield request and response shape. Your production integrations for Austria should continue to use the endpoints and the X-API-Key header shown in the rest of this article.

curl -s "https://bonds-api.com/api/v1/latest?countries=US&maturities=10Y&api_key=YOUR_API_KEY"
{
    "success": true,
    "date": "2026-11-13",
    "rates": {
        "US_10Y": 5.129
    },
    "dates": {
        "US_10Y": "2026-11-13"
    },
    "currencies": {
        "US_10Y": "USD"
    },
    "meta": {
        "request_id": "3db58836-3733-4ea1-a172-63d39cabcc49",
        "timestamp": "2026-11-13T00:06:57+00:00"
    }
}

Austria maturities, business days, updates, and caching

Bonds API covers a broad set of Austria maturities, from short-term bills to long-dated bonds. Not every maturity is available on every date, but typical curve points include 1M, 3M, 6M, 1Y, 2Y, 5Y, 10Y, and 30Y. You can always query the full Austria curve to see what’s available on a given day.

Official end-of-day values reflect business days and exclude weekends and Austrian market holidays. Expect gaps on non-trading days. Intraday snapshots are timestamped in UTC and only appear on active days during market hours. For caching:

  • Latest endpoint: cache for a few minutes if you don’t require second-by-second updates.
  • Historical, time series, curve: results are stable per date; cache for hours or days.
  • Intraday: use shorter caches (tens of seconds to a couple of minutes) during market hours.

For robust analytics, always read the date fields. When building daily time series, forward-fill only if your analytics demand it, and never assume weekends/holidays will have values.

Endpoint 1: Get current Austria yields

Use GET /latest to fetch the most recent available yield for one or more Austria maturities. Yields are in percent. The response contains per-maturity objects with yield, date, and source.

cURL

Python (requests)

import requests

resp = requests.get(
"https://bonds-api.com/api/v1/latest",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"countries": "AT", "maturities": "2Y,10Y"}
)
data = resp.json()
# Access Austria 2Y, 10Y as percentages
two_y = data["data"]["AT"]["2Y"]["yield"]
ten_y = data["data"]["AT"]["10Y"]["yield"]
as_of_2y = data["data"]["AT"]["2Y"]["date"] # "YYYY-MM-DD"

JavaScript (fetch)

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

fetch(url.toString(), {
method: "GET",
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(json => {
const twoY = json.data.AT["2Y"].yield; // percent
const tenY = json.data.AT["10Y"].yield; // percent
const d = json.data.AT["10Y"].date; // YYYY-MM-DD
console.log({ twoY, tenY, d });
});

PHP (file_get_contents)

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

Sample JSON

Interpretation: yields are percentages; date is YYYY-MM-DD (as-of date for the yield). The source indicates provenance (e.g., “official”).

Endpoint 2: Historical Austria yield on a specific date

Fetch the end-of-day Austria yield for a given maturity and date using GET /historical. Date is required (YYYY-MM-DD). Yield is in percent.

cURL

Python (requests)

import requests

params = {"country": "AT", "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)
j = r.json()
y = j["yield"] # percent
asof = j["date"] # "YYYY-MM-DD"
src = j["source"] # e.g. "official"

JavaScript (fetch)

const params = new URLSearchParams({ country: "AT", maturity: "10Y", date: "2025-06-15" });
fetch(`https://bonds-api.com/api/v1/historical?${params.toString()}`, {
method: "GET",
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(json => {
console.log("AT 10Y on", json.date, "=", json.yield, "%");
});

PHP (file_get_contents)

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

Sample JSON

Interpretation: yield is percent; date is end-of-day as-of date; the maturity code indicates the tenor.

Endpoint 3: Austria yield time series

Use GET /timeseries for a continuous daily series over a date range. The series array contains one object per business day (no weekends/holiday entries). Values are percentages.

cURL

Python (requests)

import requests

p = {"country": "AT", "maturity": "10Y", "start": "2025-11-13", "end": "2026-11-13"}
res = requests.get("https://bonds-api.com/api/v1/timeseries",
headers={"X-API-Key": "YOUR_API_KEY"},
params=p)
ts = res.json()["series"] # list of {"date": "YYYY-MM-DD", "yield": float}
# Example: build (date, yield) tuples
pairs = [(row["date"], row["yield"]) for row in ts]

JavaScript (fetch)

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

PHP (file_get_contents)

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

Sample JSON

Interpretation: the series is an array of daily end-of-day points (business days only). Yield is percent; date is YYYY-MM-DD.

Endpoint 4: Spread vs benchmark (basis points)

Use GET /spread to compute Austria’s spread relative to a benchmark country at a given maturity (default: 10Y). The spread is in basis points (bps). The response also includes the underlying country and benchmark yields (percent).

cURL

Python (requests)

import requests

p = {"country": "AT", "benchmark": "US", "maturity": "10Y"}
r = requests.get("https://bonds-api.com/api/v1/spread",
headers={"X-API-Key": "YOUR_API_KEY"},
params=p)
j = r.json()
bps = j["spread_bps"] # integer/float, basis points
at_y = j["country_yield"] # percent
bm_y = j["benchmark_yield"] # percent

JavaScript (fetch)

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

PHP (file_get_contents)

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

Sample JSON

Interpretation: spread_bps is the difference in basis points (1 bps = 0.01%). A spread of 215 bps means 2.15 percentage points.

Endpoint 5: Full Austria yield curve

Use GET /curve to retrieve Austria’s curve for a single day. The response provides a map of maturity to yield (percent) and a boolean flag indicating whether the curve is inverted (short rates above long rates).

cURL

Python (requests)

import requests

r = requests.get("https://bonds-api.com/api/v1/curve",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "AT"})
j = r.json()
curve = j["curve"] # dict: {"1M": float, ..., "30Y": float}
is_inverted = j["inverted"]
curve_date = j["date"] # "YYYY-MM-DD"

JavaScript (fetch)

const paramsCurve = new URLSearchParams({ country: "AT" });
fetch(`https://bonds-api.com/api/v1/curve?${paramsCurve.toString()}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(({ curve, date, inverted }) => {
console.log("Curve date:", date, "Inverted:", inverted, "Points:", curve);
});

PHP (file_get_contents)

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

Sample JSON

Interpretation: yields are percents for each maturity bucket. The inverted flag summarizes the curve’s slope at a glance. The date field tells you the as-of day for the entire curve.

Endpoint 6: Intraday Austria snapshots (UTC timestamps)

Use GET /intraday to retrieve multiple yield snapshots for a maturity on a given date. Each snapshot includes a yield percent, a fetched_at ISO 8601 timestamp (UTC), and a source. This endpoint is ideal for tracking live moves over the session.

cURL

Python (requests)

import requests

params = {"country": "AT", "maturity": "10Y", "date": "2026-11-13"}
res = requests.get("https://bonds-api.com/api/v1/intraday",
headers={"X-API-Key": "YOUR_API_KEY"},
params=params)
j = res.json()
snaps = j["snapshots"] # list of {"yield": float, "fetched_at": ISO8601 UTC, "source": str}
count = j["count"]
tz = j["meta"]["timezone"]

JavaScript (fetch)

const q = new URLSearchParams({ country: "AT", maturity: "10Y", date: "2026-11-13" });
fetch(`https://bonds-api.com/api/v1/intraday?${q.toString()}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(({ snapshots, meta }) => {
snapshots.forEach(pt => console.log(pt.fetched_at, pt.yield));
console.log("Timezone:", meta.timezone); // "UTC"
});

PHP (file_get_contents)

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

Sample JSON

Interpretation: yields are percents; fetched_at is in UTC (Z suffix). Intraday frequency and count vary by market activity.

Endpoint 7: Period fluctuations (change, min, max)

Use GET /fluctuation to summarize the change between start and end dates, and the min/max over the period, for selected countries and one maturity. Yields are percents; change is in percentage points (not bps).

cURL

Python (requests)

import requests

p = {"countries": "AT", "maturity": "10Y", "start": "2025-11-13", "end": "2026-11-13"}
res = requests.get("https://bonds-api.com/api/v1/fluctuation",
headers={"X-API-Key": "YOUR_API_KEY"},
params=p)
j = res.json()
at = j["data"]["AT"]
delta = at["change"] # percentage points
min_y = at["min"] # percent
max_y = at["max"] # percent

JavaScript (fetch)

const qf = new URLSearchParams({
countries: "AT", maturity: "10Y", start: "2025-11-13", end: "2026-11-13"
});
fetch(`https://bonds-api.com/api/v1/fluctuation?${qf.toString()}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(({ data }) => {
const at = data.AT;
console.log(`Δ=${at.change}pp, min=${at.min}%, max=${at.max}%, end=${at.end_yield}%`);
});

PHP (file_get_contents)

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

Sample JSON

Interpretation: change is end_yield - start_yield in percentage points. Min and max are the observed extremes over the requested period.

Austria fundamentals and how to use these endpoints

A sovereign bond yield is the annualized rate the government must pay to borrow at a specific maturity. Short maturities are sensitive to policy rate expectations; longer maturities reflect growth, inflation, and term premia. Common analytics you can implement with the endpoints above:

  • Yield curve construction and interpolation using GET /curve (or GET /latest across multiple maturities).
  • Spread monitoring vs German Bunds or US Treasuries via GET /spread (in bps).
  • Risk factor backtests using GET /timeseries for Austria 2Y, 5Y, 10Y.
  • Intraday volatility and event tracking via GET /intraday.
  • Performance summaries using GET /fluctuation to retrieve change, min, max over windows.

For interactive exploration, the MCP is helpful. For production keys, visit Register. You can also browse bonds-api.com for product-wide details.

Building an Austria yield curve from multiple symbols

You can obtain a full curve in one shot using GET /curve. Alternatively, you can request several maturities via GET /latest by specifying a comma-separated list (e.g., 1Y,2Y,5Y,10Y,30Y). When aggregating:

  • Ensure all maturities share the same date stamp if you need a coherent end-of-day curve.
  • For interpolation, use standardized maturity labels (1M, 3M, 6M, 1Y, 2Y, 5Y, 10Y, 30Y) from the curve endpoint.
  • If a maturity is missing for a date, decide whether to interpolate or omit it based on your analytics.

Handling non-trading days, holidays, and missing data

Expect no end-of-day values on weekends and Austrian public holidays. Time series return only business-day entries. If your application requires continuous daily indices, apply forward-filling with caution and clearly label synthetic values. For intraday, snapshots appear only when the market is active; absence of snapshots indicates inactivity or a non-trading day.

Update frequency and time zones

End-of-day values are published after the market close for the relevant day. Intraday snapshots are timestamped in UTC and may appear multiple times during the session. The API’s date fields use YYYY-MM-DD, and the intraday fetched_at is ISO 8601 with Z (Zulu) for UTC. If you localize times for users, convert from UTC after parsing.

Error handling and resilience

Use HTTP status and the error payload to decide your retry and fallback strategy:

  • 401 (Missing or invalid X-API-Key): Verify header is present and your key is valid.
  • 403 (Quota exceeded): Back off and monitor your usage. Consider reducing request frequency.
  • 404 (No data): Check country/maturity/date combination; consider querying a neighboring business day.
  • 422 (Invalid parameter): Validate ISO codes and date formats (YYYY-MM-DD).
  • 429 (Rate limit): Implement exponential backoff and caching to reduce calls.
  • 500 (Server error): Retry with jitter; keep a local cache for continuity.

Real-world use cases for Austria bond yields

  • Financial dashboards: Display AT 2Y, 5Y, 10Y tiles from GET /latest; add a sparkline from GET /timeseries.
  • Portfolio risk tools: Calculate DV01 exposures; update scenario shocks using curve shifts from GET /curve.
  • Macro research: Compare AT 10Y vs DE 10Y using GET /spread; track regime shifts with GET /fluctuation.
  • Event monitoring: Plot GET /intraday snapshots around ECB decisions to observe immediate market reactions.

Verification checklist before going live

  • Authentication header: X-API-Key set for every request.
  • Date parsing: YYYY-MM-DD for daily; ISO 8601 UTC for intraday.
  • Units: yields in percent; spread_bps in basis points; change in percentage points.
  • Holidays/weekends: handle gaps in time series; do not expect daily continuity.
  • Caching: use appropriate TTLs for latest (short), intraday (very short), historical/curve (longer).
  • Error handling: implement retries/backoff for 429/500 and graceful fallbacks for 404.

Reference: Endpoint shapes and key fields

  • /latest: per-maturity objects with yield (percent), date (YYYY-MM-DD), source.
  • /historical: single yield (percent) for a maturity and date; includes source.
  • /timeseries: array of { date, yield } over business days only.
  • /curve: map of maturity labels to yields (percent) plus inverted flag and curve date.
  • /intraday: list of snapshots with yield (percent), fetched_at (UTC), and count.
  • /fluctuation: start_yield, end_yield, change (pp), min, max over the period.
  • /spread: spread_bps (bps), country_yield (percent), benchmark_yield (percent).

FAQ

Q: Are Austria yields returned as decimals or percents?
A: Percents (e.g., 4.52 means 4.52%). Spreads from /spread are in basis points (e.g., 215 means 2.15%).

Q: What timezone are timestamps in?
A: Daily dates are YYYY-MM-DD (no timezone). Intraday fetched_at is ISO 8601 in UTC (Z).

Q: How do I get a complete Austria curve for a given day?
A: Use GET /curve with country=AT. It returns maturity buckets mapped to yields and an inverted flag for the curve.

Q: How should I handle missing days in a time series?
A: The API returns business days. For analytics that require daily continuity, forward-fill carefully and label imputed values.

Q: Can I compare Austria to multiple benchmarks at once?
A: Call GET /spread separately per benchmark (e.g., benchmark=DE, benchmark=US) and join results in your app.

Ready to integrate Austria bond yields into your stack? Visit Register to get your API key and explore interactively in the MCP. You can also learn more at bonds-api.com.

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.