You need reliable, machine-readable access to the United Arab Emirates (AE) 10-year sovereign bond yield—and the surrounding curve and spreads—so you can power models, dashboards, and risk tools. By the end of this guide, you will be able to fetch the UAE 10Y yield, request historical and intraday data, build a full AE yield curve, compute spreads versus benchmarks, and integrate all of it into your applications using the Bonds API.
What the UAE 10Y yield represents and how this API expresses it
The “10Y” maturity refers to United Arab Emirates government bonds with a tenor of approximately ten years. The yield is expressed as a percentage (e.g., 4.52 means 4.52%). When the API returns spreads, spread_bps is in basis points (1 bp = 0.01%). Dates are provided as YYYY-MM-DD, and intraday timestamps are ISO 8601 with a trailing Z (UTC).
All endpoints discussed below are HTTP GET requests under the base URL https://bonds-api.com/api/v1/ and require authentication using the X-API-Key header. If you’re new to the service, see Register and explore the developer console at MCP. You can also visit the homepage at bonds-api.com for product context.
Authentication, allowed methods, and a note about a live sample
All Bonds API endpoints use GET and are authenticated via the X-API-Key header; do not send the API key as a query parameter. Below is a live sample block that must be shown verbatim—it demonstrates an error response shape and is intentionally using a query parameter:
curl -s "https://bonds-api.com/api/v1/latest?countries=AE&maturities=10Y&api_key=YOUR_API_KEY"
{
"success": false,
"error": "No data found for the specified parameters.",
"code": "not_found"
}
In your actual integrations, always pass your key in the X-API-Key request header as documented in each section below.
Endpoint: Latest — current yields for AE 10Y (and more)
Use /latest to retrieve the most recent available yields. You can specify one or more maturities. For yield-curve construction, request several tenors at once; for a focused 10Y lookup, pass maturities=10Y.
cURL (GET)
Python (requests)
import requests
resp = requests.get(
"https://bonds-api.com/api/v1/latest",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"countries": "AE", "maturities": "2Y,10Y"}
)
data = resp.json()
# data["data"]["AE"]["10Y"]["yield"] is the 10-year yield as a percentage
JavaScript (fetch)
const url = new URL("https://bonds-api.com/api/v1/latest");
url.searchParams.set("countries", "AE");
url.searchParams.set("maturities", "2Y,10Y");
fetch(url.toString(), {
method: "GET",
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(data => {
const tenY = data.data.AE["10Y"].yield; // percent
console.log("AE 10Y:", tenY);
});
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=AE&maturities=2Y,10Y";
$json = file_get_contents($url, false, $context);
$data = json_decode($json, true);
$ae10 = $data["data"]["AE"]["10Y"]["yield"]; // percentage
echo "AE 10Y: ".$ae10."\n";
Sample JSON response
How to read this:
- yield: percentage (4.52 means 4.52%).
- date: YYYY-MM-DD, the market date of the quote.
- source: a short label (e.g., “official”).
Endpoint: Historical — AE 10Y yield on a specific date
Use /historical to fetch the 10Y yield on a single date. This is useful for point-in-time backtests, end-of-month valuation snapshots, or event studies.
cURL (GET)
Python (requests)
import requests
params = {"country": "AE", "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 10Y yield for 2025-06-15 (percent)
JavaScript (fetch)
const hUrl = new URL("https://bonds-api.com/api/v1/historical");
hUrl.searchParams.set("country", "AE");
hUrl.searchParams.set("maturity", "10Y");
hUrl.searchParams.set("date", "2025-06-15");
fetch(hUrl.toString(), {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(data => {
console.log("AE 10Y on 2025-06-15:", data.yield);
});
PHP (file_get_contents)
<?php
$params = http_build_query([
"country" => "AE",
"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("https://bonds-api.com/api/v1/historical?$params", false, $ctx);
echo $json;
Sample JSON response
- yield: percentage at the given date.
- date: the requested calendar date (UTC). On non-business days, data may reflect the last available business day.
Endpoint: Time series — AE 10Y between two dates
Use /timeseries for continuous daily yields between start and end. This is the backbone for trend analysis, backtesting, and moving averages.
cURL (GET)
Python (requests)
import requests
params = {
"country": "AE",
"maturity": "10Y",
"start": "2025-11-05",
"end": "2026-11-05"
}
r = requests.get("https://bonds-api.com/api/v1/timeseries",
headers={"X-API-Key": "YOUR_API_KEY"},
params=params)
ts = r.json()
# ts["series"] is an array of { "date": "YYYY-MM-DD", "yield": number }
JavaScript (fetch)
const tsUrl = new URL("https://bonds-api.com/api/v1/timeseries");
tsUrl.searchParams.set("country", "AE");
tsUrl.searchParams.set("maturity", "10Y");
tsUrl.searchParams.set("start", "2025-11-05");
tsUrl.searchParams.set("end", "2026-11-05");
fetch(tsUrl.toString(), { headers: { "X-API-Key": "YOUR_API_KEY" } })
.then(r => r.json())
.then(ts => {
const first = ts.series[0]; // { date, yield }
console.log(first);
});
PHP (file_get_contents)
<?php
$q = http_build_query([
"country" => "AE",
"maturity" => "10Y",
"start" => "2025-11-05",
"end" => "2026-11-05"
]);
$ctx = stream_context_create(["http" => [
"method" => "GET",
"header" => "X-API-Key: YOUR_API_KEY\r\n"
]]);
$raw = file_get_contents("https://bonds-api.com/api/v1/timeseries?$q", false, $ctx);
echo $raw;
Sample JSON response
- series: ordered by date (business days). Each yield is a percentage for that day.
Endpoint: Spread — AE vs benchmark (e.g., US 10Y)
Use /spread to compute the yield spread in basis points for a given maturity (default is 10Y). This is commonly used to price relative value and to compare sovereign risk premia.
cURL (GET)
Python (requests)
import requests
p = {"country": "AE", "benchmark": "US", "maturity": "10Y"}
r = requests.get("https://bonds-api.com/api/v1/spread",
headers={"X-API-Key": "YOUR_API_KEY"},
params=p)
sp = r.json()
# sp["spread_bps"] is the spread in basis points (integer/number)
JavaScript (fetch)
const spUrl = new URL("https://bonds-api.com/api/v1/spread");
spUrl.searchParams.set("country", "AE");
spUrl.searchParams.set("benchmark", "US");
spUrl.searchParams.set("maturity", "10Y");
fetch(spUrl.toString(), { headers: { "X-API-Key": "YOUR_API_KEY" } })
.then(r => r.json())
.then(sp => {
console.log("Spread (bps):", sp.spread_bps);
});
PHP (file_get_contents)
<?php
$q = http_build_query(["country" => "AE", "benchmark" => "US", "maturity" => "10Y"]);
$ctx = stream_context_create(["http" => ["method" => "GET", "header" => "X-API-Key: YOUR_API_KEY\r\n"]]);
$raw = file_get_contents("https://bonds-api.com/api/v1/spread?$q", false, $ctx);
echo $raw;
Sample JSON response
- spread_bps: AE 10Y minus benchmark 10Y in basis points.
- country_yield, benchmark_yield: both in percent, same market date.
Endpoint: Curve — full AE yield curve for a day
Use /curve to retrieve multiple AE maturities for a single date (latest by default). This is optimal when you need a snapshot of the term structure, compute forward rates, or interpolate missing points.
cURL (GET)
Python (requests)
import requests
r = requests.get("https://bonds-api.com/api/v1/curve",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "AE"})
curve = r.json()
# curve["curve"] is a dict: maturity -> yield percent
JavaScript (fetch)
const cUrl = new URL("https://bonds-api.com/api/v1/curve");
cUrl.searchParams.set("country", "AE");
fetch(cUrl.toString(), { headers: { "X-API-Key": "YOUR_API_KEY" } })
.then(r => r.json())
.then(curve => {
console.log("AE curve date:", curve.date);
console.log("10Y yield:", curve.curve["10Y"]);
});
PHP (file_get_contents)
<?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=AE", false, $ctx);
$data = json_decode($json, true);
echo "Curve date: ".$data["date"]."\n";
echo "AE 10Y: ".$data["curve"]["10Y"]."%\n";
Sample JSON response
- curve: maturity (string) to yield (percent).
- inverted: boolean indicating a downward-sloping pattern between short and long tenors.
Endpoint: Intraday — AE 10Y snapshots during a day
Use /intraday for multiple 10Y snapshots throughout a given market date. This is vital for trading dashboards and high-frequency monitors.
cURL (GET)
Python (requests)
import requests
params = {"country": "AE", "maturity": "10Y", "date": "2026-11-05"}
r = requests.get("https://bonds-api.com/api/v1/intraday",
headers={"X-API-Key": "YOUR_API_KEY"},
params=params)
intraday = r.json()
# intraday["snapshots"] is a list with fetched_at in UTC (ISO 8601, 'Z')
JavaScript (fetch)
const iUrl = new URL("https://bonds-api.com/api/v1/intraday");
iUrl.searchParams.set("country", "AE");
iUrl.searchParams.set("maturity", "10Y");
iUrl.searchParams.set("date", "2026-11-05");
fetch(iUrl.toString(), { headers: { "X-API-Key": "YOUR_API_KEY" } })
.then(r => r.json())
.then(itd => {
itd.snapshots.forEach(s => console.log(s.fetched_at, s.yield));
});
PHP (file_get_contents)
<?php
$q = http_build_query(["country" => "AE", "maturity" => "10Y", "date" => "2026-11-05"]);
$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);
Sample JSON response
- yield: percentage at the snapshot time.
- fetched_at: UTC timestamp (ISO 8601, Z).
- count/meta: quick diagnostics; meta.timezone clarifies timestamps are UTC.
Endpoint: Fluctuation — AE 10Y change, min, max over a window
Use /fluctuation to get start and end yields, absolute change, and the period’s min/max. This is helpful for reporting, summaries, and guardrails in alerting systems.
cURL (GET)
Python (requests)
import requests
p = {"countries": "AE", "maturity": "10Y", "start": "2025-11-05", "end": "2026-11-05"}
r = requests.get("https://bonds-api.com/api/v1/fluctuation",
headers={"X-API-Key": "YOUR_API_KEY"},
params=p)
fl = r.json()
# fl["data"]["AE"] contains start_yield, end_yield, change, min, max (percent)
JavaScript (fetch)
const fUrl = new URL("https://bonds-api.com/api/v1/fluctuation");
fUrl.searchParams.set("countries", "AE");
fUrl.searchParams.set("maturity", "10Y");
fUrl.searchParams.set("start", "2025-11-05");
fUrl.searchParams.set("end", "2026-11-05");
fetch(fUrl.toString(), { headers: { "X-API-Key": "YOUR_API_KEY" } })
.then(r => r.json())
.then(fl => console.log(fl.data.AE));
PHP (file_get_contents)
<?php
$q = http_build_query([
"countries" => "AE",
"maturity" => "10Y",
"start" => "2025-11-05",
"end" => "2026-11-05"
]);
$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 response
- All values are percentages. change is absolute (end minus start), not basis points.
Maturities, yield-curve construction, business days, and caching
The AE curve endpoint shows common tenors including money-market points and long bonds. You can build a full curve in one call via /curve or by combining /latest across maturities. When markets are closed (weekends or UAE public holidays), latest often reflects the most recent business day with data.
| Maturity | Example value type | Use case |
|---|---|---|
| 1M | Percent | Short-term rate proxy, cash laddering |
| 3M | Percent | Money-market curve, liquidity metrics |
| 6M | Percent | Hedging short duration exposures |
| 1Y | Percent | T-bill carry analyses |
| 2Y | Percent | Policy expectations, DV01 hedges |
| 5Y | Percent | Benchmark mid-curve |
| 10Y | Percent | Macro barometer, discounting, relative value |
| 30Y | Percent | Long-duration liabilities and ALM |
Practical tips:
- Business days: Time series are populated on market business days. If you request a weekend or holiday with /historical, be prepared for a 404 if there is no observation on that exact date, or use /timeseries across a span that includes the prior business day.
- Update frequency: Latest data is refreshed as new observations become available. Intraday snapshots are in UTC; inspect meta.timezone to anchor timestamps.
- Caching: Cache /curve and /latest responses per country-date (and maturity set) to reduce latency. For /intraday, use short TTLs (e.g., a few minutes) during market hours and longer TTLs off-hours.
- Error handling: Check the success field. On errors, you will receive success=false and an error message. Common statuses include 401 (key), 403 (quota), 404 (no data), 422 (invalid params), 429 (rate limit), 500 (server).
Error shapes and defensive coding
All endpoints return a uniform error shape on failure:
- 401: Missing or invalid X-API-Key
- 403: Account quota exceeded
- 404: No data for the requested country/maturity/date combination
- 422: Invalid parameter (e.g., bad date format)
- 429: Rate limit exceeded
- 500: Server error
Pattern to handle errors gracefully:
- Check HTTP status code and success boolean.
- If not success, inspect error and optionally retry (with exponential backoff) for 429/500; fix inputs for 422/404; refresh credentials for 401.
- Normalize yields as decimals or percentages depending on your internal conventions; the API provides percentages.
Use cases: how AE 10Y powers your stack
- Financial dashboards: show cards for AE 10Y latest, d/d change from /fluctuation, sparkline from /timeseries, and intraday tape from /intraday.
- Portfolio risk: derive DV01 and PVBP using the /curve, interpolate missing tenors, and monitor spread vs US 10Y via /spread.
- Macro research: regress AE 10Y against drivers, compute rolling vol from /timeseries, and summarize monthly extremes with /fluctuation.
- Alerting: trigger notifications on intraday moves over X bps using /intraday snapshots or on close-to-close jumps using /latest and /fluctuation.
Explore more product context at bonds-api.com, or run queries interactively in the developer console at MCP.
Field reference recap for AE 10Y
- yield: percentage (e.g., 4.52 → 4.52%).
- date: YYYY-MM-DD, market date of the observation.
- fetched_at: ISO 8601 UTC timestamp for intraday snapshots.
- spread_bps: integer/number in basis points for spread responses.
- inverted: boolean indicating shape status for the curve.
- source: string identifying the data source category.
Complete endpoint index for AE 10Y
- /latest: snapshot yields by maturity; supports multiple maturities per call.
- /historical: yield for a specific date and maturity.
- /timeseries: daily yields for a date range.
- /spread: basis-point spread vs a benchmark country (default 10Y).
- /curve: full AE yield curve for a given date (latest by default).
- /intraday: multiple yield snapshots during a specific date.
- /fluctuation: start, end, change, min, max over a period.
FAQ
Q: Are yields returned as decimals or percentages?
A: Percentages. A value like 4.52 means 4.52%.
Q: What timezone are timestamps in?
A: Dates are calendar dates (YYYY-MM-DD). Intraday fetched_at timestamps are in UTC (Z). The intraday meta.timezone field confirms this.
Q: How do I handle weekends and holidays for AE?
A: Expect no new observations on non-business days. Use /timeseries for ranges or cache the most recent /latest or /curve result. If you need the last available business day when querying /historical, first look up the most recent business date via /timeseries.
Q: How can I compute the daily change for AE 10Y?
A: Use /fluctuation for start/end within a two-day window, or get two adjacent days via /timeseries and subtract yields. Remember both are in percent.
Q: How do I compare AE 10Y to US 10Y?
A: Call /spread with country=AE, benchmark=US, maturity=10Y. Read spread_bps for the difference in basis points and the component yields in percent.
Ship your integration quickly: grab an API key, run the examples above, and wire AE 10Y into your models and dashboards. Register now, try queries in the MCP, or Get started with Bonds API. For a quick link as well: Register for Bonds API.