Struct Tickers 

pub struct Tickers { /* private fields */ }

Multi-symbol ticker for efficient batch operations.

Tickers optimizes data fetching for multiple symbols by:

• Using batch endpoints where available (e.g., /v7/finance/quote)
• Fetching concurrently when batch endpoints don’t exist
• Sharing a single authenticated client across all symbols
• Caching results per symbol

Example

use finance_query::Tickers;

// Create tickers for multiple symbols
let tickers = Tickers::new(["AAPL", "MSFT", "GOOGL"]).await?;

// Batch fetch all quotes (single API call)
let quotes = tickers.quotes(false).await?;
for (symbol, quote) in &quotes.quotes {
    let price = quote.regular_market_price.as_ref().and_then(|v| v.raw).unwrap_or(0.0);
    println!("{}: ${:.2}", symbol, price);
}

// Fetch charts concurrently
use finance_query::{Interval, TimeRange};
let charts = tickers.charts(Interval::OneDay, TimeRange::OneMonth).await?;

Implementations

impl Tickers

pub async fn new<S, I>(symbols: I) -> Result<Self>

where S: Into<String>, I: IntoIterator<Item = S>,

Creates new tickers with default configuration

Arguments

• symbols - Iterable of stock symbols (e.g., ["AAPL", "MSFT"])

Example

use finance_query::Tickers;

let tickers = Tickers::new(["AAPL", "MSFT", "GOOGL"]).await?;

pub fn builder<S, I>(symbols: I) -> TickersBuilder

where S: Into<String>, I: IntoIterator<Item = S>,

Creates a new builder for Tickers

pub fn symbols(&self) -> &[String]

Returns the symbols this tickers instance manages

pub fn len(&self) -> usize

Number of symbols

pub fn is_empty(&self) -> bool

Check if empty

pub async fn quotes(&self, include_logo: bool) -> Result<BatchQuotesResponse>

Batch fetch quotes for all symbols

Uses /v7/finance/quote endpoint - fetches all symbols in a single API call. When include_logo is true, makes a parallel call for logo URLs.

Arguments

• include_logo - Whether to fetch company logo URLs

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

Get a specific quote by symbol (from cache or fetch all)

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

Batch fetch charts for all symbols concurrently

Chart data cannot be batched in a single request, so this fetches all charts concurrently using tokio for maximum performance.

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

Get a specific chart by symbol

pub async fn clear_cache(&self)

Clear all caches