YUCLAW v5.0.0
Validation LabOpen Index EvidenceCanada Resources EvidenceForward TrackingGitHubPyPILedgerMethodologyHome

Evidence-First Financial AI

Every signal traces to a real SEC filing.

Agent Research API · MCP · LangChain/LlamaIndex · pip install yuclaw
Disclaimer — Research & education only. Not investment advice. Signal labels are research classifications, not buy/sell recommendations.
Current signals — Forward Tracking Ledger
TickerSignal labelScore
TMOSTRONG_BULLISH+0.614
MRKBULLISH+0.538
ABBVBULLISH+0.518
XLVBULLISH+0.507
BMYBULLISH+0.498
ABTBULLISH+0.498
DHRBULLISH+0.475
UNHBULLISH+0.410
IBBBULLISH+0.409
LLYNEUTRAL+0.396
BACNEUTRAL+0.368
XLINEUTRAL+0.355
PYPLNEUTRAL+0.344
XOMNEUTRAL+0.336
XLENEUTRAL+0.324
COPNEUTRAL+0.324
WFCNEUTRAL+0.320
JNJNEUTRAL+0.304
XLUNEUTRAL+0.303
XLFNEUTRAL+0.296
XBINEUTRAL+0.294
KRENEUTRAL+0.292
FXINEUTRAL+0.285
XLRENEUTRAL+0.285
PSXNEUTRAL+0.278
GOOGLNEGATIVE_EVENT-0.271
PFENEUTRAL+0.253
UUPNEUTRAL+0.246
DIANEUTRAL+0.232
SPYNEUTRAL+0.221
MDYNEUTRAL+0.220
TAILNEUTRAL+0.220
AXPNEUTRAL+0.219
IEFNEUTRAL+0.214
VIXYNEUTRAL+0.211
VXXNEUTRAL+0.207
IWMNEUTRAL+0.201
TLTWATCH+0.178
GLDWATCH+0.178
CVXWATCH+0.178
LRCXWEAKENING-0.178
ARMWEAKENING-0.169
JPMWATCH+0.161
LUNRWEAKENING-0.151
CRCLWEAKENING-0.140
MUWEAKENING-0.137
XLYWEAKENING-0.134
SLBWATCH+0.133
QQQWATCH+0.131
RKLBWEAKENING-0.128
NVDAWEAKENING-0.119
AMZNWEAKENING-0.116
PGWATCH+0.116
MRVLWEAKENING-0.112
XLBWATCH+0.102
CWATCH+0.102
WMTWEAKENING-0.093
SLVWATCH+0.090
COSTWATCH+0.090
HPEWATCH+0.085
XLPWATCH+0.083
VWATCH+0.076
XLCWEAKENING-0.071
AMDWEAKENING-0.065
SMHWEAKENING-0.064
METAWEAKENING-0.059
AAPLWATCH+0.059
AMATWEAKENING-0.046
KOWEAKENING-0.045
MSFTWEAKENING-0.041
PEPWATCH+0.036
MAWATCH+0.033
INTCWATCH+0.033
XLKWATCH+0.031
DELLWEAKENING-0.012
MSWATCH+0.011
EEMWATCH+0.008
TSLAWEAKENING-0.006
GSWEAKENING-0.004
data as of 2026-07-23 17:00 UTC · landing page rebuilt 2026-07-23 23:00 UTC
Public signal vocabulary

Labels are research classifications, not buy/sell recommendations:

STRONG_BULLISH · BULLISH · NEUTRAL · WATCH · WEAKENING · NEGATIVE_EVENT · BEARISH_WATCH · RISK_ALERT

There is no SELL or SHORT label. The SDK's _validate_label() is invoked on every signal-bearing return.

How it works

1 · Evidence layer

SEC EDGAR filings (Form 4, 8-K, 10-Q, 10-K, 6-K, 40-F) are extracted with a local Llama 3.1 70B model. A deterministic SourceLock Guard validates every extraction against the source text before any signal sees it.

2 · Composite scoring

Nine components combine into a confidence-weighted composite. C6 event impact carries the highest weight (0.18) — by design, the evidence layer leads.

3 · Time-machine replay

Any signal can be recomputed as of a past date. Point-in-time filtering (available_as_of <= as_of) is leak-audited; reproducible via the yuclaw replay CLI or REST API.

4 · Verified Research Ledger

Each day's published signals have their content hashes committed to a public git repo (yuclaw-trust). Anyone can call yuclaw verify to confirm a signal hasn't been edited since publication.

Full disclaimer & methodology

Open-source equity research where every composite signal traces back to a verifiable SEC filing or deterministic supply-chain cascade. Replayable point-in-time. Tamper-evidenced via a public git-anchored Verified Research Ledger. Research and education only.

Disclaimer — YUCLAW research output. Not investment advice. Past performance does not guarantee future results. Signal labels are research classifications, not buy/sell recommendations. YUCLAW is not a registered investment adviser. Past results — in-sample or forward-tracked — do not predict future performance.
Use YUCLAW in your research
1 · Verify the record

pip install yuclaw then yuclaw replay-lab.
No install: tools/replay_lab.py (stdlib only) against the published bundle.
Exit 0 = every statistic and ledger root reproduced. How to report a replication →

2 · Inspect one evidence trace

One real Suncor 6-K, end to end:
filing → exhibit → extracted prose → event type → grade → C6 posture.
Open the trace → · example evidence memo (Suncor) →

3 · Cite a research lens

Every evidence packet ships a ready citation snippet
(version, data-through, build date, source commit).
Get the citation →

📖 User Guide (PDF) — from pip install to full verification, six pages.

Status — proven · not proven · accruing

Rendered from one shared source (v3/web/useful_blocks.py) on every page that shows it, so the copies cannot drift. Statuses are measured, not aspirational.

Proven (verifiable today)
  • Replay works — one command reproduces every Lab statistic and ledger root from published data
  • Ledger anchored daily — sha-256 daily roots committed to a public git repository before pages update
  • Evidence traces to filings — every accepted event carries a source URL, accession number, and verified excerpt
  • Coverage measured — SEC-filer weight per lens is stated as measured, never rounded up
  • Snapshots are point-in-time — daily as-of writes, zero retroactive edits (outage window disclosed, not repaired)
  • Evidence-tier names are never scored — enforced by positive gating and a standing negative check
Not proven
  • Forward alpha — no spread, IC, or alpha significant at 5% with adequate power
  • C6 risk-gate sign — rareness confirmed OOS 2026-07-06 (22% fire rate, n=9 held-out); sign confirmation pending (elevated arm n=2; accrual live from 2026-07-16)
  • Peer-model CAR lead — event-study lead over peer models is not established; live-era sample remains small
Accruing
  • · Forward out-of-sample record — one period per trading day, accruing daily
  • · Matured CAR events — each accepted event matures into the event study after its forward window completes
  • · C6 elevated arm — live Form-4 ingestion since 2026-07-16 restores the insider stream to production inputs
  • · External replications — the replication log accrues as independent runs are reported
Install + try it
pip install yuclaw
yuclaw demo                         # 3-minute guided "Why AMD?" journey
yuclaw why AMD --as-of 2026-05-20   # bundled offline signal
yuclaw verify AMD --date 2026-05-20 # check the ledger record
# all tickers/dates: connect the local backend — see README

SDK + REST API + MCP server documented at github.com/YuClawLab/yuclaw-brain. REST API terms at /API_TERMS.md.