← ClaudeAtlas

xbrl-fallbackslisted

Use when SEC XBRL company-facts data returns 404, is empty, or has sparse coverage — typical for recent FPIs (foreign private issuers), recent IPOs, SPACs, or shell companies. Defines the document hierarchy and extraction rules to recover shares-outstanding data from filing text when structured XBRL is unavailable.
jefrnc/quant-llm-skills · ★ 0 · Data & Documents · score 73
Install: claude install-skill jefrnc/quant-llm-skills
# XBRL Fallbacks XBRL coverage is incomplete. Many real issuers — especially the small-cap universe where dilution analysis matters most — return either 404 or empty datapoints from `data.sec.gov/api/xbrl/companyfacts/CIK*.json`. Treating absence of XBRL as absence of data is a quant pipeline bug. The shares-outstanding number is almost always *somewhere*; just not in the structured feed. ## Core principle **XBRL is one source, not the source.** When the structured feed is sparse or missing, the same datapoint is recoverable by reading the filing's text — typically the cover page or an early section of the prospectus. Build the fallback path explicitly into the pipeline; don't treat XBRL 404 as "no data". ## When XBRL fails (the 404 / empty-set universe) 1. **Recent FPIs** (Foreign Private Issuers). They file F-1, 20-F, 6-K in HTML/PDF. XBRL coverage is often delayed, partial, or absent for years after IPO. Common in Chinese small-cap IPOs (`-F` suffix CIKs, recent listings on Nasdaq Capital Market). 2. **Recent US IPOs** in the first 2 quarters post-listing — 10-Q XBRL exists but the cover-page share count may be the only reliable datapoint until the second 10-K is filed. 3. **SPACs pre-business-combination.** The shell phase has minimal XBRL; cover-page counts on the most recent 10-Q/10-K govern. 4. **Shell companies / OTC issuers** where XBRL is filed late or only for the most recent period. 5. **Amended filings (10-K/A, 10-Q/A)** — sometimes don'