> 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/pricers/calculating-a-swap-rate.md).

# Swap Pricer

Price an interest rate swap at the live mid, save it as a quote, mark it as traded once you have dealt, or book a swap you have already traded.

The **Swap Pricer** page is the home screen for both pricing and portfolio valuation. It has two cards:

* **Not traded**: quotes priced at the live mid that you have not yet dealt. This page covers this card.
* **Traded**: swaps you have executed, marked to market live. See [Swap Mark-to-Market](https://www.bluegamma.io/documentation/pricers/calculating-the-mtm-of-a-swap.md).

A swap starts in Not traded and moves to Traded when you mark it as dealt. A swap you have already dealt can go straight into Traded from the ticket (see **Status** below).

With no swaps yet, the page offers **Create Dummy Portfolio**: a sample entity with three traded swaps and one quote, priced on live curves, so you can try every control. When your first real swap arrives, a banner offers **Remove sample** or **Keep**.

<figure><img src="https://3184259219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmmQPefoflG1RwUnUKKBR%2Fuploads%2Fgit-blob-ba418f613cfc85217580772e3096a66bcccc1ba3%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

***

## 1. Price a Swap

Click **+ Price a Swap** in the top right. The pricer reprices as you edit, so the mid updates with every change.

<figure><img src="https://3184259219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmmQPefoflG1RwUnUKKBR%2Fuploads%2Fgit-blob-86a2c5a06736d3f1dc54fc2c2704cc3ad1c0b1a9%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

**Terms**

* **Floating Rate Index**: the currency and benchmark, for example GBP SONIA. Currency follows the index you pick, so there is no separate currency field.
* **Payment Frequency**: how often both legs pay (Monthly, Quarterly, Semi-annual or Annual).
* **Two payment frequencies**: tick it where the swap changes frequency part way through its life, for example monthly during construction, then semi-annual. Set the **Second Frequency** and the **Frequency Change Date**, when the swap switches to it.

**Dates**

* **Start Date**: this will correspond to the first drawdown date. A date in the past prices the quote as a historical swap.
* **First Interest Payment**: must be after the start date.
* **End Date**: this should correspond to the final repayment date of the debt.
* Use the tenor buttons (2Y, 5Y, 7Y, 10Y, 15Y, 20Y, 30Y) to set the end date from the start date in one click.

**Notionals**

Shows the number of periods and the frequency, for example 20 periods · 6M. Open it to set the notional for each period where the swap amortises. Paste a column from Excel instead of filling each row.

<figure><img src="https://3184259219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmmQPefoflG1RwUnUKKBR%2Fuploads%2Fgit-blob-8c1a3efcafe9bd2519f68e6ae9df70f8b0ef386f%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

**Status**

Leave **Traded** off while the swap is still a quote. The **Mid swap rate** shown is indicative and priced off the live mid. If you enter an **Execution spread** or **Credit spread** (see below), an **All-in · mid + Xbp spreads** line appears under it with your all-in rate. Loan margin is not part of the all-in.

If you have already dealt, turn **Traded** on to book the swap directly, without saving it as a quote first. Two fields replace the mid:

* **Fixed Rate**: the rate you dealt at, from your trade confirmation. Required. It is never prefilled, and the ticket shows how far it sits from mid.
* **Trade Date**: required. Accrual and MtM run from this date, not from today.

The swap saves straight into the **Traded** card, under **Unassigned** until you file it under an entity.

**Naming**

Give the swap a name so you can find it later. A default is suggested from the index and maturity, for example SONIA 10Y · Aug 2036.

**Day count (optional)**

The swap is priced on the index's standard day counts. If your trade was booked on a different basis, expand **More · day count, spreads (optional)** and pick the day count for each leg.

* **Fixed Leg Day Count** and **Floating Leg Day Count**: Act/360, Act/365F, 30/360 or 30E/360. The index's standard is marked **standard** in the list and stated under the dropdowns.
* On overnight indices (SONIA, SOFR, ESTR) the floating leg offers Act/360 and Act/365F only, as the rate accrues day by day.
* **Reset to standard** returns both legs to the index convention.

The mid reprices on the day counts you pick, the choice is saved with the swap, and the caption under the rate names both legs' day counts. A 30/360 fixed leg against an Act/360 standard can move a 1M EURIBOR mid by a few basis points, so match the basis in your confirmation before comparing quotes.

<figure><img src="https://3184259219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmmQPefoflG1RwUnUKKBR%2Fuploads%2Fgit-blob-290f0080895d1c4910b14d29a0d1539e33d84eff%2Fswap-pricer-day-count.png?alt=media" alt="The More section of the Price a swap ticket with a day count dropdown for each leg"><figcaption></figcaption></figure>

**Spreads (optional)**

Under the day count in the same **More** section. All spreads are in basis points.

* **Floating spread**: a term of the swap, the margin its floating leg pays over the index (150 = +1.50%), for example SONIA + 150bp. Leave it empty if the floating leg pays the flat index. It stays on the swap once traded, and it flows into the mid swap rate, the valuation and the forecast payments download.
* **Execution spread**, **Credit spread** and **Loan margin**: estimated or quoted spreads. Mid plus the execution and credit spreads is your all-in rate; the loan margin is kept for the full cost of the debt and is not part of the all-in. They only apply to quotes, so they are hidden once the swap is traded.

<figure><img src="https://3184259219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmmQPefoflG1RwUnUKKBR%2Fuploads%2Fgit-blob-1c76b0aa43b1ef6a902fc49b8ae31f6a1cab1fbf%2Fseptember-2026-my-swaps-floating-spread.png?alt=media" alt="The Price a swap ticket with More spreads open and the Floating spread field"><figcaption></figcaption></figure>

Click **Save Swap**. With **Traded** off, the quote is saved under **Not traded** and its own page opens (see below).

***

## 2. Review the Not Traded List

The default columns show the swap name, currency, notional, maturity, PV01 and the mid swap rate. Click **Columns** to choose which columns show, for example **Δ 1d**, **Δ 1w** and **Δ 1m** (the move in the mid), **All-in** or **Created by**.

<figure><img src="https://3184259219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmmQPefoflG1RwUnUKKBR%2Fuploads%2Fgit-blob-8098f12871072ec129c52b060bbc5677a4bf3d97%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### The Quote Page

Click a quote to open its own page. The headline is the **Mid Swap Rate**, with its move versus last week, above the quote's details. The header has:

* **Live**: the valuation-time pill. Click it to price the quote at a past date and time instead of live.
* **Curve shock**: shift the par curve by the basis points you enter and reprice the page.
* **Download Pricer**: export the quote's pricing to Excel, at the page's time and curve shock.
* The **⋯** menu: **Edit**, **Share**, **Duplicate**, **Mark as traded**, **Delete**, and **Generate termsheet** (see [RfP & Term Sheet Generator](https://www.bluegamma.io/documentation/pricers/calculating-a-swap-rate/rfp-and-term-sheet-generator.md)).

The tabs below give the detail:

* **Notional Profile**: the notional in each period, with a schedule chart. Click **Edit Notionals** to change it.
* **Historical Swap Rate**: the mid swap rate for the quote over a chosen period, excluding credit and execution spreads, with a download.
* **Forward Curve**: the projected floating rate on each payment date, excluding margins. **Download Curve** exports it for your model.
* **Swap Curve**: the swap curve for the quote's index.
* **MTM Forecast**: the projected MtM path with confidence bands. See [Forecast MtM](https://www.bluegamma.io/documentation/pricers/calculating-the-mtm-of-a-swap/forecast-mtm.md).

### Payment Dates and Holidays

Under the quote's details, **More · day count, lookback, payment dates** opens the conventions behind its schedule. Set them to match your bank confirmation:

* **Fixed Leg Day Count** and **Floating Leg Day Count**, and the **Lookback Days** on overnight indices.
* **Period dates on a holiday**: **Modified Following** (standard), **Following**, **Preceding** or **Unadjusted**.
* **Payment date**: **Period end** (standard), a **Set day of the month** such as the 25th, or a number of **Business days after period end**.
* **Holiday calendar**: the calendar the dates roll on. **View holidays** lists the next 12 months of holidays and what each one does to the swap.

The forecast and MtM follow these dates.

<figure><img src="https://3184259219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmmQPefoflG1RwUnUKKBR%2Fuploads%2Fgit-blob-1fad95abd0af086f19abbaf0c032ad5b24c175d0%2Fswap-pricer-payment-dates.png?alt=media" alt="A 20-year SONIA swap with the More panel open: day count on each leg, lookback, period dates on a holiday, payment date and the London holiday calendar"><figcaption></figcaption></figure>

***

## 3. Mark a Swap as Traded

Once you have executed, click **Mark as traded** next to the swap.

<figure><img src="https://3184259219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmmQPefoflG1RwUnUKKBR%2Fuploads%2Fgit-blob-c9b63c836b054e7a858e182cad2ae96bfa781dfc%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

The panel shows the swap's notional, frequency, start and end dates, and the mid right now, then asks for:

* **Traded rate** — the rate you dealt at, from your trade confirmation. Required.
* **Trade date** — the date you traded. Required.
* **Bank** — who you dealt with. Optional.
* **Entity** — where it files in your portfolio. Optional, and you can drag it to a different entity later.

Click **Mark as Traded**. The swap moves into the **Traded** card and is marked to market from your dealt rate.

{% hint style="info" %}
Recording the traded rate is what lets the platform show your mark-to-market. Until then the swap is valued at the live mid, which is a quote rather than your position. The live mid results in a zero mark-to-market.
{% endhint %}

***

## 4. Assign a Swap to an Entity

Swaps can be filed under an entity (a holding company, SPV or subsidiary) so your portfolio reflects your structure. The Traded card groups by entity only; the bank you dealt with is recorded on each swap, and you can search by it.

* Set the entity when you mark the swap as traded, or
* Drag the swap onto an entity in the **Traded** card at any time, or
* Drag a quote from **Not traded** onto an entity: the **Mark as Traded** panel opens for the traded rate, then the swap files there.

Swaps with no entity sit under **Unassigned**. Click **+ New entity** to add one. Click an entity's row to expand its swaps. To open the entity's own page, hover the row and choose **Open entity** from its **⋯** menu (see [Swap Mark-to-Market](https://www.bluegamma.io/documentation/pricers/calculating-the-mtm-of-a-swap.md)).

***

## Additional Features

* **Valuation time**: the **Live** pill in the header shows the data time and refreshes on a click. Click **Live** to price at a different point, or pick **End of month**, **End of quarter** or another quick pick, for example to value your book as at a month end. A banner shows the time every figure and export is struck at; **Back to live** returns you to live pricing.
* **Download**: each card has its own **Download** button, which exports that card to Excel.
* **Search**: find swaps by name, entity or bank from the search box in the header.
* **⋯ menu** (top right of the page):
  * **Reports**: month-end statements, accrued interest and payments. See [Reports](https://www.bluegamma.io/documentation/pricers/calculating-a-swap-rate/reports.md).
  * **Payments due**: what settles in the next **48h**, **7d**, **30d** or **90d**, each payment marked **Confirmed** or **Projected**, with a download.
  * **Shock curve**: shift the par curve by the basis points you enter and every value on the page reprices off the re-bootstrapped curve. It is a what-if: nothing saved changes.
* **Row ⋯ menu**: each swap's menu has **Open**, **Edit**, **Share**, **Duplicate** and **Delete**, plus **Mark as traded** on a quote. **Duplicate** saves a copy, for example to price a variant of a quote.

{% hint style="info" %}
Exports always use native values. Converted figures shown on screen are indicative and intended for portfolio survey only.
{% endhint %}

***

## Related

{% content-ref url="/pages/S7o7TlnhdPBHwXuqZUZs" %}
[Swap Mark-to-Market](https://www.bluegamma.io/documentation/pricers/calculating-the-mtm-of-a-swap.md)
{% endcontent-ref %}

{% content-ref url="/pages/yTCgRGyJsDdAtr2H3uf9" %}
[Cap Pricer](https://www.bluegamma.io/documentation/pricers/pricing-a-cap.md)
{% endcontent-ref %}

{% content-ref url="/pages/JS6n2Vxj2frLZwIkxVxq" %}
[Benchmarking a Swap Rate with a Bank](https://www.bluegamma.io/documentation/market-data-guides/swap-rates/advanced/benchmarking-a-swap-rate-with-a-bank.md)
{% endcontent-ref %}

{% content-ref url="/pages/hDtgsAkZKGcydP8QYLpx" %}
[How to Price a Swap in Excel Using BlueGamma's Add-in](https://www.bluegamma.io/documentation/integrations/excel-add-in/how-to-guides/how-to-price-a-swap-in-excel-using-bluegammas-add-in.md)
{% endcontent-ref %}


---

# 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/pricers/calculating-a-swap-rate.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.
