> For the complete documentation index, see [llms.txt](https://www.bluegamma.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.bluegamma.io/documentation/market-data-guides/bonds.md).

# Bonds

Sovereign yield curves, index-level credit spreads and a bond-by-bond screener, in one section.

BlueGamma covers bonds through three tools. They answer different questions, so which one you want depends on whether you are looking at a sovereign curve, a credit index, or an individual security.

***

### The Three Tools

| Tool                                                                                                        | What it gives you                                                                                                                                    |
| ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| [**Government Bonds**](https://www.bluegamma.io/documentation/market-data-guides/bonds/government-bonds.md) | Sovereign yield curves across 35 markets, spot and forward-starting                                                                                  |
| [**iBoxx Spreads**](https://www.bluegamma.io/documentation/market-data-guides/bonds/iboxx-spreads.md)       | Index-level yield, OAS and Z-spread across infrastructure, corporate, sovereign, covered and inflation-linked index families, current and historical |
| [**Bond Comps**](https://www.bluegamma.io/documentation/market-data-guides/bonds/bond-comps.md)             | A screener for individual bonds: yield, spread, rating, sector, tenor and amount outstanding, side by side                                           |

Each has its own page in this section, listed in the left-hand navigation under **Bonds**.

***

### Which One Do I Want?

| If you want to...                                         | Use                       |
| --------------------------------------------------------- | ------------------------- |
| Read the risk-free curve for a currency                   | Government Bonds          |
| Discount cashflows off a sovereign curve                  | Government Bonds          |
| Price a forward-starting sovereign exposure               | Government Bonds          |
| Find where a sector or rating band is trading as a spread | iBoxx Spreads             |
| Track how a credit spread has moved over time             | iBoxx Spreads             |
| Benchmark a specific issuer against comparable bonds      | Bond Comps                |
| Build a comparables table for a new issue                 | Bond Comps                |
| Look up one bond by ISIN                                  | The search bar, top right |

{% hint style="success" %}
**Know the ISIN?** Paste it into the **search bar at the top right** from anywhere in the app. Results are grouped by type and take you straight to the bond, sovereign or corporate.
{% endhint %}

***

### What They Share, and What They Don't

All three sit under **Bonds** in the left-hand navigation and export through **Download**.

The controls differ:

| Tool                 | Valuing at a past date                                                                                                        |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Government Bonds** | **Valuation Date** selector                                                                                                   |
| **Bond Comps**       | **Change date**, with **LIVE DATA** to return to the current market                                                           |
| **iBoxx Spreads**    | No past-date control. **Current Spreads** shows the latest values, and history is charted in the **Historical Spreads** panel |

***

### Where to Start

[**Accessing Bond Yields**](https://www.bluegamma.io/documentation/market-data-guides/bonds/accessing-bond-yields.md) walks through finding a yield in each of the three, and is the quickest way in if you are new to the section. Questions that apply across all three are answered in the [**FAQs**](https://www.bluegamma.io/documentation/market-data-guides/bonds/faqs.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.bluegamma.io/documentation/market-data-guides/bonds.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
