> 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-the-mtm-of-a-swap.md).

# Swap Mark-to-Market

Value a traded swap at the live mid, see clean and dirty MtM, accrued interest and the replacement rate, stress the curve, and see an entity's combined valuation.

The Mark-to-Market (MtM) value of a swap is the net present value of its remaining cashflows at prevailing market rates. Open any swap in the **Traded** card on the **Swap Pricer** page to see its valuation page.

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

***

## The Headline MtM

The large figure at the top is the **dirty** MtM — the full value of the swap including interest accrued since the last payment date. It is stated in the swap's own currency, with the change versus last week underneath and the valuation timestamp on the right.

Use the copy and Excel icons next to the figure to take the value straight into a model.

***

## Valuation Outputs

| Field                 | What it means                                                                                                                            |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Fixed Rate**        | The rate you dealt at, from your trade confirmation, which is typically the mid rate agreed with the bank + credit and execution charges |
| **Replacement Rate**  | The current on-market / at-the-money rate for the same trade                                                                             |
| **PV01**              | Change in value for a one basis point move in the curve                                                                                  |
| **Weighted Avg Life** | Average time to repayment, weighted by notional outstanding                                                                              |
| **Clean MtM**         | Value excluding accrued interest                                                                                                         |
| **Accrued Interest**  | Interest built up since the last payment date, not yet paid                                                                              |

### Replacement Rate

The replacement rate is the **at-the-money rate** — the fixed rate at which the same swap, traded today, would have zero net present value. It is the on-market level for your remaining profile.

Comparing it against your fixed rate tells you immediately why the swap is in the money or out of it. A swap dealt at 4.48% against a replacement rate of 4.46% is slightly out of the money as a fixed-rate payer: you are paying above the current market level.

### Clean MtM and Accrued Interest

**Clean MtM** strips out interest that has accrued but not yet been paid, leaving only the value of future cashflows. It is the figure most commonly used for hedge accounting and for comparing valuations across dates, because it is not distorted by where you sit in the payment period.

The two combine into the headline figure:

$$
\text{Dirty MtM} = \text{Clean MtM} + \text{Accrued Interest}
$$

Accrued interest resets to zero on each payment date and builds up again through the period, so a clean-versus-dirty gap that widens through a period and drops at payment is expected behaviour, not a data issue.

