Struct Filings 

pub struct Filings { /* private fields */ }

SEC filing data backed by configured data providers.

Created via Providers::filings.

Implementations

impl Filings

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.

pub fn symbol(&self) -> &str

The handle’s identifier string.

impl Filings

pub async fn get(&self) -> Result<ProviderFilings>

Fetch SEC filings for this symbol.

pub async fn sections( &self, accession_number: &str, form: FilingSectionForm, ) -> Result<Vec<FilingSection>>

Fetch the sectioned text of one filing by accession number via the FILINGS route (currently Polygon only). Not cached.

pub async fn search( &self, query: &str, filters: FilingSearchFilters, ) -> Result<Vec<FilingSearchHit>>

Full-text search over this filer’s filings via the FILINGS route (currently EDGAR only). Not cached.

The handle’s symbol scopes the search unless filters already names a filer identifier; the routed provider resolves it however its own index requires. Use search_all to search every filer.

pub async fn search_all( &self, query: &str, filters: FilingSearchFilters, ) -> Result<Vec<FilingSearchHit>>

Full-text search across every filer via the FILINGS route (currently EDGAR only). Not cached.

Searches filing text, so it answers “which filings mention this” rather than “what has this company filed” — the query shape get cannot express.

pub async fn insider_trades(&self, limit: u32) -> Result<Vec<InsiderTrade>>

Insider transactions for this issuer via the FILINGS route (EDGAR parses Forms 3/4/5 directly; Alpha Vantage and FMP are coarser fallbacks with no accession number or form type).

limit caps how many filings are read on EDGAR, not how many transactions come back — one Form 4 can report several lines. Each EDGAR filing costs two extra requests, so keep it modest. Not cached.

pub async fn institutional_holdings(&self) -> Result<Vec<InstitutionalHolding>>

The latest 13F-HR information table filed by this symbol’s CIK, via the FILINGS route (currently EDGAR only).

The handle’s symbol identifies the filer, so this is only meaningful for listed institutional managers (e.g. BRK-B) — an issuer that files no 13F errors rather than returning an empty list. Not cached.

pub async fn risk_factors(&self) -> Result<Vec<RiskFactor>>

Fetch risk factors extracted from this symbol’s SEC filings via the FILINGS route (currently Polygon only). Not cached.

pub async fn congressional_trades(&self) -> Result<Vec<CongressionalTrade>>

Congressional (House and Senate) stock-trade disclosures naming this symbol, via the FILINGS route (FMP, falling back to keyless House and Senate PTR disclosures). Not cached.

pub async fn fails_to_deliver(&self) -> Result<Vec<FailToDeliver>>

SEC fails-to-deliver data for this symbol, via the FILINGS route (FMP, or keyless EDGAR when FMP isn’t routed). Not cached.