# PakupAI

PakupAI is the intelligence layer between the world's financial information
and your decisions: it organizes financial data into knowledge, knowledge
into intelligence, and intelligence into decision support. Surfaces: Living
Reports (daily-versioned, fully computed asset dossiers), a strategy studio
with an in-browser backtest engine, and Wyck — an analyst grounded in the
same raw data users see. Every number is computed from primary or public
sources (SEC EDGAR, FRED, Binance public data, Yahoo Finance, Google News
RSS, alternative.me); nothing is predicted, and every read states the
condition that would invalidate it.

## Living Reports

One dossier per asset, versioned like git: each trading day commits a new
version and the structured diff between versions is the digest. History is
append-only; /r/<id>/v/<n> permalinks never change meaning.

Report skeleton (sections render per-asset when applicable):
- Executive summary
- What changed
- Technicals
- Relative performance
- Risk
- Fundamentals
- Sentiment
- Consensus read
- In the air — headlines, not causes
- What would change this read

Tracked assets:
- Stocks: aapl (Apple), msft (Microsoft), nvda (NVIDIA), amzn (Amazon), googl (Alphabet), meta (Meta), tsla (Tesla), jpm (JPMorgan), xom (ExxonMobil), jnj (Johnson & Johnson)
- Indices: spx (S&P 500), nasdaq (Nasdaq Composite)
- Rates: us10y (US 10Y Treasury yield), us2y (US 2Y Treasury yield)
- Commodities: gold (Gold), wti (WTI crude oil)
- FX: eurusd (EUR/USD)
- Crypto: btc (Bitcoin), eth (Ethereum)

## Machine-readable endpoints

- /api/reports/summary — 1KB cross-asset digest: close, 1d%, latest change, version, date, staleness, permalink per asset. Cited form: "living report v{v}, {date}".
- /api/reports/raw?asset=<id> — the FULL stored report JSON for the latest version (price, levels, fundamentals, relative, risk, filings, sentiment, consensus, headlines, prose, invalidation conditions, diff vs previous).
- /api/reports/raw?asset=<id>&v=<n> — any archived version, verbatim as committed.

## Human pages

- / — home — the morning read + the three rooms
- /zen — the live market as ambient painted scenes
- /macro — the macro desk (cross-asset conditions: the 19-asset board, rates & the curve, dollar pressure, fronts; crypto detail in an asset-class drawer)
- /r — the reports lab index (workspace: Wyck chat left, cross-asset digest right)
- /about — manifesto + FAQ (#faq) + privacy (#privacy)
- /studio — the studio (ideas → code → honest tests; trades open as an overlay via /studio?open=trades)
- /r/<id> — the asset's lab: Wyck left; live chart, versions chip row, and the board document right
- /r/<id>/v/<n> — frozen version permalink (same lab shell, archived; older/newer links chain the history)
- /r/<id>/compare?a=<n>&b=<m> — git-style diff between any two versions (in the lab shell)

Nothing on this site is financial advice; reports are computed descriptions
of end-of-day data with explicit invalidation conditions.