You need programmatic access to Norway’s sovereign bond yields to power dashboards, backtests, and risk models. By the end of this guide you will query current and historical Norwegian government bond yields, assemble a Norway yield curve, monitor intraday snapshots, compute spreads vs. benchmarks, and manage caching and market calendar nuances using the Bonds API.
What you get from the Norway sovereign bond endpoints
Bonds API provides Norwegian government bond yields (ISO2: NO) across common bill and bond maturities as JSON over HTTPS. Yields are expressed in percentage points (e.g., 4.52 means 4.52%). Date fields use ISO 8601 (Y-m-d). Intraday timestamps are in UTC with a Z suffix.
Typical maturities available include money-market tenors (1M, 3M, 6M), near-curve points (1Y, 2Y), and benchmark bonds out to 30Y, with coverage expanding up to 50Y where available. You can retrieve:
- Current levels by country and maturities
- Historical yields on a given business date
- Daily time series between two dates
- Intraday snapshots for a specific maturity
- Spreads vs. benchmarks (e.g., US Treasuries)
- The full Norway yield curve on the latest available day (or a requested date)
- Fluctuation stats (change, min, max) over a period
All endpoints use GET against https://bonds-api.com/api/v1/ and require the X-API-Key header. To explore the full reference and coverage, visit the homepage at bonds-api.com or use the developer console at MCP.
Quick note on an official sample
The following official sample must appear verbatim (it uses a US symbol and api_key query param). You can copy it as-is to verify connectivity. Production usage for Norway should use the X-API-Key header as shown elsewhere in this article.
curl -s "https://bonds-api.com/api/v1/latest?countries=US&maturities=10Y&api_key=YOUR_API_KEY"
{
"success": true,
"date": "2026-10-28",
"rates": {
"US_10Y": 4.994
},
"dates": {
"US_10Y": "2026-10-28"
},
"currencies": {
"US_10Y": "USD"
},
"meta": {
"request_id": "1c8f7571-c92c-4992-b3aa-a4cc6d8efabf",
"timestamp": "2026-10-28T00:06:20+00:00"
}
}
Norway fundamentals and how to read the fields
Norwegian sovereign bonds are issued by the Kingdom of Norway. Yields reflect market expectations for Norges Bank policy, inflation, growth, and risk premia. In Bonds API responses:
- yield: a numeric percentage value, e.g., 4.52 represents 4.52%.
- date: a calendar date (Y-m-d). For latest endpoints, this is the effective business date.
- source: a provenance tag like "official" or "market".
- spread_bps: basis points relative to the benchmark (1 basis point = 0.01%).
- fetched_at: an ISO-8601 UTC timestamp for intraday snapshots (e.g., 2026-10-28T12:00:00Z).
- inverted: boolean indicating if the curve slopes down from short to long maturities.
Business days follow the Oslo market calendar. On Norwegian market holidays and weekends, latest data will resolve to the most recent trading day. For time series, only business days with available data are returned. Consider caching daily results per country and maturity to reduce latency and rate usage, and always store the response date to align analytics on a consistent as-of date.
Get current Norway yields for selected maturities
Use the latest endpoint to pull NO yields by maturity. If you omit maturities, you’ll receive all available Norwegian tenors for the latest market date.
Endpoint
GET /api/v1/latest
Example cURL
Example JSON response
Interpretation:
- Yields are percentages (e.g., 4.25 means 4.25%).
- date is the effective business date for each maturity.
- source indicates whether the figure is from an official publish or market aggregation.
Python
import requests
resp = requests.get(
"https://bonds-api.com/api/v1/latest",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"countries": "NO", "maturities": "2Y,10Y"}
)
data = resp.json()
no_2y = data["data"]["NO"]["2Y"]["yield"]
no_10y = data["data"]["NO"]["10Y"]["yield"]
asof = data["data"]["NO"]["10Y"]["date"]
print("NO 2Y:", no_2y, "NO 10Y:", no_10y, "as of", asof)
JavaScript (fetch)
async function getLatestNO() {
const url = new URL("https://bonds-api.com/api/v1/latest");
url.searchParams.set("countries", "NO");
url.searchParams.set("maturities", "2Y,10Y");
const resp = await fetch(url.toString(), {
method: "GET",
headers: { "X-API-Key": "YOUR_API_KEY" }
});
const json = await resp.json();
const twoY = json.data.NO["2Y"].yield;
const tenY = json.data.NO["10Y"].yield;
console.log({ twoY, tenY });
}
getLatestNO();
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=NO&maturities=2Y,10Y";
$json = file_get_contents($url, false, $context);
$data = json_decode($json, true);
echo "NO 10Y: " . $data["data"]["NO"]["10Y"]["yield"] . "%\n";
Get a Norway yield on a specific date
Use the historical endpoint when you need an as-of yield for a precise date (e.g., portfolio valuation snapshots or backtesting). If the date is a non-trading day, the API returns a 404; adjust to the nearest prior business day in your application logic or query strategy.
Endpoint
GET /api/v1/historical
Example cURL
Example JSON response
Interpretation:
- yield is a percentage value for NO 10Y on 2025-06-15.
- source indicates provenance; store it if you audit inputs.
Python
import requests
params = {"country": "NO", "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)
hist = r.json()
print(hist["maturity"], hist["yield"], "as of", hist["date"])
JavaScript
async function getNOHistorical() {
const url = new URL("https://bonds-api.com/api/v1/historical");
url.searchParams.set("country", "NO");
url.searchParams.set("maturity", "10Y");
url.searchParams.set("date", "2025-06-15");
const resp = await fetch(url.toString(), {
headers: { "X-API-Key": "YOUR_API_KEY" }
});
const json = await resp.json();
console.log(json);
}
getNOHistorical();
PHP
<?php
$query = http_build_query([
"country" => "NO",
"maturity" => "10Y",
"date" => "2025-06-15"
]);
$opts = ["http" => ["method" => "GET", "header" => "X-API-Key: YOUR_API_KEY\r\n"]];
$ctx = stream_context_create($opts);
$json = file_get_contents("https://bonds-api.com/api/v1/historical?$query", false, $ctx);
echo $json;
Get a Norway time series between two dates
For backtests, regressions, or volatility estimates, request a daily series over a period. Only business dates with available data are returned.
Endpoint
GET /api/v1/timeseries
Example cURL
Example JSON response
Interpretation:
- series is an array of daily observations with date (Y-m-d) and yield (%).
- Use the series to compute rolling changes, duration hedges, and vol estimates.
Python
import requests
params = {"country": "NO", "maturity": "10Y", "start": "2025-10-28", "end": "2026-10-28"}
r = requests.get("https://bonds-api.com/api/v1/timeseries",
headers={"X-API-Key": "YOUR_API_KEY"}, params=params)
ts = r.json()["series"]
daily_moves = [ts[i]["yield"] - ts[i-1]["yield"] for i in range(1, len(ts))]
print("Obs:", len(ts), "First delta:", daily_moves[0] if daily_moves else None)
JavaScript
async function getNOTimeSeries() {
const url = new URL("https://bonds-api.com/api/v1/timeseries");
url.searchParams.set("country", "NO");
url.searchParams.set("maturity", "10Y");
url.searchParams.set("start", "2025-10-28");
url.searchParams.set("end", "2026-10-28");
const resp = await fetch(url.toString(), { headers: { "X-API-Key": "YOUR_API_KEY" }});
const json = await resp.json();
console.log("First 3 points:", json.series.slice(0, 3));
}
getNOTimeSeries();
PHP
<?php
$params = http_build_query([
"country" => "NO", "maturity" => "10Y",
"start" => "2025-10-28", "end" => "2026-10-28"
]);
$ctx = 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/timeseries?$params", false, $ctx);
print($json);
Compute Norway spreads vs. a benchmark
Spreads are essential for relative value and cross-market analysis. This endpoint returns the spread in basis points and both leg yields for transparency. If you do not specify maturity, the default is 10Y.
Endpoint
GET /api/v1/spread
Example cURL
Example JSON response
Interpretation:
- spread_bps is in basis points; 215 means NO 10Y is 2.15% above the US 10Y.
- country_yield and benchmark_yield are percentages for each leg.
Python
import requests
params = {"country": "NO", "benchmark": "US", "maturity": "10Y"}
r = requests.get("https://bonds-api.com/api/v1/spread",
headers={"X-API-Key": "YOUR_API_KEY"}, params=params)
sp = r.json()
print(f"NO vs US {sp['maturity']} spread: {sp['spread_bps']} bps")
JavaScript
async function getNOSpread() {
const url = new URL("https://bonds-api.com/api/v1/spread");
url.searchParams.set("country", "NO");
url.searchParams.set("benchmark", "US");
url.searchParams.set("maturity", "10Y");
const resp = await fetch(url.toString(), { headers: { "X-API-Key": "YOUR_API_KEY" }});
const json = await resp.json();
console.log(json.spread_bps, "bps");
}
getNOSpread();
PHP
<?php
$params = http_build_query(["country" => "NO", "benchmark" => "US", "maturity" => "10Y"]);
$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/spread?$params", false, $ctx);
Fetch the full Norway yield curve
To draw a curve chart or fit a spline, request the full curve. You can pass a specific date if you need a historical curve snapshot; otherwise, the API returns the latest available business day. The inverted flag is included to quickly assess curve shape.
Endpoint
GET /api/v1/curve
Example cURL
Example JSON response
Interpretation:
- curve is a map from maturity code to yield (%).
- inverted indicates whether short-end yields exceed long-end yields.
Python
import requests
r = requests.get("https://bonds-api.com/api/v1/curve",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "NO"})
curve = r.json()
tenors = ["1M","3M","6M","1Y","2Y","5Y","10Y","30Y"]
points = [(t, curve["curve"].get(t)) for t in tenors]
print("As of", curve["date"], points, "inverted:", curve["inverted"])
JavaScript
async function getNOCurve() {
const url = new URL("https://bonds-api.com/api/v1/curve");
url.searchParams.set("country", "NO");
const resp = await fetch(url.toString(), { headers: { "X-API-Key": "YOUR_API_KEY" }});
const json = await resp.json();
console.log("Curve date:", json.date, "10Y:", json.curve["10Y"]);
}
getNOCurve();
PHP
<?php
$params = http_build_query(["country" => "NO"]);
$ctx = stream_context_create(["http" => ["method" => "GET", "header" => "X-API-Key: YOUR_API_KEY\r\n"]]);
$data = file_get_contents("https://bonds-api.com/api/v1/curve?$params", false, $ctx);
echo $data;
Monitor Norway intraday 10Y snapshots
Intraday snapshots help you build tick charts or check mid-day moves. Timestamps are always in UTC; align them to your UI time zone if needed.
Endpoint
GET /api/v1/intraday
Example cURL
Example JSON response
Interpretation:
- snapshots is an array of intraday observations with fetched_at in UTC.
- count is a convenience field to pre-allocate arrays in clients.
Python
import requests, datetime as dt
params = {"country": "NO", "maturity": "10Y", "date": "2026-10-28"}
r = requests.get("https://bonds-api.com/api/v1/intraday",
headers={"X-API-Key": "YOUR_API_KEY"}, params=params)
snap = r.json()["snapshots"]
# Convert to local timestamps if needed
print([(s["yield"], s["fetched_at"]) for s in snap])
JavaScript
async function getNOIntraday() {
const url = new URL("https://bonds-api.com/api/v1/intraday");
url.searchParams.set("country", "NO");
url.searchParams.set("maturity", "10Y");
url.searchParams.set("date", "2026-10-28");
const resp = await fetch(url.toString(), { headers: { "X-API-Key": "YOUR_API_KEY" }});
const json = await resp.json();
json.snapshots.forEach(s => console.log(s.fetched_at, s.yield));
}
getNOIntraday();
PHP
<?php
$q = http_build_query(["country" => "NO", "maturity" => "10Y", "date" => "2026-10-28"]);
$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?$q", false, $ctx);
Summarize Norway yield changes over a period
The fluctuation endpoint returns start, end, absolute change, and the min/max over the range. Use it for quick risk dashboards or alerting policies.
Endpoint
GET /api/v1/fluctuation
Example cURL
Example JSON response
Interpretation:
- All figures are in percentage points, not basis points.
- change equals end_yield - start_yield.
Python
import requests
params = {"countries": "NO", "maturity": "10Y", "start": "2025-10-28", "end": "2026-10-28"}
r = requests.get("https://bonds-api.com/api/v1/fluctuation",
headers={"X-API-Key": "YOUR_API_KEY"}, params=params)
f = r.json()["data"]["NO"]
print("Change (pp):", f["change"], "Range:", f["min"], "to", f["max"])
JavaScript
async function getNOFluct() {
const url = new URL("https://bonds-api.com/api/v1/fluctuation");
url.searchParams.set("countries", "NO");
url.searchParams.set("maturity", "10Y");
url.searchParams.set("start", "2025-10-28");
url.searchParams.set("end", "2026-10-28");
const resp = await fetch(url.toString(), { headers: { "X-API-Key": "YOUR_API_KEY" }});
const json = await resp.json();
console.log(json.data.NO);
}
getNOFluct();
PHP
<?php
$p = http_build_query(["countries" => "NO", "maturity" => "10Y", "start" => "2025-10-28", "end" => "2026-10-28"]);
$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/fluctuation?$p", false, $ctx));
Build and use the Norway yield curve in applications
For a robust curve, you have two options:
- Use the curve endpoint to fetch the entire set in one request (recommended).
- Call latest with a specific list of maturities if you only need, for example, 2Y/5Y/10Y points.
To compute carry/roll or spread trades, combine curve points with spread data. For example, 10s30s slope equals curve["30Y"] - curve["10Y"]. When plotting or interpolating, keep units in % and do not convert to decimals unless your analytics library expects decimals.
Cache strategy:
- Daily cache: store curve responses keyed by country and date. Intra-day updates for end-of-day levels are rare; invalidate when the effective date changes.
- Intraday cache: for the intraday endpoint, key by country, maturity, and date; refresh on a schedule (e.g., every 15–30 minutes during Oslo trading hours).
- Graceful fallbacks: on 404 (no data for a holiday), use the prior business day’s curve.
To explore endpoint parameters interactively, use the MCP console. For additional documentation, see the homepage at bonds-api.com.
Error handling, market calendar, and update frequency
Common error responses adhere to a consistent JSON shape with success=false and an error message:
- 401: Missing or invalid X-API-Key
- 403: Account quota exceeded
- 404: No data for the requested country/maturity/date
- 422: Invalid parameter format (e.g., wrong date or ISO2 code)
- 429: Rate limit exceeded
- 500: Server error
Calendar and updates:
- Business days: The API tracks Oslo trading days. On weekends/holidays, latest resolves to the most recent business day.
- Update frequency: End-of-day yields typically settle once per trading day; intraday snapshots update multiple times per day as indicated by fetched_at timestamps.
- Time zones: All intraday timestamps are UTC. Convert in your client for display.
Resilience tips:
- On 429, back off with exponential delay and use cached data for non-latency-critical paths.
- On 404 for a given date, retry with the previous business day logic in your app.
- Log and surface the source field to distinguish official vs. market-derived updates in audits.
Putting it together: Norway analytics in practice
With these endpoints, you can implement:
- Risk dashboards: pull curve, compute DV01-weighted exposures using 2Y–30Y points.
- Macro monitors: query fluctuation stats weekly for 10Y and 2Y, plus the 2s10s slope from the curve endpoint.
- Relative value: monitor NO vs. US 10Y spreads; alert when spread_bps crosses thresholds.
- Intraday panels: stream intraday snapshots to visualize yield changes across the Oslo session.
For a straightforward build, fetch the full curve each morning, cache it, and then overlay live intraday 10Y snapshots on the chart. Use the historical endpoint to annotate key events with prior-day yields, and the timeseries endpoint for rolling regressions against inflation surprises or FX moves.
Reference: Endpoint matrix at a glance
- /api/v1/latest: Current yields for NO across chosen maturities.
- /api/v1/historical: Yield for NO at a specific date and maturity.
- /api/v1/timeseries: Daily series for NO over a date range.
- /api/v1/intraday: Intraday snapshots for NO on a given date and maturity.
- /api/v1/spread: Basis-point spread vs. a benchmark country.
- /api/v1/curve: Full Norway curve with inverted flag.
- /api/v1/fluctuation: Start, end, change, min, max over a period.
All endpoints are GET and require X-API-Key. See bonds-api.com for broader coverage and release notes.
FAQ
How are yields expressed?
All yields are percentage values. For example, "yield": 4.52 means 4.52%. Only spread_bps is in basis points (e.g., 215 bps = 2.15%).
What date and time formats should I expect?
Dates are Y-m-d (e.g., 2026-10-28). Intraday timestamps are ISO 8601 in UTC with a Z suffix (e.g., 2026-10-28T12:00:00Z).
How do I handle Norwegian market holidays?
If you query a non-trading day via historical, you may receive 404. Adjust to the prior business day or use latest, which returns the most recent available date.
Can I fetch all maturities at once?
Yes. Use /api/v1/curve for the entire Norway curve on the latest date. Alternatively, use /api/v1/latest without the maturities parameter to retrieve all available tenors for NO.
What’s the best way to minimize latency and rate usage?
Cache daily curve and latest responses by date and country. For intraday, cache snapshots and refresh on a schedule aligned with your UI. Use fluctuation for summary panels instead of computing stats client-side each time.
Ready to integrate Norway yields into your stack? Generate an API key and start querying in minutes: Register. To test endpoints interactively, open the developer console at MCP. For an overview of coverage and updates, visit bonds-api.com.