Struct TickersBuilder 

pub struct TickersBuilder { /* private fields */ }

Builder for Tickers

Implementations

impl TickersBuilder

pub fn region(self, region: Region) -> Self

Set the region (automatically sets correct lang and region code)

pub fn lang(self, lang: impl Into<String>) -> Self

Set the language code (e.g., “en-US”, “ja-JP”, “de-DE”)

pub fn region_code(self, region: impl Into<String>) -> Self

Set the region code (e.g., “US”, “JP”, “DE”)

pub fn timeout(self, timeout: Duration) -> Self

Set the HTTP request timeout

pub fn proxy(self, proxy: impl Into<String>) -> Self

Set the proxy URL

pub fn config(self, config: ClientConfig) -> Self

Set a complete ClientConfig

pub fn max_concurrency(self, n: usize) -> Self

Set the maximum number of concurrent requests for batch operations.

Controls how many HTTP requests run in parallel when methods like charts(), financials(), or news() fetch data for each symbol. Default is 10.

Lower values reduce the risk of rate limiting from Yahoo Finance. Higher values increase throughput for large symbol lists.

pub fn client(self, handle: ClientHandle) -> Self

Share an existing authenticated session instead of creating a new one.

This avoids redundant authentication when you have multiple Tickers instances or want to share a session with individual crate::Ticker instances.

Obtain a ClientHandle from any existing Ticker via Ticker::client_handle().

When set, the builder’s config, timeout, proxy, lang, and region settings are ignored (the shared session’s configuration is used instead).

Example

use finance_query::{Ticker, Tickers};

let aapl = Ticker::new("AAPL").await?;
let handle = aapl.client_handle();

let tickers = Tickers::builder(["MSFT", "GOOGL"])
    .client(handle)
    .build()
    .await?;

pub fn cache(self, ttl: Duration) -> Self

Enable response caching with a time-to-live.

By default caching is disabled — every call fetches fresh data. When enabled, responses are reused until the TTL expires. Stale entries are evicted on the next write.

Example

use finance_query::Tickers;
use std::time::Duration;

let tickers = Tickers::builder(["AAPL", "MSFT"])
    .cache(Duration::from_secs(30))
    .build()
    .await?;

pub fn logo(self) -> Self

Include company logo URLs in quote responses.

When enabled, quotes() will fetch logo URLs in parallel with the quote batch request, adding a small extra request.

pub async fn build(self) -> Result<Tickers>

Build the Tickers instance