xbrl-fallbacks

What problem does it solve?

XBRL gaps (404/empty/sparse company-facts) can make quant pipelines incorrectly conclude that share counts are missing, breaking dilution and float-based analyses for real issuers.

Core Features & Use Cases

• Fallback hierarchy for shares outstanding: recovers the earliest reliable cover-page/text count across 10-Q, 10-K, 6-K, 20-F, F-* registrations, 424B supplements, DEF 14A, and initial registration forms.
• Text-based extraction rules: interprets common templated language for “as of” share counts, normalizes numbers (commas, scaling), and captures the as-of date.
• Multi-class and ADS gotchas: handles Class A/B summation and tracks ADS-to-ordinary share ratios without collapsing important share structures.
• Provenance and validation guardrails: emits a synthetic-tag datapoint (text:...) with source_form, source_accession, filed_date vs as_of_date safety semantics, plus cross-check guidance against any available XBRL and offering deltas.
• Use case: estimate dilution over time for small-cap FPIs, SPAC shell phases, or recently listed companies when structured XBRL is delayed or absent.

Quick Start

Use the xbrl-fallbacks skill to extract and validate shares-outstanding from the most recent relevant SEC filing text when company-facts XBRL is missing or empty.