You need accurate, machine-readable Chilean government bond yields that you can query on demand and feed into models, dashboards, and risk tools. By the end of this article, you’ll be able to pull current, historical, intraday, and curve-level yields for Chile via Bonds API, compute spreads to benchmarks, and build a complete CL yield curve for analytics and trading signals.
What you get with Bonds API for Chile
Bonds API delivers sovereign bond yields as JSON over REST. For Chile (ISO2: CL), you can fetch the latest levels by maturity, point-in-time historical values, bounded time series for quant studies, full curves, intraday snapshots, and cross-country spreads versus a benchmark such as US Treasuries. All endpoints are HTTP GET and authenticate with an X-API-Key header.
Yields are expressed in percent (for example, 4.52 means 4.52%). Spread fields are expressed in basis points (for example, 215 means 2.15%). Dates are in YYYY-MM-DD. Intraday timestamps are ISO 8601 with a Z suffix indicating UTC. See the endpoint-specific sections below for the exact field names and their meanings.
If you are new to the service, start at bonds-api.com. When you’re ready to test requests, use your API key in the X-API-Key header. You can get one here: Register. Power users can also manage integrations and credentials in the MCP.
Quick primer: Chilean sovereign bond yields and maturities
Chile issues government securities across bills and bonds from short-dated (1M, 3M, 6M) to long-dated (30Y). Bonds API standardizes maturities under keys like 1M, 3M, 6M, 1Y, 2Y, 5Y, 10Y, and 30Y. Analysts often look at the 2s10s slope, the 5Y belly for duration-neutral trades, and the 10Y for macro signaling. With the API you can pull any single maturity or multiple maturities to plot slices of the curve.
Authentication and request pattern
All endpoints:
- Base URL: https://bonds-api.com/api/v1/
- Method: GET
- Auth: X-API-Key request header
Example header:
X-API-Key: YOUR_API_KEY
Do not pass the API key as a query parameter. Always use the header shown above.
Endpoint: Latest yields for Chile
Use this to fetch the most recent available yields by maturity for Chile. You can specify a subset of maturities or omit the maturities parameter to return all currently 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": "CL", "maturities": "2Y,10Y"}
)
data = resp.json()
# Access yields:
cl_2y = data["data"]["CL"]["2Y"]["yield"]
cl_10y = data["data"]["CL"]["10Y"]["yield"]
asof = data["data"]["CL"]["10Y"]["date"]
JavaScript (fetch)
async function getLatestChile() {
const url = new URL("https://bonds-api.com/api/v1/latest");
url.searchParams.set("countries", "CL");
url.searchParams.set("maturities", "2Y,10Y");
const resp = await fetch(url.toString(), {
headers: { "X-API-Key": "YOUR_API_KEY" }
});
const json = await resp.json();
const twoY = json.data.CL["2Y"].yield; // percent
const tenY = json.data.CL["10Y"].yield; // percent
const date = json.data.CL["10Y"].date; // YYYY-MM-DD
return { twoY, tenY, 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=CL&maturities=2Y,10Y";
$json = file_get_contents($url, false, $context);
$data = json_decode($json, true);
$y2 = $data["data"]["CL"]["2Y"]["yield"];
$y10 = $data["data"]["CL"]["10Y"]["yield"];
$date = $data["data"]["CL"]["10Y"]["date"];
?>
JSON response (official example)
{
"success": true,
"date": "2026-11-10",
"rates": {
"US_10Y": 4.879
},
"dates": {
"US_10Y": "2026-11-10"
},
"currencies": {
"US_10Y": "USD"
},
"meta": {
"request_id": "f482e455-3269-40a6-a5db-a7835187d4c6",
"timestamp": "2026-11-10T00:06:08+00:00"
}
}
How to read it:
- yield: percent (e.g., 4.52 means 4.52%).
- date: YYYY-MM-DD, the as-of trading day for the yield.
- source: source provenance such as “official”.
Endpoint: Historical yield on a specific date
Use this to retrieve a point-in-time yield for a given maturity on an exact calendar date. If the date is a market holiday or weekend, the API returns 404 if no data exists for that date.
cURL
Python (requests)
import requests
params = {"country": "CL", "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()
ten_yield = hist["yield"] # percent
asof = hist["date"]
JavaScript (fetch)
async function getChileHistorical() {
const url = new URL("https://bonds-api.com/api/v1/historical");
url.searchParams.set("country", "CL");
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" }});
return resp.json();
}
PHP (file_get_contents)
<?php
$params = http_build_query([
"country" => "CL",
"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);
$data = json_decode($json, true);
?>
JSON response (official example)
Fields:
- yield: percent as of the requested date.
- date: YYYY-MM-DD (the exact date you requested).
Endpoint: Time series for Chile
Get a continuous series between two dates for a given maturity. Use this for factor regressions, volatility estimates, or visualizations.
cURL
Python (requests)
import requests
q = {
"country": "CL",
"maturity": "10Y",
"start": "2025-11-10",
"end": "2026-11-10"
}
ts = requests.get(
"https://bonds-api.com/api/v1/timeseries",
headers={"X-API-Key": "YOUR_API_KEY"},
params=q
).json()
series = ts["series"] # list of {date: YYYY-MM-DD, yield: percent}
JavaScript (fetch)
async function getChileSeries() {
const url = new URL("https://bonds-api.com/api/v1/timeseries");
url.searchParams.set("country", "CL");
url.searchParams.set("maturity", "10Y");
url.searchParams.set("start", "2025-11-10");
url.searchParams.set("end", "2026-11-10");
const r = await fetch(url.toString(), { headers: { "X-API-Key": "YOUR_API_KEY" } });
return r.json();
}
PHP (file_get_contents)
<?php
$params = http_build_query([
"country" => "CL",
"maturity" => "10Y",
"start" => "2025-11-10",
"end" => "2026-11-10"
]);
$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/timeseries?$params", false, $context);
$data = json_decode($json, true);
?>
JSON response (official example)
Fields:
- series: array of objects with date (YYYY-MM-DD) and yield (percent).
Endpoint: Spread versus a benchmark
Compute the CL yield spread versus a benchmark country at a specified maturity. By default, maturity is 10Y if omitted.
cURL
Python (requests)
import requests
sp = requests.get(
"https://bonds-api.com/api/v1/spread",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "CL", "benchmark": "US", "maturity": "10Y"}
).json()
spread_bps = sp["spread_bps"] # basis points
cl_y = sp["country_yield"] # percent
us_y = sp["benchmark_yield"] # percent
JavaScript (fetch)
async function getChileSpread() {
const url = new URL("https://bonds-api.com/api/v1/spread");
url.searchParams.set("country", "CL");
url.searchParams.set("benchmark", "US");
url.searchParams.set("maturity", "10Y");
const r = await fetch(url.toString(), { headers: { "X-API-Key": "YOUR_API_KEY" }});
return r.json();
}
PHP (file_get_contents)
<?php
$params = http_build_query([
"country" => "CL",
"benchmark" => "US",
"maturity" => "10Y"
]);
$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/spread?$params", false, $context);
$data = json_decode($json, true);
?>
JSON response (official example)
Fields:
- spread_bps: basis points (1 bp = 0.01%). 215 means 2.15% spread.
- country_yield and benchmark_yield: percent.
Endpoint: Full Chile yield curve
Retrieve the entire curve for the latest available trading day (or a requested date). This is the most direct way to plot a curve and compute slopes.
cURL
Python (requests)
import requests
curve = requests.get(
"https://bonds-api.com/api/v1/curve",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "CL"}
).json()
asof = curve["date"] # YYYY-MM-DD
inverted = curve["inverted"] # boolean
points = curve["curve"] # dict of maturity => yield (percent)
tenY = points.get("10Y")
JavaScript (fetch)
async function getChileCurve() {
const url = new URL("https://bonds-api.com/api/v1/curve");
url.searchParams.set("country", "CL");
const r = await fetch(url.toString(), { headers: { "X-API-Key": "YOUR_API_KEY" }});
return r.json();
}
PHP (file_get_contents)
<?php
$params = http_build_query(["country" => "CL"]);
$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/curve?$params", false, $context);
$data = json_decode($json, true);
?>
JSON response (official example)
Fields:
- curve: maturity-to-yield map, values in percent.
- inverted: true if short maturities exceed long ones overall.
Endpoint: Intraday snapshots for Chile
Use this to analyze within-day moves. Snapshots include a UTC timestamp for the fetch time, allowing you to chart microstructure or compute intraday volatility.
cURL
Python (requests)
import requests
intraday = requests.get(
"https://bonds-api.com/api/v1/intraday",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "CL", "maturity": "10Y", "date": "2026-11-10"}
).json()
snaps = intraday["snapshots"]
for s in snaps:
# s["yield"] is percent; s["fetched_at"] is ISO8601 in UTC
pass
JavaScript (fetch)
async function getChileIntraday() {
const url = new URL("https://bonds-api.com/api/v1/intraday");
url.searchParams.set("country", "CL");
url.searchParams.set("maturity", "10Y");
url.searchParams.set("date", "2026-11-10");
const r = await fetch(url.toString(), { headers: { "X-API-Key": "YOUR_API_KEY" }});
return r.json();
}
PHP (file_get_contents)
<?php
$params = http_build_query([
"country" => "CL",
"maturity" => "10Y",
"date" => "2026-11-10"
]);
$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/intraday?$params", false, $context);
$data = json_decode($json, true);
?>
JSON response (official example)
Fields:
- yield: percent at the snapshot time.
- fetched_at: ISO 8601 timestamp, UTC (Z suffix).
- count: number of snapshots in the array.
Endpoint: Fluctuation over a period
Summarize change, min, and max for Chile over a date range at a maturity. Useful for risk dashboards, alerting, and weekly/monthly performance tiles.
cURL
Python (requests)
import requests
fl = requests.get(
"https://bonds-api.com/api/v1/fluctuation",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"countries": "CL", "maturity": "10Y", "start": "2025-11-10", "end": "2026-11-10"}
).json()
chg = fl["data"]["CL"]["change"] # percent change over period
mn = fl["data"]["CL"]["min"]
mx = fl["data"]["CL"]["max"]
JavaScript (fetch)
async function getChileFluctuation() {
const url = new URL("https://bonds-api.com/api/v1/fluctuation");
url.searchParams.set("countries", "CL");
url.searchParams.set("maturity", "10Y");
url.searchParams.set("start", "2025-11-10");
url.searchParams.set("end", "2026-11-10");
const r = await fetch(url.toString(), { headers: { "X-API-Key": "YOUR_API_KEY" }});
return r.json();
}
PHP (file_get_contents)
<?php
$params = http_build_query([
"countries" => "CL",
"maturity" => "10Y",
"start" => "2025-11-10",
"end" => "2026-11-10"
]);
$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/fluctuation?$params", false, $context);
$data = json_decode($json, true);
?>
JSON response (official example)
Fields:
- start_yield, end_yield: percent at endpoints.
- change: arithmetic difference in percent points.
- min, max: extrema in the window.
Building a Chile yield curve and common analytics
You can derive a CL yield curve either by calling /curve once or by using /latest with multiple maturities. For custom selections (for example, 2Y, 5Y, 7Y, 10Y), use /latest with the maturities parameter. For the canonical, full set, /curve is simpler and also indicates whether the curve is inverted.
Using /latest with multiple maturities
Mapping the data.data.CL object gives you a maturity-to-yield dictionary for plotting and for computing slopes like 2s10s (data.CL["2Y"].yield minus data.CL["10Y"].yield).
Yield spreads and relative value
To monitor risk-on/risk-off or external rate pressures, call /spread with benchmark=US (or DE for Bunds). Store spread_bps as your primary key for regressions, and keep the raw levels (country_yield, benchmark_yield) for decomposition.
Curve diagnostics
- inverted from /curve gives a quick signal of curve shape.
- Use /timeseries to run rolling slope calculations between pairs of maturities over time.
- Use /fluctuation to summarize weekly or monthly changes for status dashboards.
Practical integration notes
Business days and Chilean holidays
Yields are published on trading days. On weekends and Chile market holidays, there may be no new observations. For historical and intraday requests, if the provided date has no trading data, expect a 404 with success=false and an error message. To handle this gracefully, backfill from the previous available business day when visualizing or alerting.
Update frequency and intraday cadence
/latest and /curve provide end-of-day (or last available) snapshots. For within-day tracking, use /intraday to collect multiple timestamps. Snapshots include fetched_at in UTC; if your application is Chile-timezone aware, convert from UTC for display while storing the canonical UTC timestamp for calculations.
Caching strategies
- Cache /curve and /latest responses by country and date for at least the trading day to reduce redundant calls.
- Cache /historical and /timeseries indefinitely, as these are immutable time points.
- For /intraday, choose a sensible refresh cadence (e.g., every 15–60 minutes) and de-duplicate by fetched_at.
Error handling
Error responses share a standard shape with success=false and an error message. Common HTTP codes:
- 401: Missing or invalid X-API-Key.
- 403: Quota exceeded.
- 404: No data for country/maturity/date.
- 422: Invalid parameters (e.g., wrong date format).
- 429: Rate limit exceeded.
- 500: Server error.
Always check the success flag in responses before reading yield fields.
Use cases for developers and analysts
- Financial dashboards: Pin tiles for CL 2Y, 5Y, 10Y, 30Y from /latest; add weekly change from /fluctuation; chart intraday moves from /intraday.
- Risk tools: Pull /curve for duration exposure and compute DV01 approximations assuming a parallel shift. Monitor spread_bps from /spread for stress triggers.
- Economic research: Use /timeseries to estimate term premia, curve-factor decompositions, or to align macro releases with yield reactions.
- Quant strategies: Build signals from rolling slopes and mean-reversion between Chile and benchmarks using /spread and /timeseries.
The API is designed to be composable: mix /curve for state, /intraday for flow, /timeseries for history, and /spread for context. Browse more at bonds-api.com.
Reference: Chile maturities you’ll commonly query
| Maturity key | Interpretation | Typical usage |
|---|---|---|
| 1M, 3M, 6M | Money-market bills | Front-end rate expectations, policy signaling |
| 1Y | Short-term sovereign bond | Carry/roll analysis |
| 2Y | Short duration point | Curve slope vs. 10Y (2s10s) |
| 5Y | Intermediate tenor | Belly trades, macro proxy |
| 10Y | Benchmark long tenor | Macro regime tracking, cross-market spreads |
| 30Y | Long end | Term premium and pension flows |
End-to-end example: build a Chile curve, compute 2s10s, compare to US
Step 1: Get the Chile curve
Step 2: Compute 2s10s slope
import requests
r = requests.get(
"https://bonds-api.com/api/v1/curve",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "CL"}
).json()
y2 = r["curve"].get("2Y")
y10 = r["curve"].get("10Y")
slope_2s10 = y2 - y10 # percentage points
Step 3: Compare Chile 10Y to US 10Y via spread
Use spread_bps to store the signal and threshold alerts. Because spread_bps is in basis points, a trigger at 200 means 2.00%.
Units, timestamps, and reading the data correctly
- Percent: All yields are decimal percentages (e.g., 4.52 means 4.52%).
- Basis points: spread_bps is an integer or float in bps (1 bp = 0.01%).
- Dates: date fields are YYYY-MM-DD, representing the as-of trading day.
- Intraday timestamps: fetched_at is ISO 8601 UTC (Z suffix). Convert for display if needed, but store UTC for reproducibility.
Troubleshooting tips
- Empty data for a given maturity: some maturities may not be available on certain days. Either call /curve for the full set or fall back to nearby tenors.
- 404 on historical dates: check if the date is a weekend/holiday; try the previous business day.
- 429 rate limit: add client-side caching and backoff. Cache immutable endpoints like /historical and /timeseries.
- 422 parameter errors: verify ISO2 code is CL, maturity format like 10Y, and dates in YYYY-MM-DD.
Where to go next
Everything in this article works with a single API key and GET requests. Explore more capabilities at bonds-api.com, manage access in the MCP, and start integrating today: Register.
FAQ
What maturities are supported for Chile?
Bonds API standardizes common points like 1M, 3M, 6M, 1Y, 2Y, 5Y, 10Y, and 30Y. Use /curve to see which points are available on a given date, or /latest with specific maturities.
How often are yields updated?
End-of-day levels update on trading days. For within-day monitoring, use /intraday; timestamps are in UTC so you can schedule fetches and align to your local trading hours.
How do I handle weekends or Chile market holidays?
If no data exists for a date, you’ll receive a 404. Backfill from the last available business day for charts and add messaging in your UI noting the as-of date.
Are yields quoted in percent or decimal form?
Percent. For example, 4.52 corresponds to 4.52%, not 0.0452. Spreads are in basis points (e.g., 215 bps = 2.15%).
Can I compare Chile to other markets?
Yes. Use /spread with benchmark=US (or another ISO2 benchmark like DE) and the maturity of interest. You’ll get spread_bps along with both underlying yields.
Ready to integrate Chilean yields into your stack? Get an API key now and ship your first request in minutes: Register. If you prefer to explore interactively, visit bonds-api.com for more details.