Skip to main content

edgar-pit-clock — Point-in-Time SEC EDGAR Timestamp & Session Router

Zero-dependency Python utility for eliminating the 4:15 PM SEC filingDate lookahead trap, normalizing One-Document-One-Witness EDGAR accession provenance, and enforcing Purged Walk-Forward Cross-Validation embargoes.

Built and maintained by Starling Quantitative Research ("They Trade the Headlines. We Trade the Fine Print.").


Why This Exists: The 4:15 PM Filing Trap

Naive equity backtests align corporate disclosures (10-K, 10-Q, 8-K, Form 4, Schedule 13D) by fiscal period-end (fp) or calendar filingDate. Even filingDate leaks a full trading session of lookahead bias whenever a company files after the 16:00:00 ET closing bell (for example, at 16:15:04 ET), because a daily close-to-close backtest assumes execution at 16:00:00 ET—fifteen minutes before the filing hit EDGAR.

edgar-pit-clock enforces strict point-in-time filtration using down-to-the-second SEC server acceptanceDateTime across the full NYSE holiday calendar:

Filing acceptanceDateTime (ET) MarketSession Intraday Daemon Daily Batch Replay
< 09:30:00 ET (NYSE Trading Day) PRE_MARKET Wait for Open(T_0) Open(T_0)
09:30:00 – 15:59:59 ET REGULAR_SESSION Live ArrivalMid Open(T+1) (Conservative)
>= 16:00:00 ET AFTER_HOURS Next Session Open(T+1) Open(T+1)
Weekend / NYSE Holiday NON_TRADING_DAY Next Session Open(T+1) Open(T+1)

Quickstart

pip install edgar-pit-clock
from edgar_pit_clock import (
    align_filing_to_market_bar,
    normalize_cik10,
    normalize_sec_artifact_id,
    purged_walk_forward_splits,
)

# 1. Friday 16:15:04 ET Form 8-K -> Routes cleanly to Monday Open (never Friday Close)
bar = align_filing_to_market_bar("2026-11-13T16:15:04-05:00")
print(bar.market_session, bar.daily_batch_bar_date, bar.daily_batch_price_field)
# -> MarketSession.AFTER_HOURS 2026-11-16 OPEN

# 2. One-Document-One-Witness provenance key (prevents multi-parser double-counting)
doc_id = normalize_sec_artifact_id("0000320193-26-000077")
cik = normalize_cik10(320193)
# -> doc_id == "SEC:000032019326000077", cik == "0000320193"

About Starling Quantitative

Starling Quantitative is the systematic U.S. equity research and capital allocation desk of Biwada LLC. Starling runs two layers of 100% deterministic, zero-LLM U.S. equity scouts under a single non-parametric calibration and risk engine:

  1. The Proven Foundation (Point-in-Time Filing Scouts): Rule-based scouts extracting factor-neutralized alpha from primary SEC, FDA, and patent disclosures across 3,607 survivorship-free Russell 3000 CIKs (555 delisted retained; +61.8% OOS 2022–2026 unlevered vs. SPY +54.3%).
  2. The Experiment Layer (Darwinian Alt-Data Scouts): A live survival-of-the-fittest ecosystem tracking ephemeral, differentiated alternative data feeds behind a One-Way Shadow/Canary Glass Wall—starting at $0 in shadow and earning or losing capital automatically on live out-of-sample attribution.

Open Research Monographs & Verification

Disclosure: Starling Quantitative trades proprietary capital and conducts selective institutional research evaluation under mutual NDA. Nothing in this repository constitutes investment advice or an offer to solicit retail capital.

Metadata

Release files for edgar-pit-clock 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for edgar-pit-clock 0.1.0
File Size Uploaded Provenance Actions
edgar_pit_clock-0.1.0.tar.gz 11.6 kB Without provenance Details for edgar_pit_clock-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for edgar-pit-clock 0.1.0
File Interpreter ABI Platform Actions
edgar_pit_clock-0.1.0-py3-none-any.whl Python 3 none any Details for edgar_pit_clock-0.1.0-py3-none-any.whl

Total release size: 20.8 kB

Release files / edgar_pit_clock-0.1.0.tar.gz

Download URL edgar_pit_clock-0.1.0.tar.gz
Size 11.6 kB
Tags Source
SHA-256 checksum
How to use checksums
63f6355547843860257722f1e3b4376477e1649e49e8b5832e54e490ddf1f812
BLAKE2b-256 checksum
How to use checksums
b8e77fe706332915bf7aefb17837b6fecd6bbe8fd76b3b275fd143ca5f973207
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.9

Release files / edgar_pit_clock-0.1.0-py3-none-any.whl

Download URL edgar_pit_clock-0.1.0-py3-none-any.whl
Size 9.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
89b0a24acca0fad85d7393081137a20df0e1b9a48410744742bd732ef8615f11
BLAKE2b-256 checksum
How to use checksums
3900572ea76471292ba47b04072a899794a23319420f3a5b8045fac755f544c8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.9

Security for edgar-pit-clock 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page