Historical India Bond Yields

Historical India Bond Yields

Analysts and developers working with India’s sovereign curve often struggle to source clean historical yields, align maturities across instruments, and compute spreads or intraday snapshots inside their own systems. By the end of this article, you will be able to pull historical India government bond yields, build yield curves, compute changes over custom windows, and stream intraday snapshots using the Bonds API REST interface.

What India sovereign bond yields represent and why they matter

India’s sovereign fixed-income market spans short-term Treasury bills (1M–1Y) through long-dated government securities (2Y–30Y+). Yields reflect the market-implied cost of funding for the Government of India at each tenor, typically quoted in percentage points (for example, 4.52 means 4.52%). Analysts use these data to:

Illustration: Historical India Bond Yields
  • Construct yield curves to price cash flows and assess curve shape (steepness, inversion).
  • Measure duration exposure and scenario-test portfolios.
  • Track macro trends through level, slope, and curvature factors.
  • Benchmark spreads versus US Treasuries or other G10/EM government bonds.

All requests in this guide use Bonds API endpoints under https://bonds-api.com/api/v1/ and return JSON payloads designed for programmatic use. If you do not yet have credentials, visit Register to obtain an API key. You can also browse capabilities at MCP and the homepage at https://bonds-api.com.

Authentication, HTTP method, units, and dates

Bonds API is a straightforward REST service:

  • Authentication: pass your key in the X-API-Key header. Example: X-API-Key: YOUR_API_KEY
  • HTTP method: GET for all endpoints. No POST/PUT/DELETE.
  • Units: yields are expressed in percentage points (e.g., 4.52 means 4.52%). Spreads are in basis points (1 bps = 0.01%).
  • Dates: daily fields use YYYY-MM-DD. Intraday timestamps are ISO 8601 in UTC.

India’s market operates on Indian banking business days. For holidays and weekends, the latest available business day is returned for “latest” and for “curve” if no date is specified. Consider caching daily responses and invalidating after the India trading session ends to reduce redundant calls.

Latest yields for India

Use this to pull current (most recent business day) yields for one or more India maturities. The endpoint can return multiple maturities at once, which is convenient for building mini-curves or dashboards.

Endpoint

GET /api/v1/latest

  • Required: countries (ISO2, comma-separated). For India: IN
  • Optional: maturities (comma-separated, e.g., 2Y,10Y). If omitted, all available maturities are returned.

cURL

curl -s "https://bonds-api.com/api/v1/latest?countries=US&maturities=10Y&api_key=YOUR_API_KEY"

Python (requests)

import requests

url = "https://bonds-api.com/api/v1/latest"
headers = {"X-API-Key": "YOUR_API_KEY"}
params = {"countries": "IN", "maturities": "2Y,10Y"}

r = requests.get(url, headers=headers, params=params, timeout=10)
r.raise_for_status()
data = r.json()

# Access India 2Y and 10Y latest yields
in_2y = data["data"]["IN"]["2Y"]["yield"]
in_2y_date = data["data"]["IN"]["2Y"]["date"]
in_10y = data["data"]["IN"]["10Y"]["yield"]
in_10y_date = data["data"]["IN"]["10Y"]["date"]
print(in_2y, in_2y_date, in_10y, in_10y_date)

JavaScript (fetch)

