Government Bonds API

← All financial data endpoints

Why Use FinanceFlowAPI’s Government Bonds API?

Tracking sovereign bond yields usually means integrating a different central bank, treasury or exchange feed for every country you cover, each with its own maturities and format. The Government Bonds API normalizes 54 countries and every maturity they publish into one schema and one authentication method, so you can add a new market to your product without a new integration.

• One JSON schema for every country and maturity, so there’s no per-source parsing to maintain.
• 54 countries verified live against production, from the U.S. and UK to emerging markets.
• Spot yields, historical time series and daily OHLC candles all under one API.
• Same account, API key and billing as the rest of FinanceFlowAPI (Commodities, Currency, Economic Calendar and Economic Indicators data).

Key Capabilities

• Spot yield by country or region: bonds-spot returns the current yield plus daily, weekly, monthly and yearly change for one country, or every country in a region in one call.
• Multiple maturities per country: from short-term bills (1m, 3m, 6m) to long bonds (20y, 30y); exact availability varies by country.
• Historical time series: bonds-history returns date/yield pairs over a range, with daily or monthly granularity.
• Daily OHLC candles: bonds-history-candles returns open/high/low/close yield data per day, for charting libraries.
• Built-in discovery: bonds-catalog lists every country and the exact maturities available for it.

Data Coverage & Trust

Data Methodology

Government Bonds API data is aggregated from market data sources and normalized, for every supported country, into one consistent schema: country, maturity type, yield, and (for spot) period-over-period change. Sourced from aggregated third-party market and statistical data providers; the specific vendor and full per-country methodology are not published.

Live API Playground Coming Soon

An interactive API Playground for this endpoint is planned. Until it ships, use the request and response examples below, or your own HTTP client, to try the API live with your key.

Request Example

GET https://financeflowapi.com/api/v1/bonds-spot?api_key=YOUR_API_KEY&country=United_States&type=10y

Response Example

{
  "success": true,
  "code": 200,
  "message": "OK",
  "meta": {
    "timestamp": 1787481854,
    "request_id": "6a8acefe7bf4e"
  },
  "data": [
    {
      "bond_country": "united states",
      "bond_yield": 4.736,
      "bond_type": "10Y",
      "daily_bond_change": "0.0300",
      "weekly_bond_change_percent": "0.04%",
      "monthly_bond_change_percent": "0.07%",
      "yearly_bond_change_percent": "0.47%",
      "last_updated": "2026-08-21"
    }
  ]
}

API Parameters

bonds-spot: current yield for a country or region.

bonds-history: historical yield time series.

bonds-history-candles: historical daily OHLC candles.

bonds-catalog: discover available countries and maturities.

Response Schema

bonds-spot: each item in data.

bonds-history: each item in data.

bonds-history-candles: each item in data.

bonds-catalog: each item in data.

HTTP Status & Errors

Code Examples

curl "https://financeflowapi.com/api/v1/bonds-spot?api_key=YOUR_API_KEY&country=United_States&type=10y"

import requests

url = "https://financeflowapi.com/api/v1/bonds-spot"
params = {
    "api_key": "YOUR_API_KEY",
    "country": "United_States",
    "type": "10y"
}

response = requests.get(url, params=params)
data = response.json()
print(data)

const params = new URLSearchParams({
  api_key: "YOUR_API_KEY",
  country: "United_States",
  type: "10y"
});

fetch(`https://financeflowapi.com/api/v1/bonds-spot?${params}`)
  .then(res => res.json())
  .then(data => console.log(data));

<?php
$params = http_build_query([
    'api_key' => 'YOUR_API_KEY',
    'country' => 'United_States',
    'type'    => '10y',
]);

$response = file_get_contents("https://financeflowapi.com/api/v1/bonds-spot?{$params}");
$data = json_decode($response, true);

print_r($data);

package main

import (
    "encoding/json"
    "fmt"
    "io"
    "net/http"
    "net/url"
)

func main() {
    params := url.Values{}
    params.Add("api_key", "YOUR_API_KEY")
    params.Add("country", "United_States")
    params.Add("type", "10y")

    resp, err := http.Get("https://financeflowapi.com/api/v1/bonds-spot?" + params.Encode())
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)

    var data map[string]interface{}
    json.Unmarshal(body, &data)

    fmt.Println(data)
}

Use Cases

• Portfolio & risk dashboards. Track yields across countries and maturities alongside Commodity Price API and equities data.
• Yield curve & charting tools. Build yield curve visualizations from bonds-spot across maturities, or candlestick charts from bonds-history-candles.
• Economic research. Correlate bond yields with Economic Indicators API data and Economic Calendar API releases.
• Trading platforms. Integrate live sovereign yield data into fixed-income trading applications.

Who Is This API For?

• Fixed-income traders and analysts tracking sovereign yields across markets
• Fintech dashboards blending bond yields with equity or FX data through the same api_key, without needing a second integration for a second data type
• Economic researchers studying how yields react around scheduled macro events
• Developers building yield curve or candlestick charting tools

Limitations

• Historical range is capped at 100 days between date_from and date_to, on both bonds-history and bonds-history-candles; future dates are rejected on both.
• date_from and date_to must be provided together on the history endpoints. Passing only one returns a 400 error.
• Available maturities vary by country; not every country publishes every maturity from 1-month to 30-year. Check bonds-catalog before querying.
• Endpoint access and your per-minute rate limit depend on your subscription plan.

Related APIs

• Economic Calendar API: see how bond yields react around scheduled economic events.
• Economic Indicators API: see how bond yields relate to GDP, inflation and interest rate data.

Full API documentation →