# Stock Pulse

Stock Pulse is a DeepStock companion app by Driven.ai at https://pulse.deepstock.pro.
It tracks US-listed stocks with an IEX-labelled market pulse, evidence-bound
agent analysis, a private watchlist, and optional email alerts.

## What The Page Does

Stock Pulse helps market researchers answer:

- What is the current market pulse for a chosen US-listed ticker?
- What evidence-bound observations has the analysis agent produced?
- Which names are on a private watchlist, and which have email alerts on?
- Where can adjacent DeepStock research be explored through the daily
  leaderboard, Driven.ai, and the companion global exchanges app?

## Home

The page introduces Stock Pulse as a search-first tracker. Users type a
company or ticker, then open that name's pulse. Signed-in users also see a
Following list with session change, 7-day change, 52-week range, and an
email-alert indicator.

## Symbol Workspace

Selecting a stock opens `/?symbol={TICKER}` with:

- IEX-labelled last price, session change, and an intraday chart
- Market-status badge (open, closed, delayed, or preview)
- Follow / unfollow on a private watchlist
- Evidence-bound agent analysis
- Optional email alerts for policy-approved material discoveries

Clicking a followed name uses a real `/?symbol=` link so the workspace is
shareable and crawlable.

## Data And Analysis Pipeline

Stock Pulse's current production pipeline:

- Uses a synced Alpaca US-listed asset directory for search and symbol checks.
- Uses IEX-labelled Alpaca market snapshots and bars for the selected ticker.
- Preserves the last successful snapshot when a live fetch fails, marked stale.
- Runs an evidence-bound analysis workflow that cannot invent unsupported claims.
- Writes watchlist, alert preference, analysis runs, and monitoring state to D1.

The browser does not call market data providers or model APIs directly.

## Related URLs

- Home: https://pulse.deepstock.pro/
- Example symbol page: https://pulse.deepstock.pro/?symbol=AAPL
- LLM guide: https://pulse.deepstock.pro/llms.txt
- Full LLM context: https://pulse.deepstock.pro/llms-full.txt
- DeepStock leaderboard: https://deepstock.pro/
- Driven.ai research: https://driven.ai/r/deepstock
- Global exchanges app: https://exchanges.deepstock.pro/

## Usage Boundaries

Stock Pulse is for market research and educational use only. It is not
investment advice. Agent analysis and email alerts can be incomplete or wrong.
Users should verify market data independently before making financial decisions.