Struct Discovery 

pub struct Discovery { /* private fields */ }

Symbol discovery backed by configured data providers.

Unlike crate::finance::search — a Yahoo-only convenience shortcut — this routes through Capability::DISCOVERY, so it honours the provider priority configured on Providers::builder and falls back across providers.

Created via Providers::discovery.

Implementations

impl Discovery

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 Discovery

pub async fn search(&self, query: &str, limit: u32) -> Result<Vec<SymbolMatch>>

Search the configured providers’ symbol universe.

Results are cached per (query, limit) pair.

pub async fn details(&self, symbol: &str) -> Result<SymbolDetails>

Fetch detailed reference data for one symbol.

pub async fn exchanges(&self) -> Result<Vec<ExchangeInfo>>

Fetch the tradable exchange listing.

pub async fn listing_status(&self, active: bool) -> Result<Vec<SymbolMatch>>

Fetch the providers’ whole listed-security universe.

active = false asks for delisted securities instead. This is an unfiltered dump — expect thousands of rows in one response — so prefer search when you have a query. Cached per active. EDGAR serves active = true keylessly from SEC’s bulk ticker files (no exchange-listing history, so active = false isn’t supported there); Alpha Vantage and FMP serve both.

pub async fn screener( &self, filters: &ScreenerFilters, ) -> Result<Vec<ScreenerMatch>>

Run a screener query over the providers’ universe.

Not cached — screener filters are open-ended and results are price-sensitive, so every call fetches fresh.