Skip to content

← Data & sources

CoTrading · Sources & permissions

SEC EDGAR: source filings before using extracted facts

Use company filings and XBRL with issuer, period and accession checks; distinguish a reference source from an already connected service.

CoTrading editorial team · AI-assisted drafting and translation ·

EDGAR is a public source for US filings, not a CoTrading-hosted financial API. This guide is a reference/manual preparation workflow; no persistent connection, freshness guarantee or endpoint smoke test is claimed. Official pages checked 2026-10-30.

Coverage and access

The SEC API documentation describes submissions and extracted XBRL data. Read original filings when tags, contexts or units need interpretation. Extracted data is not a ready-made total-return price feed.

RecordKeepWhy
IssuerLegal name and CIKTickers can change
FilingForm and accessionDistinguish amendments
FactTag, unit, start/end, contextSimilar labels can differ
TimingFiling and acceptance informationReporting date is not availability
Local copyRetrieval date, URL and digestReproduce the selected input

Public API access does not require a CoTrading key. Automated users must follow the SEC developer resources, identify their client appropriately and respect current access policy. Check current guidance rather than treating a hardcoded request rate as a right. Retry/backoff when limited; do not bypass blocks with rotating identities.

Worked preparation

Suppose the question compares nine-month operating cash flow. Search the company, select the relevant filing, and confirm its covered dates. Save the original statement heading and each selected row. A fact with a year-end end date may be annual, while another is quarter-only; do not select the largest value or newest tag as a shortcut.

In input-manifest.md, write issuer/CIK, accession, form, period, currency, scale, retrieval date and whether the figures are as originally filed or later revised. Give S01 the comparable records and ask it to stop when contexts disagree. Current extracted data alone cannot prove what an investor knew at a historical date.

Failure handling and limits

A blocked request means retrieval failed; keep the error and use a permitted manual download or wait. No original filing means no source-complete conclusion. Custom tags may require human mapping. A filing’s existence does not validate every assertion in it; management explanation remains attributed.

SEC’s reuse FAQ discusses access and reuse. Check separate rights for external images or third-party attachments; do not assume this guide is a license for every asset. Personal research and operating a commercial redistributed data service have different operational requirements. Models, providers and hosting may add costs despite free source access.

Continue with local files and the earnings case.

Keep the evidence, then continue

Source rights, input scope and calculation records matter alongside the conclusion. Report corrections with a redacted record through Skills feedback.

Feedback & contributions →