Columna

Tipo

Descripción

Unidad

accession_number

String

Identificador único global del filing en SEC EDGAR (format: '0000000000-00-000000'). PK del dataset.

—

cik

String

Central Index Key SEC, 10 dígitos zero-padded. Pivote para joinear con registro y financial-facts.

—

form_type

String

Tipo de filing: '20-F' (annual FPI), '10-K' (annual domestic), '6-K' (current FPI), '8-K' (current domestic).

—

filing_date

Date

Fecha de submission del filing a SEC. Para ranking cronológico.

ISO 8601 YYYY-MM-DD

report_date

Date

Período reportado en el filing (puede diferir de filing_date). NULL para filings sin período específico (avisos).

ISO 8601 YYYY-MM-DD

acceptance_datetime

Datetime

Timestamp de aceptación del filing por SEC (mayor precisión que filing_date).

—

primary_document_url

String

URL al documento HTML principal en SEC Archives.

—

primary_document_description

String

Descripción humana del documento principal.

—

size_bytes

Int64

Tamaño del filing en bytes (proxy de complejidad / extensión).

—

is_xbrl

Boolean

TRUE si el filing trae XBRL structured data (joinable con sec.empresas.financial-facts vía accession_number).

—

items

String

Lista de items reportados (solo para 8-K). Polars List[String]. Lista vacía para 6-K, 10-K, 20-F.

—

snapshot_date

Date

Fecha de captura del snapshot (operacional cross-dataset).

ISO 8601 YYYY-MM-DD

Pueden invalidar un análisis ingenuo. Documentadas como parte del control de calidad.

Form 20-F vs 10-K — Foreign Private Issuers vs Domestic

Form 20-F es annual report de Foreign Private Issuers (empresas incorporated afuera de USA). Form 10-K es para incorporadas en USA. MercadoLibre (MELI) usa 10-K porque está incorporated en Delaware. Las demás empresas argentinas en el registro típicamente usan 20-F.

6-K vs 8-K — current report forms

6-K es current report de FPI (Foreign Private Issuer). 8-K es current report de domestic. Mismo concepto, diferente formulario. Ambas son eventos de reportería intermedia (entre annual reports).

Campo items solo existe para 8-K

El campo items (ej. ["Item 1.01", "Item 8.01"]) solo se carga para formularios 8-K. Para 6-K y 20-F queda lista vacía porque son estructuras distintas.

report_date puede ser null

Algunos filings (ej. 6-K de comunicaciones simples o avisos) no reportan un período específico. En estos casos report_date será null. Usar filing_date como fallback.

Paginación limitada — ~1000 filings por empresa

El endpoint SEC /submissions trae solo los ~1000 filings más recientes por empresa (en el campo "recent"). v1 cubre solo recent, suficiente para el backfill de 5 años. Acceso a histórico >1000 filings requiere parsear shards adicionales (Phase 2+).

SEC EDGAR — Filings

Qué incluye