Stock market data infrastructure
Handle missing stock market data
Distinguish unknown listings, empty datasets, nullable financial fields, absent report conversions, and temporary request failures.
Documentation revised
Classify the gap before repairing it
A 404 for a company can mean the symbol did not resolve. A successful prices response with bars=[] means no series was returned for that request. A null financial amount means the field is unavailable, not zero. A null markdown_url means there is no advertised conversion link for that filing.
Record evidence at the right level
Store listing identity, dataset, requested parameters, response status, and observation time. Compare coverage metadata with a direct dataset response. A profile completeness score does not establish statement completeness, and the presence of one price bar does not establish a current or continuous history.
Recover with a bounded workflow
Correct identity and access problems first. Retry only temporary failures with a bounded delay. The paid completion endpoint can queue backfill work, but it is a mutating operation with partial and failed outcomes; inspect existing completion status and returned notes before submitting again. A successful queue response is not proof that all missing statements will appear.