You need accurate, machine-readable access to the Israel 10-year government bond yield for dashboards, models, and backtests. By the end of this guide, you will be able to query Israel’s 10Y yield in real time, pull historical and intraday data, compute spreads versus benchmarks, and assemble a full Israel yield curve using the Bonds API over HTTPS with your API key.
What you get from Bonds API for Israel (IL) 10Y
Bonds API exposes sovereign yields as JSON via a simple REST interface. For Israel (ISO2: IL), you can fetch:
- Latest: current yields across maturities including 10Y
- Historical: end-of-day yield on a specific calendar date
- Time series: contiguous daily yields across a date range
- Intraday: multiple snapshots within a trading day
- Spread: basis-point spread versus a benchmark (e.g., US Treasuries)
- Curve: the full term structure for Israel on a given day
- Fluctuation: start/end levels, change, min and max over a period
All endpoints are GET requests to https://bonds-api.com/api/v1/ and require an API key via the X-API-Key header. Yields are expressed in percent (e.g., 4.52 means 4.52%). For spreads, values are in basis points (bps). Dates use the YYYY-MM-DD format, and timestamps are ISO 8601 (UTC). Learn more at bonds-api.com. To start building, Register for an API key.
Endpoint: Latest yields — Israel across maturities (including 10Y)
Use this to get the most recent available yields. You can request all available maturities or specify a subset like 2Y and 10Y. Results are end-of-day unless combined with intraday usage; date reflects the trading day of the yield.
cURL
curl -s "https://bonds-api.com/api/v1/latest?countries=US&maturities=10Y&api_key=YOUR_API_KEY"
Official JSON example
{
"success": true,
"date": "2026-11-17",
"rates": {
"US_10Y": 5.133
},
"dates": {
"US_10Y": "2026-11-17"
},
"currencies": {
"US_10Y": "USD"
},
"meta": {
"request_id": "82fcc098-3a2d-407a-91d7-9875d31fef5c",
"timestamp": "2026-11-17T00:07:59+00:00"
}
}
How to read this:
- yield: percentage value (4.52 means 4.52%)
- date: trading date of the observation (YYYY-MM-DD)
- source: “official” indicates the primary market data source
Python (requests)
import requests
resp = requests.get(
"https://bonds-api.com/api/v1/latest",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"countries": "IL", "maturities": "2Y,10Y"}
)
data = resp.json()
il_10y = data["data"]["IL"]["10Y"]["yield"]
il_10y_date = data["data"]["IL"]["10Y"]["date"]
print("IL 10Y:", il_10y, "on", il_10y_date)
JavaScript (fetch)
const url = new URL("https://bonds-api.com/api/v1/latest");
url.search = new URLSearchParams({ countries: "IL", maturities: "2Y,10Y" });
fetch(url.toString(), {
method: "GET",
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(json => {
const y = json.data.IL["10Y"].yield;
const d = json.data.IL["10Y"].date;
console.log(`IL 10Y: ${y}% @ ${d}`);
});
PHP (file_get_contents)
<?php
$context = stream_context_create([
"http" => [
"method" => "GET",
"header" => "X-API-Key: YOUR_API_KEY\r\n"
]
]);
$q = http_build_query(["countries" => "IL", "maturities" => "2Y,10Y"]);
$json = file_get_contents("https://bonds-api.com/api/v1/latest?$q", false, $context);
$data = json_decode($json, true);
$il10 = $data["data"]["IL"]["10Y"]["yield"];
$date = $data["data"]["IL"]["10Y"]["date"];
echo "IL 10Y: $il10% on $date\n";
Endpoint: Historical yield — Israel 10Y on a specific date
Retrieve the 10Y yield for a single day. Useful for backfilling or date-specific event studies.
cURL
Official JSON example
Fields:
- yield: percent value for the 10Y on that date
- date: the requested YYYY-MM-DD
Python (requests)
import requests
params = {"country": "IL", "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)
h = r.json()
print(h["country"], h["maturity"], h["yield"], h["date"])
JavaScript (fetch)
const params = new URLSearchParams({ country: "IL", maturity: "10Y", date: "2025-06-15" });
fetch(`https://bonds-api.com/api/v1/historical?${params}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(j => console.log(`IL 10Y ${j.yield}% on ${j.date}`));
PHP (file_get_contents)
<?php
$p = http_build_query(["country"=>"IL","maturity"=>"10Y","date"=>"2025-06-15"]);
$ctx = stream_context_create(["http"=>["method"=>"GET","header"=>"X-API-Key: YOUR_API_KEY\r\n"]]);
$out = file_get_contents("https://bonds-api.com/api/v1/historical?$p", false, $ctx);
echo $out;
Endpoint: Time series — Israel 10Y between two dates
Pull contiguous daily closes over a range to power charts, regressions, and risk models. Start and end are inclusive and must be in YYYY-MM-DD format.
cURL
Official JSON example
Fields:
- series: ordered list of daily yield points, each with date (YYYY-MM-DD) and yield (percent)
Python (requests)
import requests, pandas as pd
params = {"country": "IL", "maturity": "10Y", "start": "2025-11-17", "end": "2026-11-17"}
r = requests.get("https://bonds-api.com/api/v1/timeseries",
headers={"X-API-Key": "YOUR_API_KEY"},
params=params)
js = r.json()
df = pd.DataFrame(js["series"])
print(df.head())
JavaScript (fetch)
const p = new URLSearchParams({
country: "IL", maturity: "10Y", start: "2025-11-17", end: "2026-11-17"
});
fetch(`https://bonds-api.com/api/v1/timeseries?${p}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(j => {
for (const row of j.series) {
console.log(row.date, row.yield);
}
});
PHP (file_get_contents)
<?php
$p = http_build_query([
"country"=>"IL","maturity"=>"10Y","start"=>"2025-11-17","end"=>"2026-11-17"
]);
$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?$p", false, $ctx);
Endpoint: Spread — Israel vs benchmark (US) at 10Y
Compute the Israel 10Y spread versus a benchmark country. The response returns spread_bps (basis points), plus the underlying country and benchmark yields.
cURL
Official JSON example
Fields:
- spread_bps: difference in basis points (1 bp = 0.01%)
- country_yield, benchmark_yield: percent yields for IL and benchmark
Python (requests)
import requests
params = {"country":"IL","benchmark":"US","maturity":"10Y"}
r = requests.get("https://bonds-api.com/api/v1/spread",
headers={"X-API-Key":"YOUR_API_KEY"},
params=params)
s = r.json()
print(f"IL-UST 10Y spread: {s['spread_bps']} bps")
JavaScript (fetch)
const p = new URLSearchParams({ country: "IL", benchmark: "US", maturity: "10Y" });
fetch(`https://bonds-api.com/api/v1/spread?${p}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(j => console.log(`Spread: ${j.spread_bps} bps (IL ${j.country_yield}% vs US ${j.benchmark_yield}%)`));
PHP (file_get_contents)
<?php
$p = http_build_query(["country"=>"IL","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?$p", false, $ctx);
Endpoint: Curve — Full Israel yield curve on a date
Get a snapshot of Israel’s term structure. If no date is provided, the latest available day with data is returned. The API flags inversion when shorter maturities exceed longer ones.
cURL
Official JSON example
Fields:
- inverted: boolean indicating curve inversion
- curve: mapping of maturity to percent yield
Python (requests)
import requests
r = requests.get("https://bonds-api.com/api/v1/curve",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "IL"})
curve = r.json()
tenor10 = curve["curve"]["10Y"]
print("IL curve 10Y:", tenor10)
JavaScript (fetch)
fetch("https://bonds-api.com/api/v1/curve?country=IL", {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(j => {
console.log("Inverted:", j.inverted);
console.table(j.curve);
});
PHP (file_get_contents)
<?php
$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?country=IL", false, $ctx);
Endpoint: Intraday — Israel 10Y snapshots within a trading day
For applications that need sub-daily granularity, intraday snapshots provide multiple yields with timestamps in UTC. Use this to compute high/low, VWAP approximations, or real-time indicators.
cURL
Official JSON example
Fields:
- snapshots[].yield: percent value at snapshot time
- snapshots[].fetched_at: ISO 8601 UTC timestamp
- count: number of snapshots returned; meta.timezone indicates UTC
Python (requests)
import requests, statistics
params = {"country":"IL","maturity":"10Y","date":"2026-11-17"}
r = requests.get("https://bonds-api.com/api/v1/intraday",
headers={"X-API-Key":"YOUR_API_KEY"},
params=params)
j = r.json()
yields = [s["yield"] for s in j["snapshots"]]
print("IL 10Y intraday mean:", statistics.mean(yields))
JavaScript (fetch)
const p = new URLSearchParams({ country:"IL", maturity:"10Y", date:"2026-11-17" });
fetch(`https://bonds-api.com/api/v1/intraday?${p}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(j => {
const highs = Math.max(...j.snapshots.map(s => s.yield));
const lows = Math.min(...j.snapshots.map(s => s.yield));
console.log(`High: ${highs}%, Low: ${lows}%`);
});
PHP (file_get_contents)
<?php
$p = http_build_query(["country"=>"IL","maturity"=>"10Y","date"=>"2026-11-17"]);
$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);
Endpoint: Fluctuation — Israel 10Y change, min, max over a period
Summarize the 10Y yield’s movement between two dates, with start/end values and extremes. This is efficient for period-over-period screens and risk summaries.
cURL
Official JSON example
Fields:
- start_yield, end_yield, change: percent values (change in percentage points)
- min, max: observed extremes within the range (percent)
Python (requests)
import requests
params = {"countries":"IL","maturity":"10Y","start":"2025-11-17","end":"2026-11-17"}
r = requests.get("https://bonds-api.com/api/v1/fluctuation",
headers={"X-API-Key":"YOUR_API_KEY"},
params=params)
f = r.json()["data"]["IL"]
print(f"Δ: {f['change']} pp | min: {f['min']}% | max: {f['max']}%")
JavaScript (fetch)
const p = new URLSearchParams({
countries: "IL", maturity: "10Y", start: "2025-11-17", end: "2026-11-17"
});
fetch(`https://bonds-api.com/api/v1/fluctuation?${p}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(j => {
const s = j.data.IL;
console.log(`Change: ${s.change} pp; Range: [${s.min}%, ${s.max}%]`);
});
PHP (file_get_contents)
<?php
$p = http_build_query(["countries"=>"IL","maturity"=>"10Y","start"=>"2025-11-17","end"=>"2026-11-17"]);
$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?$p", false, $ctx);
Business days, market holidays, and update frequency
Daily yields are typically available on business days for Israel’s bond market calendar. Requests that fall on weekends or Israel market holidays will return the latest available business day when using the latest endpoint, and no data for a specific closed date if that day lacked an official close. Intraday snapshots reflect UTC timestamps and are provided when markets are active or when indicative levels are published.
When calling time series or fluctuation endpoints, expect gaps for weekends/holidays; your application should forward-fill or interpolate if needed. To minimize load and latency, cache stable data (e.g., previous business day’s close) and only refresh intraday endpoints at your chosen polling interval. Handle 429 (rate limit exceeded) and 403 (quota exceeded) by backing off or scheduling batch windows.
Building the Israel yield curve and a 10Y-focused dashboard
If your UI needs multiple tenors, prefer the curve endpoint to minimize roundtrips. It returns a dictionary of maturities and yields in one response, ideal for charting the full curve and flagging inversion. If you only track a few points (e.g., 2Y, 5Y, 10Y), the latest endpoint with maturities=2Y,5Y,10Y is efficient.
| Maturity | Purpose | Endpoint Suggestion |
|---|---|---|
| 2Y | Short-term rate sensitivity | /latest with 2Y, or /curve |
| 5Y | Intermediate pivot | /latest with 5Y, or /curve |
| 10Y | Benchmark medium-term | /latest 10Y, /historical, /timeseries, /intraday |
| 30Y | Long-end risk and ALM | /curve |
For spread analysis, use /spread to compute IL vs US at 10Y and display the result in basis points. Pair it with /timeseries for both IL and US if you want to chart the spread historically by subtracting series.
Error handling and response semantics
All endpoints return success=true on success and success=false on error. Common error codes:
- 401: Missing or invalid X-API-Key
- 403: Account quota exceeded
- 404: No data for requested country/maturity/date
- 422: Invalid parameter (e.g., date format)
- 429: Rate limit exceeded
- 500: Server error
Yields are percentages throughout. Spreads are basis points. Dates are YYYY-MM-DD; intraday uses ISO 8601 UTC timestamps in fetched_at. See the interactive reference at MCP and the main site at bonds-api.com.
Official sample: US 10Y request and response
The following official sample demonstrates a latest request for the US 10Y using a query parameter named api_key and a different response shape. Copying it verbatim ensures compatibility when you test against this format.
How to read this:
- rates.US_10Y: percent yield for US 10Y
- dates.US_10Y: the observation date (YYYY-MM-DD)
- meta.timestamp: ISO 8601 UTC timestamp for the API response
Practical implementation notes
- Normalization: Keep yields as decimals in your DB (e.g., 4.52) and convert to bps only for spread math (multiply by 100 to get basis points of yield; spreads are already in bps).
- Time zones: Treat all dates as trading dates; intraday timestamps are UTC. Align your charting library accordingly.
- Caching: Cache yesterday’s closes for read-heavy dashboards. For intraday, choose a poll interval consistent with your latency needs and rate limits.
- Missing days: Use forward-fill to maintain continuous charts, but keep markers to indicate non-trading days.
- Validation: Validate ISO2 codes (IL) and maturities (e.g., 10Y) before issuing requests to avoid 422 errors.
Use cases for developers and analysts
- Financial dashboards: Display Israel’s latest 10Y yield with color-coded change from prior close using /latest and /fluctuation.
- Portfolio risk: Compute DV01 and scenario shocks by pulling /timeseries and mapping yield changes to price impacts.
- Macro research: Compare IL 10Y vs UST 10Y spread via /spread and analyze its path with /timeseries and simple differencing.
- Curve analytics: Detect inversions via /curve and flag dislocations between 2s/10s and 10s/30s.
Security, performance, and deployment tips
- Keep your X-API-Key server-side. Never expose it in public client code.
- Batch requests: When you need multiple Israeli maturities, use /curve or pass maturities= in /latest to reduce roundtrips.
- Retries: Implement retry with jitter for 500s and backoff for 429s.
- Schema stability: Code defensively against additional fields; rely on documented keys like yield, date, spread_bps.
FAQ
Q: What units are yields and spreads in?
A: Yields are percentages (e.g., 4.52 means 4.52%). Spreads are in basis points (bps), where 1 bp = 0.01%.
Q: What date/timestamp formats should I expect?
A: Daily observations use YYYY-MM-DD. Intraday timestamps (fetched_at and some meta fields) are ISO 8601 in UTC (e.g., 2026-11-17T12:00:00Z).
Q: How do I handle weekends and Israeli market holidays?
A: Daily series will omit non-trading days. Use the previous business day’s close for weekend displays, and forward-fill or annotate gaps in charts.
Q: Can I build the Israel yield curve in one call?
A: Yes. Use /api/v1/curve?country=IL to get multiple maturities (1M to 30Y) with an inversion flag. For a subset, use /latest with the maturities parameter.
Q: What is the best way to compute IL–US 10Y spreads?
A: Use /api/v1/spread with country=IL, benchmark=US, maturity=10Y for a one-shot result in bps. For historical spreads, pull two /timeseries and subtract daily yields, converting to bps if desired.
Start integrating Israel’s 10Y yield into your systems now. Get your API key and explore the interactive reference: Register and browse MCP. For product overview and docs, visit bonds-api.com.