> 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/bond-comps.md).

# Bond Comps

Screen and compare individual bonds by yield, spread, rating, sector and tenor, and build a comparables table you can export.

Bond Comps is a screener for individual securities. Use it to benchmark an issuer against comparable bonds, look a bond up by ISIN, or assemble a comparables table for a new issue.

For index-level spreads rather than single bonds, use [iBoxx Spreads](https://www.bluegamma.io/documentation/market-data-guides/bonds/iboxx-spreads.md).

***

### 1. Open Bond Comps

From the left-hand navigation, click **Bonds** and then [**Bond Comps**](https://app.bluegamma.io/bonds/bond-comps).

<figure><img src="https://3184259219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmmQPefoflG1RwUnUKKBR%2Fuploads%2Fgit-blob-82b5caf17fc99fcbaf553ccfa9469000a10ed215%2Fbonds-bond-comps.png?alt=media" alt="Bond Comps on the All Bonds tab, showing the filter row and the bond table"><figcaption></figcaption></figure>

***

### 2. All Bonds and Saved Bonds

Two tabs sit at the top of the table.

* **All Bonds** is the full searchable universe.
* **Saved Bonds** is the set you have picked out, so a comparables group you build once is there next time. Pick between saved lists using the list selector beside the tabs.

Use the search box to find a bond by ISIN, bond name or issuer, and the add button to put it into your saved set. The edit, delete and share controls beside it manage the saved group.

***

### 3. Narrow the Universe

Filters run across the top of the table: **Country**, **Sector**, **Currency**, **Ratings**, **Security**, **Issuer Type** and **Advanced Filters**.

**Issuer Type** restricts the table to one class of issuer:

| Issuer Type   | What it covers                                       |
| ------------- | ---------------------------------------------------- |
| **Corporate** | Bonds issued by companies                            |
| **Municipal** | Bonds issued by local and regional government bodies |
| **Sovereign** | Bonds issued by national governments                 |

The **Include matured** toggle brings bonds that have already redeemed into the table, which is useful when you need a historical comparables set rather than a live one.

***

### 4. Read the Table

| Column                   | What it shows                                 |
| ------------------------ | --------------------------------------------- |
| **Issuer**               | The issuing entity                            |
| **ISIN**                 | The security identifier                       |
| **Bond**                 | The bond's name, carrying coupon and maturity |
| **Currency**             | Denomination                                  |
| **Price**                | Indicative price                              |
| **Yield (YTM)**          | Yield to maturity                             |
| **Spread (bp)**          | Spread over the reference curve               |
| **Remaining Tenor**      | Time left to maturity                         |
| **Trade Date**           | Date of the price shown                       |
| **Sector**               | Issuer sector                                 |
| **Rating**               | Credit rating                                 |
| **Country of Issue**     | Jurisdiction                                  |
| **Security Status**      | Ranking, for example senior or subordinated   |
| **Amount Outstanding**   | Size of the issue                             |
| **Previous Closing +/-** | Move against the prior close                  |
| **1 Week +/-**           | Move over the past week                       |

Every column sorts. Use the page-size selector at the bottom to show more rows at a time.

***

### 5. Value at a Past Date

**Change date** in the top right prices the whole table as at a past date rather than live. **LIVE DATA** returns it to the current market.

***

### 6. Download

**Download** exports the table as you have filtered and sorted it, ready for a comparables page or a pricing memo.

***

### 7. Request a Bond

If a bond you need is not in the universe, click **Request a bond** and submit the ISIN with an optional note. The request goes straight to our support team, who will add it and come back to you.

***

### Related

[iBoxx Spreads](https://www.bluegamma.io/documentation/market-data-guides/bonds/iboxx-spreads.md)

[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/bond-comps.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.
