SecurityFinancials

Overview

SecurityFinancials is a container for financial metrics that pertain to a specific security rather than to its issuer — for example earnings per share, target prices, price-to-earnings ratios, and dividend yields. It sits within the Security structure inside the research Context and carries one or more FinancialValue child elements that hold the actual data points, qualified by attributes that describe the metric type, dilution methodology, accounting basis and temporal context. The element provides the quantitative foundation that supports analyst recommendations, valuation models, and automated downstream processing.

Usage

SecurityFinancials is an optional child of Security (path: Research.Product.Context.IssuerDetails.Issuer.SecurityDetails.Security.SecurityFinancials) with zero-or-more cardinality, so multiple instances are typical — one per metric/period combination (sources: level-one-2.3 p.17, level-one-2.5 p.17). Each instance MUST carry the securityFinancialsType attribute, drawn from SecurityFinancialsTypeEnum (e.g. EarningsPerShare, TargetPrice), to identify the category of data being reported. The element must contain at least one FinancialValue child holding the numeric value, and typically a Currency child for monetary metrics (sources: level-one-2.3 p.17, user-guide-2.3.1 p.40, data-dictionary-2.5.1 p.58). Commonly used optional attributes include: - dilution (SecurityDilutionEnum — Basic, Primary, Diluted) for per-share metrics - gaapType for the accounting standard (FinancialStatementGAAPTypeEnum) - restated and proForma boolean indicators for statement adjustments - yearType (YearTypeEnum) to distinguish fiscal from calendar year - priorCurrent, displayName and publisherDefinedValue for presentation and contextual qualifiers For target prices, earnings estimates, and similar projections, publishers typically also set estimateActual on the child FinancialValue to distinguish forecast from reported figures.

Rules

• MUSTWhen SecurityFinancials is present, it MUST carry a securityFinancialsType attribute whose value comes from SecurityFinancialsTypeEnum.[RIXML Level One Addendum v2.3.1 p.17] [RIXML Research Data Dictionary v2.5.1 p.58] [RIXML Research Suite Data Dictionary v3.0 (DRAFT) p.57]↗
• MUSTSecurityFinancials MUST contain at least one FinancialValue child element to convey the actual data point(s).[RIXML User Guide v2.3.1 p.40] [RIXML User Guide v2.2 p.39]
• SHOULDMonetary financial data SHOULD specify the denomination via a Currency child (ISO 4217), and projections SHOULD use estimateActual on each FinancialValue so consumers can distinguish estimates from actuals.[Company Report (Advanced) Sample v2.4]↗ [RIXML Release Notes v2.2 p.3]
• SHOULDFor per-share metrics, the dilution attribute (SecurityDilutionEnum) SHOULD be set to clarify whether values are Basic, Primary or Diluted.[RIXML Release Notes v2.1 p.3] [RIXML Research Data Dictionary v2.5.1 p.58]
• MAYgaapType, restated and proForma MAY be supplied to qualify the accounting basis and any statement adjustments behind the figures.[RIXML Release Notes v2.1 p.3]

Relationships

• child-ofSecurity — SecurityFinancials is a zero-or-more child of Security, scoping the financial data to a specific security rather than to its issuer.
• containsFinancialValue — Holds one or more FinancialValue children that carry the numeric data points qualified by this metric definition.
• containsCurrency — Optionally contains a Currency child (ISO 4217 validated from v2.2 onward) to denominate monetary figures such as target prices.
• typed-bySecurityFinancialsTypeEnum — The required securityFinancialsType attribute categorises the metric using values from SecurityFinancialsTypeEnum (e.g. EarningsPerShare, TargetPrice).
• typed-bySecurityDilutionEnum — The optional dilution attribute uses SecurityDilutionEnum to identify the share-count methodology for per-share calculations.
• parallelsIssuerFinancials — Structurally mirrors IssuerFinancials (both extend the shared financials type), but applies metrics at the security level rather than the issuer level.
• evidencesRating — Quantitative metrics such as target price and earnings estimates carried in SecurityFinancials commonly provide the analytical evidence supporting a Rating recommendation on the same security.