Struct KeyStatistics 

pub struct KeyStatistics {

    pub as_of: Option<DateTime<Utc>>,
    pub market_cap: Option<Money>,
    pub shares_outstanding: Option<u64>,
    pub eps_trailing_twelve_months: Option<Price>,
    pub pe_trailing_twelve_months: Option<Decimal>,
    pub dividend_per_share_forward: Option<Price>,
    pub dividend_yield_trailing: Option<Decimal>,
    pub dividend_yield_forward: Option<Decimal>,
    pub ex_dividend_date: Option<NaiveDate>,
    pub fifty_two_week_high: Option<Price>,
    pub fifty_two_week_low: Option<Price>,
    pub average_daily_volume_3m: Option<u64>,
    pub beta: Option<Decimal>,
}

Slow-moving valuation, dividend, and risk metrics for an instrument.

All fields are optional because providers expose different subsets and some metrics are undefined for certain asset classes (e.g. dividend yield on a non-dividend-paying stock).

Fields

as_of: Option<DateTime<Utc>>

Timestamp at which these statistics were observed. Useful when snapshotting price-driven values like market_cap that move intraday.

market_cap: Option<Money>

Market capitalisation (price × shares outstanding).

shares_outstanding: Option<u64>

Shares outstanding.

eps_trailing_twelve_months: Option<Price>

Earnings per share over the trailing twelve months.

pe_trailing_twelve_months: Option<Decimal>

Price-to-earnings ratio computed against trailing-twelve-month EPS.

dividend_per_share_forward: Option<Price>

Forward (declared / expected) dividend per share.

dividend_yield_trailing: Option<Decimal>

Trailing twelve-month dividend yield expressed as a fraction (e.g. 0.025 for 2.5%).

dividend_yield_forward: Option<Decimal>

Forward dividend yield expressed as a fraction.

ex_dividend_date: Option<NaiveDate>

Next or most recent ex-dividend calendar date.

fifty_two_week_high: Option<Price>

52-week high price.

fifty_two_week_low: Option<Price>

52-week low price.

average_daily_volume_3m: Option<u64>

Average daily traded volume over the last three months.

beta: Option<Decimal>

Market beta. The calculation period and frequency are not standardised across providers (Yahoo uses 5y monthly; Bloomberg is configurable); consumers comparing values across sources should account for this.

Trait Implementations

impl Clone for KeyStatistics

fn clone(&self) -> KeyStatistics

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Columnar for KeyStatistics

where Money: ToDataFrame + Columnar, Price: ToDataFrame + Columnar,

fn columnar_to_dataframe( items: &[KeyStatistics], ) -> Result<DataFrame, PolarsError>

Errors

fn columnar_from_refs( items: &[&KeyStatistics], ) -> Result<DataFrame, PolarsError>

Errors

impl Debug for KeyStatistics

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for KeyStatistics

fn default() -> KeyStatistics

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for KeyStatistics

fn deserialize<__D>( __deserializer: __D, ) -> Result<KeyStatistics, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for KeyStatistics

impl PartialEq for KeyStatistics

fn eq(&self, other: &KeyStatistics) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for KeyStatistics

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for KeyStatistics

impl ToDataFrame for KeyStatistics

where Money: ToDataFrame + Columnar, Price: ToDataFrame + Columnar,

fn to_dataframe(&self) -> Result<DataFrame, PolarsError>

Errors

fn empty_dataframe() -> Result<DataFrame, PolarsError>

Errors

fn schema() -> Result<Vec<(String, DataType)>, PolarsError>

Errors