const url = "https://bonds-api.com/api/v1/latest?countries=IN&maturities=2Y,10Y";
fetch(url, {
method: "GET",
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then((res) => res.json())
.then((data) => {
const in2Y = data.data.IN["2Y"];
const in10Y = data.data.IN["10Y"];
console.log("IN 2Y", in2Y.yield, "on", in2Y.date);
console.log("IN 10Y", in10Y.yield, "on", in10Y.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=IN&maturities=2Y,10Y";
$json = file_get_contents($url, false, $context);
$data = json_decode($json, true);
echo $data["data"]["IN"]["10Y"]["yield"];
?>

Sample JSON response

{
    "success": true,
    "date": "2026-11-20",
    "rates": {
        "US_10Y": 4.92
    },
    "dates": {
        "US_10Y": "2026-11-20"
    },
    "currencies": {
        "US_10Y": "USD"
    },
    "meta": {
        "request_id": "a8eaebf8-bdc1-44a7-af70-8087ea9c7f1f",
        "timestamp": "2026-11-22T00:04:05+00:00"
    }
}

How to read it: yields are percentages; date is the business date; source indicates provenance. Many dashboards only need the “yield” and “date.”

Yield on a specific historical date

Pull the yield for a single country and maturity on a specified day. This is perfect for backtesting or valuation cutoffs.

Endpoint

GET /api/v1/historical

  • Required: country=IN, maturity (e.g., 10Y), date (YYYY-MM-DD)

cURL

Python

import requests

r = requests.get(
"https://bonds-api.com/api/v1/historical",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "IN", "maturity": "10Y", "date": "2025-06-15"},
timeout=10
)
r.raise_for_status()
data = r.json()
print(data["yield"], data["date"])

JavaScript

const params = new URLSearchParams({
country: "IN",
maturity: "10Y",
date: "2025-06-15"
});

fetch("https://bonds-api.com/api/v1/historical?" + params.toString(), {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then((res) => res.json())
.then((data) => console.log(data.yield, data.date));

PHP (Guzzle)

<?php
require "vendor/autoload.php";
use GuzzleHttp\Client;

$client = new Client([
"base_uri" => "https://bonds-api.com/api/v1/",
"headers" => ["X-API-Key" => "YOUR_API_KEY"]
]);

$res = $client->get("historical", [
"query" => ["country" => "IN", "maturity" => "10Y", "date" => "2025-06-15"]
]);

$data = json_decode($res->getBody(), true);
echo $data["yield"];
?>

Sample JSON response

Interpretation: the 10Y India government bond yield on 2025-06-15 was 4.38% (percentage points). The date string is YYYY-MM-DD.

Historical time series (range)

Build time series for backtesting or charting. The series returns only available business days between start and end.

Endpoint

GET /api/v1/timeseries

  • Required: country=IN, maturity, start, end (YYYY-MM-DD, end ≥ start)

cURL

Python

import requests

r = requests.get(
"https://bonds-api.com/api/v1/timeseries",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "IN", "maturity": "10Y", "start": "2025-11-22", "end": "2026-11-22"},
timeout=15
)
series = r.json()["series"]
# Example: compute average yield over the window
avg = sum(pt["yield"] for pt in series) / len(series)
print("Avg 10Y:", round(avg, 4))

JavaScript

const p = new URLSearchParams({
country: "IN",
maturity: "10Y",
start: "2025-11-22",
end: "2026-11-22"
});

fetch("https://bonds-api.com/api/v1/timeseries?" + p.toString(), {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then((res) => res.json())
.then((data) => {
console.log("Points:", data.series.length);
console.log("First:", data.series[0]);
});

PHP (file_get_contents)

<?php
$params = http_build_query([
"country" => "IN",
"maturity" => "10Y",
"start" => "2025-11-22",
"end" => "2026-11-22"
]);
$context = stream_context_create(["http" => ["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);
echo count($data["series"]);
?>

Sample JSON response

Each item has date (YYYY-MM-DD) and yield as a percentage value. Your application can compute rolling averages, volatilities, or regressions from this series.

Spread versus benchmark

Calculate India’s yield spread versus a benchmark country at a given maturity. The default maturity is 10Y if omitted.

Endpoint

GET /api/v1/spread

  • Required: country=IN, benchmark (ISO2, e.g., US or DE)
  • Optional: maturity (e.g., 10Y)

cURL

Python

import requests
r = requests.get(
"https://bonds-api.com/api/v1/spread",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "IN", "benchmark": "US", "maturity": "10Y"},
timeout=10
)
spread = r.json()
print(spread["spread_bps"], spread["country_yield"], spread["benchmark_yield"])

JavaScript

const p = new URLSearchParams({ country: "IN", benchmark: "US", maturity: "10Y" });
fetch("https://bonds-api.com/api/v1/spread?" + p.toString(), {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then((r) => r.json())
.then((d) => console.log(`Spread ${d.spread_bps} bps; IN ${d.country_yield} vs US ${d.benchmark_yield}`));

PHP (Guzzle)

<?php
require "vendor/autoload.php";
$client = new \GuzzleHttp\Client([
"base_uri" => "https://bonds-api.com/api/v1/",
"headers" => ["X-API-Key" => "YOUR_API_KEY"]
]);
$res = $client->get("spread", ["query" => ["country" => "IN", "benchmark" => "US", "maturity" => "10Y"]]);
$d = json_decode($res->getBody(), true);
echo $d["spread_bps"];
?>

Sample JSON response

Interpretation: spread_bps is in basis points. A positive value means India’s 10Y is above the US 10Y by that many bps. The yields are in percentage points.

Full India yield curve

Get the complete set of available India maturities for a specific date or for the latest trading day. Use this to bootstrap discount curves, compute slopes (2s10s, 5s30s), or visualize curve shape.

Endpoint

GET /api/v1/curve

  • Required: country=IN
  • Optional: date (YYYY-MM-DD). If omitted, uses the latest day with data.

cURL

Python

import requests
r = requests.get(
"https://bonds-api.com/api/v1/curve",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "IN"},
timeout=10
)
curve = r.json()
tenors = list(curve["curve"].keys())
vals = list(curve["curve"].values())
print("Tenors:", tenors)
print("Inverted:", curve["inverted"])

JavaScript

fetch("https://bonds-api.com/api/v1/curve?country=IN", {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then((r) => r.json())
.then((d) => {
console.log("Date:", d.date, "Inverted:", d.inverted);
console.log("10Y:", d.curve["10Y"]);
});

PHP (file_get_contents)

<?php
$ctx = stream_context_create(["http" => ["header" => "X-API-Key: YOUR_API_KEY\r\n"]]);
$json = file_get_contents("https://bonds-api.com/api/v1/curve?country=IN", false, $ctx);
$data = json_decode($json, true);
echo $data["curve"]["10Y"];
?>

Sample JSON response

Interpretation: inverted indicates if the curve is recognized as inverted based on internal rules. The curve object maps maturity codes to yields (percentages).

Intraday India yield snapshots

For higher-frequency applications, intraday snapshots expose yields across timestamps within a single UTC day. This is useful for tracking announcements or auction-day dynamics.

Endpoint

GET /api/v1/intraday

  • Required: country=IN, maturity, date (YYYY-MM-DD)

cURL

Python

import requests, datetime as dt

r = requests.get(
"https://bonds-api.com/api/v1/intraday",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "IN", "maturity": "10Y", "date": "2026-11-22"},
timeout=15
)
d = r.json()
# Parse ISO timestamps in UTC
times = [pt["fetched_at"] for pt in d["snapshots"]]
print("Count:", d["count"], "First timestamp:", times[0])

JavaScript

const p = new URLSearchParams({ country: "IN", maturity: "10Y", date: "2026-11-22" });
fetch("https://bonds-api.com/api/v1/intraday?" + p.toString(), {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then((r) => r.json())
.then((d) => {
console.log("Snapshots:", d.count, "Timezone:", d.meta.timezone);
d.snapshots.forEach(s => console.log(s.fetched_at, s.yield));
});

PHP (Guzzle)

<?php
require "vendor/autoload.php";
$client = new \GuzzleHttp\Client([
"base_uri" => "https://bonds-api.com/api/v1/",
"headers" => ["X-API-Key" => "YOUR_API_KEY"]
]);
$res = $client->get("intraday", ["query" => ["country" => "IN", "maturity" => "10Y", "date" => "2026-11-22"]]);
$data = json_decode($res->getBody(), true);
echo $data["count"];
?>

Sample JSON response

Interpretation: fetched_at is an ISO 8601 UTC timestamp. yields are percentages. Intraday snapshots are suitable for minute/hour bars in your analytics tool; consider interpolating between points if needed.

Fluctuation over a period (change, min, max)

Get point-to-point change, and observed min/max yields across a period. This is fast for performance dashboards and alerting.

Endpoint

GET /api/v1/fluctuation

  • Required: countries (comma-separated, e.g., IN), maturity, start, end

cURL

Python

import requests
r = requests.get(
"https://bonds-api.com/api/v1/fluctuation",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"countries": "IN", "maturity": "10Y", "start": "2025-11-22", "end": "2026-11-22"},
timeout=10
)
f = r.json()["data"]["IN"]
print("Change:", f["change"], "Min:", f["min"], "Max:", f["max"])

JavaScript

const p = new URLSearchParams({
countries: "IN",
maturity: "10Y",
start: "2025-11-22",
end: "2026-11-22"
});
fetch("https://bonds-api.com/api/v1/fluctuation?" + p.toString(), {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then((r) => r.json())
.then((d) => console.log(d.data.IN));

PHP (file_get_contents)

<?php
$params = http_build_query([
"countries" => "IN",
"maturity" => "10Y",
"start" => "2025-11-22",
"end" => "2026-11-22"
]);
$ctx = stream_context_create(["http" => ["header" => "X-API-Key: YOUR_API_KEY\r\n"]]);
$json = file_get_contents("https://bonds-api.com/api/v1/fluctuation?$params", false, $ctx);
$data = json_decode($json, true);
print_r($data["data"]["IN"]);
?>

Sample JSON response

Interpretation: change is end_yield - start_yield in percentage points; min and max are the observed extremes over the window.

Error handling and reliability

All endpoints return a JSON error shape when something goes wrong:

  • 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., date format not YYYY-MM-DD or unknown ISO2 code).
  • 429: Rate limit exceeded. Cache results and backoff on retries.
  • 500: Server error. Implement retries with jitter.

To improve resiliency, add short-lived caches for daily endpoints, use conditional retries (e.g., 429 and 500), and validate parameters before requests.

How to assemble an India yield curve and compute spreads

If you prefer to build a curve manually instead of calling /curve, you can call /latest with several maturities at once (e.g., 1M,3M,6M,1Y,2Y,5Y,10Y,30Y). This is helpful for keeping a single call per refresh in a dashboard. For spreads, combine /latest for India and the benchmark, or use /spread for a direct read in basis points.

When comparing maturities across systems, ensure consistent maturity codes. Use spreads in basis points for risk dashboards and percentage yields for valuation inputs. For time-dependent models, align business days between countries (for example, India vs. US holidays) and fill missing values with last-known or forward-filled data as your methodology dictates.

Official live sample blocks

The following two blocks are provided as official samples and should be copied verbatim if you need a quick smoke test. They demonstrate a latest-yield call pattern with parameters as shown.

Official cURL sample

Official JSON sample

Note: fields like rates and dates map symbols to values and dates. The timestamp is ISO 8601 in UTC.

Real-world use cases and implementation notes

  • Portfolio risk tooling: Pull /curve to compute key rate durations, then use /fluctuation to set scenario bounds.
  • Economic dashboards: Use /timeseries for trend charts and /spread to monitor India vs. US 10Y in basis points.
  • Trading monitors: Subscribe to /intraday for the 10Y to observe reactions to RBI policy and macro prints.
  • Backtesting: Combine /historical and /timeseries to build factor models and hedging rules.

Performance tips:

  • Cache /latest and /curve once per business day or after known update intervals.
  • Normalize date handling by storing all dates in UTC and localizing for display as needed.
  • On holidays or early closes in India, expect stable values until the next business day.

Explore more capabilities on bonds-api.com and the method catalog at MCP.

End-to-end example: Build an India 2s10s curve slope

Steps

  1. Call /api/v1/latest with IN and maturities=2Y,10Y.
  2. Parse yields as percentages y2 and y10.
  3. Compute slope = y10 - y2 (percentage points). For visualization, multiply by 100 to show in basis points.
  4. Optionally, store slopes over time by calling /timeseries for 2Y and 10Y separately and differencing per date.

This approach supports both real-time dashboards (using /latest) and historical slope charts (using /timeseries).

Complete endpoint reference summary

  • /api/v1/latest: latest yields for specified countries and maturities; yields in percentages; date YYYY-MM-DD.
  • /api/v1/historical: single date yield for one country/maturity.
  • /api/v1/timeseries: daily series between start and end dates.
  • /api/v1/spread: spread in basis points vs benchmark; returns both country and benchmark yields.
  • /api/v1/curve: full curve for a country; inverted flag for curve shape checks.
  • /api/v1/intraday: multiple snapshots with ISO UTC timestamps; yields in percentages.
  • /api/v1/fluctuation: start, end, change, min, max over a specified period.

FAQ

How are yields expressed?
All yields are in percentage points (e.g., 4.52 means 4.52%). Spreads from /spread are in basis points.

What timezone are timestamps in?
Daily dates use YYYY-MM-DD without timezone. Intraday fetched_at timestamps are ISO 8601 in UTC. Align with your application’s timezone on display.

What happens on India market holidays?
“Latest” and “curve” return the most recent business day with data. For ranges, only business days with observations appear. Consider last-known-value fills per your methodology.

Do I need multiple requests to build a mini-curve?
No. Use /latest with maturities like 1M,3M,6M,1Y,2Y,5Y,10Y,30Y in one call, or call /curve for the full set on a given date.

How should I handle rate limits or transient errors?
Implement caching for daily endpoints, retry with exponential backoff on 429 and 500, and validate inputs to avoid 422 errors.

Ready to integrate India sovereign yields into your tools? Get an API key and start building with the endpoints above: Get started with Bonds API. Explore the product at bonds-api.com and browse available methods on Bonds API MCP.

Start building with bond data today

Get your API key and access sovereign bond yields across 60+ countries. 7-day free trial, no credit card required.

Related posts

All posts →