About arb-sits

arb-sits is a personal global special-situations / merger-arb tracker. It covers 60 countries plus the US, ingesting corporate-action disclosures directly from regulator filing systems (EDGAR, EDINET, DART, SEDAR+, CNMV, INFO Financière, KAP, MAGNA, etc.). Data refreshes daily at 06:00 UTC.

The 2-click audit principle

Every fact and figure displayed on the dashboard is at most two clicks from the primary filing. Click 1 opens a side panel showing the extracted snippet (original language plus English translation) and full provenance. Click 2 opens the regulator's PDF or HTML in a new tab. Citation chips like [3] mark filing-extracted facts; grey chips like [c] mark computed metrics (spread, annualised return) whose inputs are upstream facts and yfinance market prices.

Pipeline

ingest -> triage -> translate -> extract -> enrich -> synthesise -> build -> deploy

LLM stages route through OpenRouter (DeepSeek V4 Flash and Pro for English; Qwen3 for Chinese / Japanese / Korean / Arabic / Hebrew). See research/openrouter-models.md.

Stack

• Static site generated by Observable Framework (DuckDB-WASM in browser for query)
• Python pipeline (edgartools, httpx, yfinance, OpenAI-compat client for OpenRouter)
• DuckDB single-file source of truth, exported as Parquet for the dashboard
• GitHub Actions daily cron + Cloudflare Pages hosting

Limits and disclaimers

• Not financial advice. Use the citation chips and read the primary filings yourself.
• Pipeline extraction is LLM-assisted. Confidence scores are visible in the side panel; treat low-confidence facts skeptically.
• Some markets have only scrape-only access; if a regulator changes their HTML the ingestor may fall behind.
• Coverage list and known feed quirks are documented in research/global-exchanges/.

References

• Full plan: /Users/kamilworkmac/.claude/plans/encapsulated-launching-penguin.md
• Feed map: research/global-exchanges/feeds.yaml
• UX design: research/ux-design.md
• Model selection: research/openrouter-models.md
• Source code: https://github.com/kamilworkmac/arb-sits (once pushed)