Instrument
Table of Contents
Description
Financial meaning
Financial instruments are contracts that represent a financial asset for one party and a financial liability or equity instrument for another. They are used in investing, hedging, and speculative strategies across global financial markets.
Instruments can be categorized into equity instruments (e.g., stocks), debt instruments (e.g., bonds), derivatives (e.g., options, swaps), and hybrid instruments.
Platform abstraction
In the Finmars platform, the Instruments entity represents the complete set of financial instruments under management. It serves as a central component for accounting, valuation, performance measurement, risk analysis, reconciliation, and reporting.
Examples
User code | Modified at | Asset type | Country | PRC CCY | ACCR CCY | Short name | Name | Public name | MA T DT | MAT PRC | PRC MUL T | ACCR MULT | I NS TR TYP E |
T |
Notes |
CH-BND-20394856 | 2025-02-10 | Colombia | USD | USD | CH-BND-20394856 | Ms_XX:20394856 | 20394856 |
-
:BondUser code–uniqueDebtidentifiersecurityassignedissuedtobythegovernmentsinstrument.orUsedcorporations.for internal reference and tracking. -
:CDSModified(CreditatDefaultdateSwap)and–timeDerivativeof the last modification to the instrumentused for credit risk protection.data. -
:DerivativeAsset type–classificationGeneralofderivativethecontractsinstrument (e.g.,swaps,Bond,futures)Derivative, Real Estate). Determines behavior and processing rules in the system. -
:ForwardCountry–countryCustomizedofcontractsissuancetoorbuy/selljurisdictionatofathefutureinstrument'sdate.issuer. Important for regulatory and risk assessment purposes. -
:FXPRCForwardCCYLeg(Pricing Currency)–theForeigncurrencyexchangeincomponentwhichoftheainstrumentforwardiscontract.quoted or priced. Used for valuation and financial reporting. -
:OptionACCR CCY (Accrual Currency)–theContractscurrencyoffering rightsused tobuycalculate interest orsellaccruals.underlyingMayassets.differ from pricing currency. -
:OtherShort name–abbreviatedCatch-allor condensed label forcustomquick reference. -
Name
: full name of the instrument, typically including issuer, coupon/yield, and maturity details. -
Public name
: market-facing orlessexternalcommonname of the instrument, often matching how it appears on exchanges or public reports. -
MAT DT (Maturity Date)
: the date on which the instrument matures or principal is repaid. Key for fixed-income instruments. -
:PortfolioMAT PRC (Maturity Price)–theGroupingexpected or agreed price ofassets.the instrument at maturity. -
:StockPRC MULT (Pricing Multiplier)–factorEquityappliedsharestoofscalecompanies.the market price to nominal or unit-based values (e.g., per 100 or per 1,000 units). -
:T-BillACCR MULT (TreasuryAccrualBill)Multiplier)–factorShort-termusedgovernmenttodebtadjustsecurities.accrual amounts. Helps handle non-standard periods or calculation rules. -
INSTR TYPE (Instrument Type)
: instrument type code (e.g., BOND, STOCK, PORTFOLIO). Used for classification, logic, and filtering. -
PMT SZ DTL (Payment Size Detail)
: specifies the payment structure (e.g., default). Supports payment schedule modeling. -
Notes
: free-text field for comments or special handling notes related to the instrument.
Examples
Platform screenshots with a description of a record table example.
Cookbook
CRUD
Operations within platform.
Use Cases
What for it's used.
F.A.Q.
Frequently asked questions.
API documentation
Link to API documentation.