Struct Ticker 

pub struct Ticker { /* private fields */ }

Ticker for fetching symbol-specific data.

Provides access to quotes, charts, financials, news, and other data for a specific symbol. Uses smart lazy loading - quote data is fetched once and cached.

Example

use finance_query::Ticker;

let ticker = Ticker::new("AAPL").await?;

// Get quote data
let quote = ticker.quote(false).await?;
println!("Price: {:?}", quote.regular_market_price);

// Get chart data
use finance_query::{Interval, TimeRange};
let chart = ticker.chart(Interval::OneDay, TimeRange::OneMonth).await?;
println!("Candles: {}", chart.candles.len());

Implementations

impl Ticker

pub async fn new(symbol: impl Into<String>) -> Result<Self>

Creates a new ticker with default configuration

Arguments

• symbol - Stock symbol (e.g., “AAPL”, “MSFT”)

Examples

use finance_query::Ticker;

let ticker = Ticker::new("AAPL").await?;

pub fn builder(symbol: impl Into<String>) -> TickerBuilder

Creates a new builder for Ticker

Use this for custom configuration (language, region, timeout, proxy).

Arguments

• symbol - Stock symbol (e.g., “AAPL”, “MSFT”)

Examples

use finance_query::Ticker;

// Simple case with defaults (same as new())
let ticker = Ticker::builder("AAPL").build().await?;

// With custom configuration
let ticker = Ticker::builder("AAPL")
    .lang("ja-JP")
    .region_code("JP")
    .build()
    .await?;

pub fn symbol(&self) -> &str

Returns the ticker symbol

impl Ticker

pub async fn price(&self) -> Result<Option<Price>>

Get price information

pub async fn summary_detail(&self) -> Result<Option<SummaryDetail>>

Get summary detail

pub async fn financial_data(&self) -> Result<Option<FinancialData>>

Get financial data

pub async fn key_stats(&self) -> Result<Option<DefaultKeyStatistics>>

Get key statistics

pub async fn asset_profile(&self) -> Result<Option<AssetProfile>>

Get asset profile

pub async fn calendar_events(&self) -> Result<Option<CalendarEvents>>

Get calendar events

pub async fn earnings(&self) -> Result<Option<Earnings>>

Get earnings

pub async fn earnings_trend(&self) -> Result<Option<EarningsTrend>>

Get earnings trend

pub async fn earnings_history(&self) -> Result<Option<EarningsHistory>>

Get earnings history

pub async fn recommendation_trend(&self) -> Result<Option<RecommendationTrend>>

Get recommendation trend

pub async fn insider_holders(&self) -> Result<Option<InsiderHolders>>

Get insider holders

pub async fn insider_transactions(&self) -> Result<Option<InsiderTransactions>>

Get insider transactions

pub async fn institution_ownership( &self, ) -> Result<Option<InstitutionOwnership>>

Get institution ownership

pub async fn fund_ownership(&self) -> Result<Option<FundOwnership>>

Get fund ownership

pub async fn major_holders(&self) -> Result<Option<MajorHoldersBreakdown>>

Get major holders breakdown

pub async fn share_purchase_activity( &self, ) -> Result<Option<NetSharePurchaseActivity>>

Get net share purchase activity

pub async fn quote_type(&self) -> Result<Option<QuoteTypeData>>

Get quote type

pub async fn summary_profile(&self) -> Result<Option<SummaryProfile>>

Get summary profile

pub async fn sec_filings(&self) -> Result<Option<SecFilings>>

Get SEC filings

pub async fn grading_history(&self) -> Result<Option<UpgradeDowngradeHistory>>

Get upgrade/downgrade history

impl Ticker

pub async fn quote(&self, include_logo: bool) -> Result<Quote>

Get full quote data with optional logo URL

Arguments

• include_logo - Whether to fetch and include the company logo URL

When include_logo is true, fetches both quote summary and logo URL in parallel using tokio::join! for minimal latency impact (~0-100ms overhead).

pub async fn chart(&self, interval: Interval, range: TimeRange) -> Result<Chart>

Get historical chart data

pub async fn dividends(&self, range: TimeRange) -> Result<Vec<Dividend>>

Get dividend history

Returns historical dividend payments sorted by date. Events are lazily loaded (fetched once, then filtered by range).

Arguments

• range - Time range to filter dividends

Example

use finance_query::{Ticker, TimeRange};

let ticker = Ticker::new("AAPL").await?;

// Get all dividends
let all = ticker.dividends(TimeRange::Max).await?;

// Get last year's dividends
let recent = ticker.dividends(TimeRange::OneYear).await?;

pub async fn splits(&self, range: TimeRange) -> Result<Vec<Split>>

Get stock split history

Returns historical stock splits sorted by date. Events are lazily loaded (fetched once, then filtered by range).

Arguments

• range - Time range to filter splits

Example

use finance_query::{Ticker, TimeRange};

let ticker = Ticker::new("NVDA").await?;

// Get all splits
let all = ticker.splits(TimeRange::Max).await?;

// Get last 5 years
let recent = ticker.splits(TimeRange::FiveYears).await?;

pub async fn capital_gains(&self, range: TimeRange) -> Result<Vec<CapitalGain>>

Get capital gains distribution history

Returns historical capital gain distributions sorted by date. This is primarily relevant for mutual funds and ETFs. Events are lazily loaded (fetched once, then filtered by range).

Arguments

• range - Time range to filter capital gains

Example

use finance_query::{Ticker, TimeRange};

let ticker = Ticker::new("VFIAX").await?;

// Get all capital gains
let all = ticker.capital_gains(TimeRange::Max).await?;

// Get last 2 years
let recent = ticker.capital_gains(TimeRange::TwoYears).await?;

pub async fn indicators( &self, interval: Interval, range: TimeRange, ) -> Result<IndicatorsSummary>

Calculate all technical indicators from chart data

Arguments

• interval - The time interval for each candle
• range - The time range to fetch data for

Returns

Returns IndicatorsSummary containing all calculated indicators.

Example

use finance_query::{Ticker, Interval, TimeRange};

let ticker = Ticker::new("AAPL").await?;
let indicators = ticker.indicators(Interval::OneDay, TimeRange::OneYear).await?;

println!("RSI(14): {:?}", indicators.rsi_14);
println!("MACD: {:?}", indicators.macd);

pub async fn recommendations(&self, limit: u32) -> Result<Recommendation>

Get analyst recommendations

pub async fn financials( &self, statement_type: StatementType, frequency: Frequency, ) -> Result<FinancialStatement>

Get financial statements

Arguments

• statement_type - Type of statement (Income, Balance, CashFlow)
• frequency - Annual or Quarterly

Example

use finance_query::{Ticker, Frequency, StatementType};

let ticker = Ticker::new("AAPL").await?;
let income = ticker.financials(StatementType::Income, Frequency::Annual).await?;
println!("Revenue: {:?}", income.statement.get("TotalRevenue"));

pub async fn news(&self) -> Result<Vec<News>>

Get news articles for this symbol

Example

use finance_query::Ticker;

let ticker = Ticker::new("AAPL").await?;
let news = ticker.news().await?;
for article in news {
    println!("{}: {}", article.source, article.title);
}

pub async fn options(&self, date: Option<i64>) -> Result<Options>

Get options chain