{ "contract_version": 1, "published_at": "2026-07-25", "query_surface": { "model": "structured_filter_projection_pagination", "general_sql": false, "endpoint": "GET /platform/v1/datasets/{name}/query", "operators": [ "version", "symbol", "start", "end", "as_of", "columns", "limit", "offset", "tail", "format" ], "ordering": "Rows use the dataset's effective/date ordering; tail=true selects the newest bounded window. Callers cannot submit SQL or an arbitrary ORDER BY." }, "coverage": { "history": "History is dataset- and version-specific. Inspect schema.date_min and schema.date_max; Kappa makes no catalog-wide duration promise.", "universe": "US equity reference data includes active and inactive/delisted symbols where supplied. That reduces survivorship bias but does not certify every dataset or historical universe as survivorship-free.", "point_in_time": "Only registry rows whose schema.capabilities.point_in_time_supported is true accept as_of. Unsupported rows return 400 instead of silently ignoring the bound.", "exports": "Parquet exports are version-pinned and include content_sha256. The export endpoint does not accept as_of; point-in-time pulls use query with format=csv within its documented row ceiling." }, "lanes": [ { "id": "sec_13f_history", "catalog_selector": "us-13f-hist-*", "label": "SEC 13F filing history", "point_in_time_supported": true, "availability_time_field": "filing_date", "effective_time_field": "period", "revision_model": "filing_history_with_amendments", "revision_definition": "Every retained 13F-HR and 13F-HR/A accession remains a separate filing-time observation.", "retained_history": "Dataset-specific; query responses expose knowledge_time_min and knowledge_time_max.", "limitations": "Accession-level data, not an amendment-resolved canonical portfolio. ADD-type amendments and multi-entity filers require consumer-side interpretation." }, { "id": "sec_form4_history", "catalog_selector": "us-form4-*", "label": "SEC Form 4 transaction history", "point_in_time_supported": true, "availability_time_field": "filing_date", "effective_time_field": "transaction_date", "revision_model": "filing_history_with_amendments", "revision_definition": "Original Form 4 and Form 4/A rows become available on their own filing dates.", "retained_history": "Dataset-specific; query responses expose knowledge_time_min and knowledge_time_max.", "limitations": "A transaction is not treated as knowable on transaction_date. Malformed filing stamps are excluded from as_of views." }, { "id": "house_ptr_history", "catalog_selector": "house-ptr-*", "label": "US House PTR disclosure history", "point_in_time_supported": true, "availability_time_field": "filed_date", "effective_time_field": "transaction_date", "revision_model": "rolling_disclosure_history", "revision_definition": "Disclosures become available on filed_date; successful source re-parses can replace or tombstone rows for the same document.", "retained_history": "Rolling approximately 24-month source window; inspect knowledge_time_min and knowledge_time_max.", "limitations": "Disclosure can lag the trade by weeks. Parse-failed rows remain outside point-in-time views." }, { "id": "sec_13f_snapshot", "catalog_selector": "us-13f- (excluding us-13f-hist-*)", "label": "SEC 13F latest-filing snapshot", "point_in_time_supported": false, "availability_time_field": null, "effective_time_field": null, "revision_model": "latest_filing_accession_snapshot", "revision_definition": "A new source filing replaces the served latest snapshot.", "retained_history": "Latest source accession only; use us-13f-hist-* for retained filing history.", "limitations": "as_of returns 400. The snapshot is not an amendment-resolved canonical portfolio." }, { "id": "company_fundamentals", "catalog_selector": "us-fin-*", "label": "Company financial statement snapshots", "point_in_time_supported": false, "availability_time_field": "filing_date", "effective_time_field": "end_date", "revision_model": "versioned_filing_snapshot", "revision_definition": "Each Kappa version captures the producer's returned filing set; a later version may contain amended or restated facts.", "retained_history": "Company- and source-specific; inspect schema.date_min/date_max and the selected version.", "limitations": "filing_date is present for provenance, but Kappa does not yet promise an as_of filter for this family. as_of returns 400." }, { "id": "economic_actuals", "catalog_selector": "economic-calendar and source fred:* / fred-licensed:*", "label": "Economic calendar and macro observations", "point_in_time_supported": false, "availability_time_field": null, "effective_time_field": "date", "revision_model": "latest_revised_snapshot", "revision_definition": "Refreshes use the latest value published by the upstream series, including historical revisions.", "retained_history": "Series-specific; inspect schema.date_min and schema.date_max.", "limitations": "Not an ALFRED-style vintage archive and not release-time actuals. as_of returns 400." }, { "id": "ken_french_factors", "catalog_selector": "us-factor-returns-daily", "label": "Ken French research factors", "point_in_time_supported": false, "availability_time_field": null, "effective_time_field": "date", "revision_model": "upstream_revisable_snapshot", "revision_definition": "Each version captures the then-current upstream research files; upstream history may later change.", "retained_history": "Inspect schema.date_min/date_max for the selected version.", "limitations": "No release-vintage or historical-revision archive. as_of returns 400." }, { "id": "current_index_membership", "catalog_selector": "index-membership", "label": "Current US index membership", "point_in_time_supported": false, "availability_time_field": null, "effective_time_field": "asof", "revision_model": "current_membership_snapshot", "revision_definition": "A refreshed committed constituent snapshot replaces the current membership view.", "retained_history": "One current constituent snapshot per Kappa version.", "limitations": "Not historical per-date membership. Applying it to older facts or prices introduces survivorship bias; as_of returns 400." }, { "id": "other_catalog_datasets", "catalog_selector": "all other curated and customer-owned datasets", "label": "Other catalog datasets", "point_in_time_supported": false, "availability_time_field": null, "effective_time_field": null, "revision_model": "producer-declared or versioned_snapshot", "revision_definition": "Inspect schema.capabilities.revision_model for the resolved registry row and pin a version when reproducibility matters.", "retained_history": "Inspect schema.date_min/date_max and the selected version.", "limitations": "No point-in-time behavior is inferred from a name or column. as_of returns 400 unless the resolved schema explicitly declares support." } ] }