Struct Snapshot 

pub struct Snapshot { /* private fields */ }

Snapshots for a watchlist spanning several asset classes, from one request.

Routes through Capability::QUOTE. Unlike Tickers — which is equity-shaped and returns full quote summaries — this takes provider-spelled symbols from any market ("AAPL", "X:BTCUSD", "I:SPX", "C:EURUSD", "O:NCLH221014C00005000") and returns one flattened row each. Polygon is currently the only provider whose snapshot endpoint spans markets.

Created via Providers::snapshot.

Implementations

impl Snapshot

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

Cache responses for ttl instead of the default 60 seconds, deduplicating concurrent identical requests.

pub fn cache_forever(self) -> Self

Cache responses for the handle’s lifetime instead of the default 60 seconds.

pub fn no_cache(self) -> Self

Disable caching — every call fetches fresh data.

impl Snapshot

pub async fn get<S: AsRef<str>>( &self, symbols: &[S], ) -> Result<Vec<MarketSnapshot>>

Fetch snapshots for symbols, which may span asset classes.

Cached per symbol list. Symbols the provider could not resolve come back as rows with MarketSnapshot::error set rather than being dropped, so the result can be aligned with the request.