1# Data contract — verified against the live FinData OS API on 2026-11-02 (see DATA_AUDIT.md)2findata:3 base_url: https://findata.spboucher.ai/api/v14 openapi: /openapi.json5 datasets:6 bars_1m: market_bars.stock.1m.raw # raw, bar-open timestamps in UTC, 04:00-20:00 ET, zero-volume minutes absent7 bars_1m_etf: market_bars.etf.1m.raw # SPY used as market proxy8 bars_1d: market_bars.stock.1d.raw # INCOMPLETE vs 1m (fewer symbols) -> daily bars are rebuilt from 1m9 fundamentals: fundamentals.financials # Postgres-backed; GET /fundamentals/{entity}10 earnings: fundamentals.earnings # Postgres table earnings_events (no API route yet) -> documented exception11 limits:12 bars_1m_days_per_call: 3113 rows_per_page: 1000014 export_years_per_request: 1215 export_symbols_per_request: 50016 query_timeout_s: 3017 query_max_rows: 10000018 rate_limit_per_min: 60019 fundamentals_limit_max: 2000020 bars_schema_version: 121 timestamp_convention: bar_open22 timezone_storage: UTC23 exchange_tz: America/New_York24 regular_session: ["09:30", "16:00"] # the 16:00 bar is the closing print25 extended_session: ["04:00", "20:00"]26 license_class: frd-private27pit:28 available_at_policy: "filing_date + 1 day 00:00 America/New_York (vendor proxy; fallback period_end + 91 d flagged pit_fallback)"29 revision_semantics: "revision_id=1 observed 2026-11-01/02; no pre-ingestion restatement history (vendor limitation)"30 reveal_date: "earnings_events.event_date (press release), release_time in {before_open, after_close, null}"31universe:32 entity_source: fundamentals entities (5,451 active tickers as of 2026-11-01; NO delisted entities -> survivorship caveat)33 min_quarters: 834 first_filing_year: 201235 last_session: 2026-10-3036external:37 sec_company_tickers: https://www.sec.gov/files/company_tickers.json38 sec_submissions: https://data.sec.gov/submissions/CIK{cik:010d}.json39 ff5_daily: https://mba.tuck.dartmouth.edu/pages/faculty/ken.french/ftp/F-F_Research_Data_5_Factors_2x3_daily_CSV.zip40 mom_daily: https://mba.tuck.dartmouth.edu/pages/faculty/ken.french/ftp/F-F_Momentum_Factor_daily_CSV.zip41