For the full treatment, see [Swap Mark-to-Market & Accrued Interest](https://www.bluegamma.io/documentation/methodology/swap-mark-to-market.md).

***

## Trade Details

The details panel under the headline holds the terms of the trade: bank, reference, trade date, start and end dates, first interest payment date, swap frequency, index, swap type (**Paying Fixed** or **Paying Float**) and fixed rate, alongside the valuation outputs above. Fields with a pencil icon can be edited if something was entered incorrectly. If the swap is filed under an entity, the **Entity** row links to the entity's page.

### Lookback Days

{% hint style="warning" %}
**Set this to match your confirmation.** Compounded RFR swaps almost always apply a lookback, and leaving it at 0 when the trade uses one will put the floating leg out of line with the bank's valuation.
{% endhint %}

A lookback shifts the observation period for the floating rate back by a set number of business days, so the payment amount is known before it falls due. For SONIA, a lookback of **5 business days** is common, and **2 business days** is also used. The convention is set out in your trade confirmation or loan agreement.

Enter the number of days in **Lookback Days** and the floating leg, forecast payments and MtM all reprice accordingly. The row shows for overnight (OIS) indices only.

### Floating Spread

If the swap's floating leg pays a margin over the index, for example SONIA + 150bp, record it as a term of the trade. Open the **⋯** menu, click **Edit**, expand **More · spreads (optional)** and enter the **Floating spread** in basis points (150 = +1.50%). The floating leg, forecast payments and MtM all include it. Leave it empty if the floating leg pays the flat index.

***

## Tabs

### Notional Profile

The notional outstanding in each period, as a table and a schedule chart. Click **Edit Notionals** to amend an amortising profile.

### Forecast Payments

Projected floating, fixed and net payments for every remaining period, with the next payment flagged. Toggle to **Graph**, or **Download** the schedule.

The **Floating Rate** column is the all-in floating rate for each period, including any floating spread on top of the index. The download carries the same rate.

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

### Swap Curve

The underlying swap curve used to value the trade.

### MTM Forecast

Projects the range of possible future MtM values using confidence bands. Adjust the intervals, switch between implied and historical volatility, and toggle to a table view. See [Forecast MtM.](https://www.bluegamma.io/documentation/pricers/calculating-the-mtm-of-a-swap/forecast-mtm.md)

### MTM Historical

This chart shows the historical Mark-to-Market values for this swap over the past 12 months.

### Floating Rates

The historical and projected floating rates for the swap, plotted against your fixed rate.

***

## Curve Shock

Enter a value in **Curve shock** to stress the valuation. The par swap curve is shifted by the amount you enter, the discount and forward curves are re-bootstrapped, and every value on the page is fully repriced — this is not an approximation from PV01.

With a shock applied, the page shows the live MtM struck through alongside the shocked figure, and the change between them. Note that accrued interest does not move under a shock, since it is already realised. Click **Back to live curve** to clear it.

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

To shock every swap at once, open the **⋯** menu in the top right of the **Swap Pricer** page and click **Shock curve**.

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

***

## Download Pricer

**Download Pricer** exports an Excel workbook that reproduces the valuation cell by cell: period dates, day count fractions, notionals, implied forward rates, fixed rate, net cashflows, discount factors, present values and the running expected MtM, with the replacement rate, PV01 and MtM summarised alongside.

Use it to audit the calculation, hand a valuation to an auditor, or lift the schedule into your own model.

<figure><img src="https://3184259219-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmmQPefoflG1RwUnUKKBR%2Fuploads%2Ff5WgWDCQ5Mc9OPjcyQqK%2Fimage.png?alt=media&amp;token=60c6bafe-155e-4d66-8451-611799555adf" alt=""><figcaption></figcaption></figure>

***

## Managing a Swap

The **⋯** menu in the top right of the page lets you:

* **Edit** the swap's terms
* **Share** the swap with a colleague
* **Duplicate** the swap
* **Add confirmation**, or **Confirmation** once one is on file (see below)
* **Mark as terminated** when the trade is closed out or unwound. The swap stays in your list for reference but is left out of MtM and portfolio totals. **Reactivate** undoes it.
* **Delete** the swap

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

Also in the header: the **Live** pill. Click it to value as at a past date rather than live, or pick a quick date such as **End of month**; **Back to live** returns to live pricing.

## Attaching Trade Confirmations

Every traded swap carries a confirmation status, shown next to the swap name in the **Traded** card on the **Swap Pricer** page and in the header of the swap's own page:

* **Add confirmation**: nothing attached yet
* **confirmation**: a document is on file

Attaching the confirmation you received from the bank keeps the executed terms alongside the position, so anyone reviewing the book later can check the dealt rate against the source document rather than taking the recorded figure on trust.

**How to attach and replace a confirmation**

* Click **Add confirmation** next to the swap name to open the upload window. Files can be PDF, PNG or JPEG, up to 15 MB.

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

* To view, replace or remove a confirmation, click **confirmation** next to the swap name, or open the swap's **⋯** menu and click **Confirmation**. From there, **Open** it, drop a new file to replace it, or **Remove** it.

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

***

## Entity Page

Each entity has its own page with the combined valuation of its swaps. On the **Swap Pricer** page, hover an entity in the **Traded** card and choose **Open entity** from its **⋯** menu. **Back to Swap Pricer** returns you.

* **Mark-to-Market (MTM)**: the entity's total dirty MtM, with **Dirty MTM**, **Clean MTM** and **Accrued interest** underneath. Terminated swaps are left out.
* A summary of **Total Notional**, **Weighted Average Fixed Rate**, **Total Basis Point Value**, **Number of Swaps**, **Total Clean MtM**, **Total Accrued Interest**, **Currency** and **Entity ID**.
* **Entity Swaps**: one row per swap with its bank reference, current notional, end date, fixed rate, replacement rate, clean MtM, accrued and dirty MtM. **Download** exports the table to Excel.
* Tabs: **Forecast** charts the entity's combined expected MtM at future dates (see [Forecast MtM](https://www.bluegamma.io/documentation/pricers/calculating-the-mtm-of-a-swap/forecast-mtm.md)), and **Swap Notional Distribution** splits the current notional by bank.

The header has **Add Swap** (the ticket opens with **Traded** on and files the new swap in this entity), the **Live** valuation-time pill, **Curve shock**, and icons to share the entity with a colleague or delete it. Deleting an entity cannot be undone. If the entity holds swaps in more than one currency, a warning reminds you to allow for that when reading the totals.

***

## Related

* [Swap Pricer](https://www.bluegamma.io/documentation/pricers/calculating-a-swap-rate.md)
* [Forecast MtM](https://www.bluegamma.io/documentation/pricers/calculating-the-mtm-of-a-swap/forecast-mtm.md)
* [Swap Mark-to-Market & Accrued Interest](https://www.bluegamma.io/documentation/methodology/swap-mark-to-market.md)
* [How to Calculate Swap MtM in Excel](https://www.bluegamma.io/documentation/integrations/excel-add-in/how-to-guides/how-to-calculate-swap-mtm-in-excel.md#overview-how-swap-mtm-works)
* [Get Swap MtM by ID](https://www.bluegamma.io/documentation/integrations/excel-add-in/functions/get-swap-mtm-by-id.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/pricers/calculating-the-mtm-of-a-swap.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.
