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:
- The Proven Foundation (Point-in-Time Filing Scouts): Rule-based scouts extracting factor-neutralized alpha from primary SEC, FDA, and patent disclosures across
3,607survivorship-free Russell 3000 CIKs (555delisted retained;+61.8%OOS2022–2026unlevered vs.SPY +54.3%). - 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
$0in shadow and earning or losing capital automatically on live out-of-sample attribution.
Open Research Monographs & Verification
- Research Note RN-01: Point-in-Time Alternative Data Ingestion, Entity Resolution & Survivorship-Free Panel Construction (PDF | DOI: 10.5281/zenodo.24222468)
- Research Note RN-02: Non-Parametric Signal Calibration, Orthogonal Pillar Pooling & One-Way Statutory Distress Vetoes (PDF | DOI: 10.5281/zenodo.24222814)
- Research Note RN-03: Six-Factor Residual Attribution, Purged Walk-Forward Validation & Volatility-Parity Risk Governance (PDF | DOI: 10.5281/zenodo.24222816)
- Live Forward Attribution Scorecard: https://starlingquant.com/scorecard
- Machine-Readable Specification: https://starlingquant.com/llms-full.txt
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.