# DeepStock

DeepStock is an AI stock research web app by Driven.ai at https://deepstock.pro.
It ranks equities with a daily 1-10 AI Score and shows the strongest names in a
stock leaderboard.

## What The Page Does

DeepStock helps market researchers answer:

- Which stocks currently have the strongest DeepStock AI Score?
- What signal label, price context, and short thesis explain each ranking?
- Which top-ranked stock deserves deeper follow-up research?
- Where can adjacent market context be explored through Driven.ai and the
  companion global exchanges app?

## Hero

The page introduces DeepStock as "The market, ranked by an AI agent." It
explains that Daily AI Scores rank stocks by price action, momentum, valuation,
and analyst context. When live data is available, the hero highlights the top
ranked stock, its company name, signal label, AI Score, and a concise thesis.

## Leaderboard

The leaderboard displays the top ranked stocks with:

- Rank
- Ticker
- Company name
- Primary exchange
- Price
- Daily percentage change
- Signal label
- AI Score
- Short AI-generated thesis

Clicking a stock opens a Driven.ai research flow with the ticker and company
name prefilled for deeper analysis.

## Data And Scoring Pipeline

DeepStock's current production pipeline:

- Uses Alpaca market data for adjusted daily bars and end-of-day price context.
- Uses Yahoo-compatible enrichment fields for market cap, beta, valuation
  ratios, dividend yield, analyst rating context, and earnings timestamps when
  available.
- Computes a deterministic local factor score across a curated high-liquidity
  universe.
- Sends the top factor candidates as compact context to the AI scorer.
- Writes the resulting leaderboard to a Cloudflare KV cache.
- Serves the browser through `/api/leaderboard`.

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

## Current Stock Universe

The production leaderboard currently uses a curated high-liquidity large-cap
stock universe of 100 US-listed tickers. The AI scorer receives a smaller top
candidate set selected by the deterministic local factor model. This is an
implementation boundary, not a permanent product limit.

## Related URLs

- Home: https://deepstock.pro/
- Leaderboard API: https://deepstock.pro/api/leaderboard
- LLM guide: https://deepstock.pro/llms.txt
- Full LLM context: https://deepstock.pro/llms-full.txt
- Driven.ai research: https://driven.ai/r/deepstock
- Global exchanges app: https://exchanges.deepstock.pro/

## Usage Boundaries

DeepStock is for market research and educational use only. It is not investment
advice. AI-generated scores and theses can be incomplete or wrong. Users should
verify market data independently before making financial decisions.
