Struct TickerBuilder 

pub struct TickerBuilder { /* private fields */ }

Builder for constructing a Ticker with optional configuration.

Construct via Ticker::builder. All builder methods are optional; call build to finalize.

Implementations

impl TickerBuilder

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

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

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

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

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

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

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

Set the HTTP request timeout.

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

Set the proxy URL.

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

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

Avoids redundant auth handshakes when creating multiple Ticker instances. Obtain a handle 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.

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

Enable response caching with a time-to-live.

pub fn logo(self) -> Self

Include company logo URLs in quote responses.

pub fn format(self, format: ValueFormat) -> Self

Set how FormattedValue fields are represented in the Quote returned by Ticker::quote.

• ValueFormat::Raw — only .raw is populated (default); .fmt and .long_fmt are stripped. Best for programmatic use and calculations.
• ValueFormat::Both — full { raw, fmt, longFmt } object preserved.
• ValueFormat::Pretty — returns the typed Quote unchanged (use ValueFormat::transform for string-only JSON output).

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

Build the Ticker instance.