# Price

#### **Table of Contents**

- [Description](#bkmrk-description)
- [Examples](#bkmrk-examples)
- [Cookbook](#bkmrk-cookbook)
- [F.A.Q.](#bkmrk-api-documentation)
- [API Documentation](#bkmrk-api-documentation)

#### **Description**

##### *Financial meaning*

Prices represent the market value or quoted price of a financial instrument at a specific point in time. They are essential for valuation, performance measurement, and accurate reporting across financial systems.

##### *Platform abstraction*

In the Finmars platform, a Price is a separate entity linked to an [Instrument ](https://docs.finmars.com/books/entities/page/instrument "Instrument")and dated to a specific moment. Each price entry stores the principal value, accrued interest component (for debt instruments), a[ pricing policy](https://docs.finmars.com/books/entities/page/pricing-policy "Pricing Policy") identifier (e.g., Standard, Custom), and valuation-related fields like Yield to Maturity (YTM) and Duration.

**Prices are used in:**

- Providing market or modeled values for [instruments ](https://docs.finmars.com/books/entities/page/instrument "Instrument")held in [portfolios](https://docs.finmars.com/books/entities/page/portfolio "Portfolio").
- Defining end-of-day valuations and snapshots for asset positions.
- Supporting duration, yield, and factor-based sensitivity analyses.
- Assisting in generating fair value [reports](https://docs.finmars.com/books/reports "Reports"),[ P&L](https://docs.finmars.com/books/marscapital/chapter/pl-report "P&L Report"), and balance sheet entries.

#### **Examples**

<table border="1" id="bkmrk-instrument-date-pric" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 11.6813%;"></col><col style="width: 10.4909%;"></col><col style="width: 11.0861%;"></col><col style="width: 11.0861%;"></col><col style="width: 11.0861%;"></col><col style="width: 11.0861%;"></col><col style="width: 11.0861%;"></col><col style="width: 11.0861%;"></col><col style="width: 11.0861%;"></col></colgroup><tbody><tr><td>**Instrument**</td><td>**Date**</td><td>**Pricing Policy**</td><td>**Principal Price**</td><td>**Accrued Price**</td><td>**Factor**</td><td>**YTM**</td><td>**Modified Duration**</td><td>**Is Temporary Price**</td></tr><tr><td>BAIDU INC</td><td>2023-03-14</td><td>Standard</td><td>144.9500</td><td>0.000</td><td>1</td><td>0.00</td><td>0.000</td><td>False</td></tr></tbody></table>

- `Instrument`: name or identifier of the financial instrument.
- `Date`: the date for which the price is recorded.
- `Pricing Policy`: method used for price calculation (e.g., Standard).
- `Principal Price`: main price of the instrument excluding accrued interest.
- `Accrued Price`: accumulated interest up to the pricing date.
- `Factor`: multiplier used to adjust the nominal or market value of the instrument.
- `YTM`: yield to maturity, representing the expected return if the instrument is held until maturity.
- `Modified Duration`: measure of the price sensitivity of the instrument to interest rate changes.
- `Is Temporary Price`: flag indicating if the price is temporary (`True` or `False`).

#### **Cookbook**

##### *CRUD* 

Operations within platform.

##### *Use Cases*

What for it's used.

#### **F.A.Q.**

Frequently asked questions.

#### **API documentation**

Link to API documentation.