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 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 fn client(self, handle: ClientHandle) -> Self

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

Avoids redundant auth handshakes when combining Tickers with other Ticker instances. Obtain a handle from any existing Ticker or Tickers via .client_handle().

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

Build the Tickers instance