You need clean, machine-readable Chilean sovereign yield data you can plug into models, dashboards, and trading tools. By the end of this guide, you will be able to pull Chile’s latest yields, historical levels, full yield curves, intraday snapshots, and spreads versus benchmarks from the Bonds-API REST service, then assemble them into a robust Chile yield curve workflow for fixed-income analysis.
What you get with the Chile sovereign bond dataset
Bonds-API provides JSON endpoints for sovereign bond yields across 60+ countries, including Chile (ISO2: CL). You can request specific maturities (from bills to long bonds) or retrieve a full curve for a given date. All yields are returned as percentages unless otherwise noted. Spreads are returned in basis points. Dates use the YYYY-MM-DD format and timestamps are UTC.
Chile’s local market follows business-day conventions aligned to local holidays. Bonds-API delivers the last available business day’s close for daily endpoints and UTC-timestamped snapshots for intraday. When building applications, assume non-trading days return the latest available business-day data unless you specify a historical date that is a holiday (which may return a 404 if there was no fixing that day).
All endpoints are GET requests at https://bonds-api.com/api/v1/, authenticated via an X-API-Key header. To explore interactively and test quickly, use the MCP. For production access, visit Register.
Quickstart note: official sample block
The following official sample block is provided as-is for reference. It illustrates a GET call to retrieve a 10Y US Treasury latest yield with an api_key query parameter and a minimal JSON envelope. You can copy-paste it to verify your environment, and then proceed with the Chile-specific endpoints below that use the X-API-Key header convention.
curl -s "https://bonds-api.com/api/v1/latest?countries=US&maturities=10Y&api_key=YOUR_API_KEY"
{
"success": true,
"date": "2026-10-26",
"rates": {
"US_10Y": 4.984
},
"dates": {
"US_10Y": "2026-10-26"
},
"currencies": {
"US_10Y": "USD"
},
"meta": {
"request_id": "b94c691f-4cd5-455a-bf0d-ac591d8d5eb7",
"timestamp": "2026-10-26T00:07:03+00:00"
}
}
Endpoint: latest — current Chile yields
Use /latest to fetch the most recent available yields for Chile by maturity. This is ideal for dashboards, monitors, and curve construction at today’s close.
cURL
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 as percentages:
# data["data"]["CL"]["2Y"]["yield"], data["data"]["CL"]["10Y"]["yield"]
JavaScript (fetch)
const url = new URL("https://bonds-api.com/api/v1/latest");
url.searchParams.set("countries", "CL");
url.searchParams.set("maturities", "2Y,10Y");
fetch(url.toString(), {
method: "GET",
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(d => {
// yields are percentages
const y2 = d.data.CL["2Y"].yield;
const y10 = d.data.CL["10Y"].yield;
console.log("CL 2Y:", y2, "CL 10Y:", y10);
});
PHP (file_get_contents)
<?php
$opts = [
"http" => [
"method" => "GET",
"header" => "X-API-Key: YOUR_API_KEY\r\n"
]
];
$context = stream_context_create($opts);
$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);
// $data["data"]["CL"]["2Y"]["yield"] is a percent
?>
JSON response
How to read this:
- yield is a percentage (e.g., 4.52 means 4.52%).
- date is the business date (YYYY-MM-DD) of the fixing or last available value.
- source indicates data provenance (e.g., official).
Endpoint: historical — yield on a specific date
Query the exact Chile yield for a chosen maturity on a past date. Useful for backtesting, valuation dates, and point-in-time analytics.
cURL
Python
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()
# hist["yield"] is the percent yield for that date, or a 404 if no data for the date.
JavaScript
const params = new URLSearchParams({
country: "CL",
maturity: "10Y",
date: "2025-06-15"
});
fetch(`https://bonds-api.com/api/v1/historical?${params.toString()}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(d => {
console.log("CL 10Y on 2025-06-15:", d.yield, "%");
});
PHP
<?php
$url = "https://bonds-api.com/api/v1/historical?country=CL&maturity=10Y&date=2025-06-15";
$ctx = stream_context_create([
"http" => [
"method" => "GET",
"header" => "X-API-Key: YOUR_API_KEY\r\n"
]
]);
$json = file_get_contents($url, false, $ctx);
$d = json_decode($json, true);
// $d["yield"] is a percentage for the specified date and maturity.
?>
JSON response
Use the yield field as a percentage. If the specified date is a weekend or a Chilean holiday with no fixing, expect a 404 error; use the previous business day or confirm availability with /timeseries.
Endpoint: timeseries — yields between two dates
Retrieve daily Chile yield observations for a maturity across a date range. Excellent for charting, regressions, and volatility estimation.
cURL
Python
import requests
p = {
"country": "CL",
"maturity": "10Y",
"start": "2025-10-26",
"end": "2026-10-26"
}
ts = requests.get(
"https://bonds-api.com/api/v1/timeseries",
headers={"X-API-Key": "YOUR_API_KEY"},
params=p
).json()
# ts["series"] is an array of {"date": "YYYY-MM-DD", "yield": float} rows (percent).
JavaScript
const qs = new URLSearchParams({
country: "CL",
maturity: "10Y",
start: "2025-10-26",
end: "2026-10-26"
});
fetch(`https://bonds-api.com/api/v1/timeseries?${qs.toString()}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(d => {
d.series.forEach(pt => {
// pt.date is YYYY-MM-DD, pt.yield is percent
});
});
PHP
<?php
$q = http_build_query([
"country" => "CL",
"maturity" => "10Y",
"start" => "2025-10-26",
"end" => "2026-10-26"
]);
$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?$q", false, $ctx);
$ts = json_decode($json, true);
// Iterate $ts["series"] for daily points.
?>
JSON response
Each series element provides date (YYYY-MM-DD) and yield (percent). Missing calendar days (weekends/holidays) are omitted; use the dates provided directly rather than assuming dense daily continuity.
Endpoint: spread — Chile vs. benchmark spread
Compute a real-time spread for Chile versus a benchmark sovereign at a specified maturity. The default maturity is 10Y if omitted.
cURL
Python
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 is basis points (1 bp = 0.01%).
# country_yield and benchmark_yield are percentages.
JavaScript
const paramsSpread = new URLSearchParams({
country: "CL",
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(s => {
console.log(`CL-10Y vs US-10Y: ${s.spread_bps} bps`);
});
PHP
<?php
$q = http_build_query([
"country" => "CL",
"benchmark" => "US",
"maturity" => "10Y"
]);
$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/spread?$q", false, $ctx);
$spread = json_decode($json, true);
// $spread["spread_bps"] in basis points (integer/float), yields are percent.
?>
JSON response
Interpretation:
- spread_bps is measured in basis points (1 bp = 0.01%).
- country_yield and benchmark_yield are both percentages.
Endpoint: curve — full Chile yield curve
Retrieve the complete Chile curve on the latest available date (or a requested date). This is the fastest way to build a curve without stitching multiple calls.
cURL
Python
import requests
curve = requests.get(
"https://bonds-api.com/api/v1/curve",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "CL"}
).json()
# curve["curve"] is a map from tenor strings (e.g., "1M","2Y","10Y") to yields in percent.
# curve["inverted"] is a boolean indicator.
JavaScript
fetch("https://bonds-api.com/api/v1/curve?country=CL", {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(c => {
// c.curve has keys like "1M","3M","6M","1Y","2Y","5Y","10Y","30Y"
// values are percentages
console.log("Date:", c.date, "Inverted:", c.inverted);
});
PHP
<?php
$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/curve?country=CL", false, $ctx);
$curve = json_decode($json, true);
// $curve["curve"] maps tenors to percent yields; $curve["inverted"] is boolean.
?>
JSON response
Interpretation:
- curve maps tenor strings to yields (percent).
- date is the business date for the curve.
- inverted is a boolean flag indicating whether near-term yields exceed longer-term yields across a defined segment.
Endpoint: intraday — Chile intraday snapshots
Fetch time-stamped intraday snapshots for a given Chile maturity on a specific date. Useful for trading monitors and market reaction studies. Snapshots include fetched_at timestamps in UTC.
cURL
Python
import requests
p = {"country": "CL", "maturity": "10Y", "date": "2026-10-26"}
intraday = requests.get(
"https://bonds-api.com/api/v1/intraday",
headers={"X-API-Key": "YOUR_API_KEY"},
params=p
).json()
# intraday["snapshots"] is a list of {"yield": float, "fetched_at": ISO-8601 UTC, "source": str}
JavaScript
const qp = new URLSearchParams({ country: "CL", maturity: "10Y", date: "2026-10-26" });
fetch(`https://bonds-api.com/api/v1/intraday?${qp.toString()}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(x => {
// yields are percentages; timestamps are UTC ISO-8601
x.snapshots.forEach(s => console.log(s.fetched_at, s.yield));
});
PHP
<?php
$q = http_build_query(["country" => "CL", "maturity" => "10Y", "date" => "2026-10-26"]);
$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/intraday?$q", false, $ctx);
$intra = json_decode($json, true);
// $intra["snapshots"] with UTC timestamps in $intra["meta"]["timezone"] (UTC)
?>
JSON response
Interpretation:
- yield is a percentage for the snapshot time.
- fetched_at is an ISO-8601 UTC timestamp.
- count provides the number of snapshots returned; meta.timezone clarifies the time basis as UTC.
Endpoint: fluctuation — change, min, max over a period
Compute period-over-period changes in Chile yields, with min and max bounds. Handy for risk summaries, VaR inputs, and monitoring regimes.
cURL
Python
import requests
params = {
"countries": "CL",
"maturity": "10Y",
"start": "2025-10-26",
"end": "2026-10-26"
}
fl = requests.get(
"https://bonds-api.com/api/v1/fluctuation",
headers={"X-API-Key": "YOUR_API_KEY"},
params=params
).json()
# Access fl["data"]["CL"]["change"] (percent), and min/max/start_yield/end_yield (percent).
JavaScript
const qf = new URLSearchParams({
countries: "CL",
maturity: "10Y",
start: "2025-10-26",
end: "2026-10-26"
});
fetch(`https://bonds-api.com/api/v1/fluctuation?${qf.toString()}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(d => {
const stats = d.data.CL;
console.log(`Change: ${stats.change}%, min: ${stats.min}%, max: ${stats.max}%`);
});
PHP
<?php
$q = http_build_query([
"countries" => "CL",
"maturity" => "10Y",
"start" => "2025-10-26",
"end" => "2026-10-26"
]);
$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/fluctuation?$q", false, $ctx);
$fl = json_decode($json, true);
// $fl["data"]["CL"] contains start_yield, end_yield, change, min, max (all percent).
?>
JSON response
All figures under data.CL are expressed in percentages. change is end_yield – start_yield (in percentage points).
Practical implementation notes for Chile yield curves
Typical Chile yield curve construction for analytics can be handled via a single /curve request, which returns a tenor-to-yield map and an inverted indicator. If you need only a subset, /latest can retrieve selected maturities using the maturities parameter (e.g., 2Y,5Y,10Y). For backtesting the curve at a point in time, call /curve with the date parameter to retrieve the historical curve snapshot.
Business days and holidays: Chile’s sovereign market follows local business days. Daily endpoints return the latest available business-day close. On local holidays, /latest will still return the most recent valid date inside the payload; /historical with a holiday date may return 404 if no data, so prefer the previous business day if your processing requires a value. Intraday timestamps are in UTC.
Update frequency and caching: Daily yields are typically stable throughout the day after publication; consider caching daily endpoints (latest, historical, curve) until the next market close to reduce load. For streaming-like needs, use /intraday with an interval you control on the client side. A common pattern is:
- Cache /curve and /latest responses for the trading day.
- Refresh /intraday snapshots every 5–15 minutes during active sessions if needed.
- For historical pulls, prefetch /timeseries windows and reuse across pages.
Building a multi-country comparison: To compute Chile vs. US spreads, use /spread with benchmark=US. To compare across maturities, loop maturities and aggregate results in your UI or use /curve for Chile and a second call for the benchmark country’s curve, then compute pointwise differences (convert percent to basis points locally if needed: bps = 100 × (country% − benchmark%)).
Error handling and response semantics
Bonds-API returns JSON with a success flag. On error, success is false and error contains a message. Be prepared for:
- 401: Missing or invalid X-API-Key. Ensure the header is sent.
- 403: Account quota exceeded. Back off and retry once limits reset.
- 404: No data for the requested country/maturity/date combination.
- 422: Invalid parameter (e.g., wrong date format or unknown ISO2).
- 429: Rate limit exceeded. Implement client-side rate limiting and retries with jitter.
- 500: Server error. Retry with exponential backoff.
Units and timestamps recap:
- Yields: percentages (e.g., 4.52 means 4.52%).
- Spreads: basis points in spread_bps (e.g., 215 means 2.15%).
- Dates: YYYY-MM-DD, business-date based for daily endpoints.
- Timestamps: ISO-8601 UTC for intraday fetched_at and meta.timestamp fields when present.
Core fixed-income use cases for Chile yields
- Financial dashboards: render the CL curve and daily deltas using /curve and /fluctuation. Highlight inversion flags.
- Portfolio risk tools: inbox-check daily curve shifts and spread movements via /latest and /spread. Alert on threshold changes in bps.
- Economic research: pull long history for key tenors using /timeseries to study term premium, monetary cycles, and macro correlations.
- Trading utilities: monitor intraday 10Y with /intraday to capture event reactions and liquidity patterns.
To explore the full capabilities, visit bonds-api.com and the interactive MCP. When ready to integrate, Register for an API key and ship your pipeline.
Reference: common patterns for building the Chile curve
- Single-call curve: use /curve (fastest, with inverted flag).
- Selective maturities: use /latest with maturities for lightweight payloads.
- Historical reconstruction: call /curve with a date, or stitch /timeseries responses across desired maturities if you need fine-grained data handling.
- Spread ladders: loop maturities through /spread or compute post-hoc from two /curve calls.
In all cases, treat yields as floats in percent. Convert to bps when displaying spreads or small changes: delta_bps = 100 × (y_today − y_prev).
FAQ
How are yields scaled in the API?
All yields are returned as percentages (e.g., 4.52 means 4.52%). Only spreads are returned in basis points under spread_bps.
What date and time formats should I expect?
Daily endpoints use dates in YYYY-MM-DD. Intraday snapshots include fetched_at as ISO-8601 with a Z suffix for UTC. Any meta.timestamp values are also UTC.
How do I handle Chilean market holidays?
If you request a holiday date via /historical and no fixing exists, you may receive a 404. For continuous series, prefer /timeseries and rely on returned dates, or adjust to the previous business day.
Can I fetch the entire Chile curve at once?
Yes. Use /curve with country=CL. You can optionally pass date=YYYY-MM-DD for a historical curve. The response includes an inverted flag to quickly detect curve shape.
What’s the best way to compare Chile to the US?
Use /spread with country=CL, benchmark=US, and a maturity (default 10Y). The response provides spread_bps plus both country and benchmark yields.
Ready to integrate the Chile yield curve into your analytics? Generate your API key and make your first call in minutes: Register. You can also explore endpoints interactively in the MCP and learn more at bonds-api.com.