Price
Market or calculated value of an instrument at a given time.
Price
Table of Contents
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 and dated to a specific moment. Each price entry stores the principal value, accrued interest component (for debt instruments), a 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 held in portfolios.
-
Defining end-of-day valuations and snapshots for asset positions.
-
Supporting duration, yield, and factor-based sensitivity analyses.
-
Assisting in generating fair value reports, P&L, and balance sheet entries.
Examples
Instrument | Date | Pricing Policy | Principal Price | Accrued Price | Factor | YTM | Modified Duration | Is Temporary Price |
BAIDU INC | 2023-03-14 | Standard | 144.9500 | 0.000 | 1 | 0.00 | 0.000 | False |
-
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
orFalse
).
Cookbook
CRUD
Operations within platform.
Use Cases
What for it's used.
F.A.Q.
Frequently asked questions.
API documentation
Link to API documentation.
How to Create a Price Entity
Prerequisites
We assume you have all prerequisites you may need, including:
- If needed: the VPN is configured to access the Finmars resources
- If needed: access to the Virtual Machine to work with the sensitive information
- Must have: registered in Finmars in the needed region environment (self-registered or registered by Finmars)
- Must have: having permissions set to allow continue with the Action in the Guide
Creation of Price Entity
- Open the “Valuation” section in the left-hand side menu. Select the “Price” entity from the list under Valuation.
- Click the “+ Add” button located in the top-left corner of the portfolio list view.
- This action opens the Add Price history form.
- Fill out the following fields as needed:
- Instrument – select the full name or unique identifier of the instrument (required).
- Date – the date when the price is recorded, in
yyyy-mm-dd
format (required). - Pricing Policy – select the pricing policy used for valuation.
- Principal Price – main market price of the instrument (e.g., 100).
- Accrued Price – the accrued interest or price component (e.g., 0).
- Factor – scaling factor for partial repayments or amortization (e.g., 1 or 0.95).
- YTM – yield to maturity as a percentage (e.g., 4.5).
- Modified Duration – interest rate sensitivity measure (e.g., 2.3).
- Is Temporary Price – optional checkbox; leave empty or check to mark the price as temporary.
- Click “Create and Exit” to save the portfolio and return to the list view. Alternatively, use “Create” to save and continue editing.