{
  "markdown": "# Tapeline\n\n**A live quantitative market scanner for retail traders.**\n\nTapeline surfaces high-conviction technical and fundamental signals across US stocks and ETFs. It scores ~2,500 tickers every minute during market hours, detects Bollinger Band squeezes and volume expansions, surfaces recent insider buys (SEC Form 4), and classifies the overall market regime. (A Congressional-trades surface is built and Premium-gated, but no disclosure feed is wired yet.)\n\nBuilt on the same engine that powers a production personal trading bot.\n\n---\n\n## Status\n\n**Live.** `tapeline.io` is served by the Fly.io app `tapeline-web`; the API runs at `api.tapeline.io` (Fly app `tapeline-backend`). Real market data comes from Massive, with Finnhub for fundamentals, calendars and SEC Form 4 insider transactions, and FRED for macro. Three live tiers, Stripe billing, and a public scorecard. This repo stays separate from the personal `C:\\signal-system\\` engine — no shared files.\n\n## Architecture (see `docs/ARCHITECTURE.md`)\n\n```\n┌──────────────────────┐      ┌──────────────────┐      ┌─────────────────┐\n│  Massive SIP feed    │─────▶│  Scoring worker  │─────▶│  Postgres       │\n│  (Polygon, rebranded │      │  (adapted from   │      │  (scores,       │\n│   2025-10-30)        │      │   signal-system) │      │   snapshots)    │\n└──────────────────────┘      └──────────────────┘      └────────┬────────┘\n                                                                 │\n                                                                 ▼\n┌──────────────────────┐      ┌──────────────────┐      ┌─────────────────┐\n│  Next.js dashboard   │◀─SSE─│  FastAPI         │◀─────│  Read API       │\n│  (scanner, squeeze,  │      │  (auth, billing, │      │                 │\n│   regime, congress)  │      │   live stream)   │      │                 │\n└──────────────────────┘      └──────────────────┘      └─────────────────┘\n          │                            │\n          ▼                            ▼\n┌──────────────────────┐      ┌──────────────────┐\n│  Cookie-JWT auth     │      │  Stripe (billing)│\n└──────────────────────┘      └──────────────────┘\n```\n\n## Stack\n\n- **Backend:** Python 3.12 + FastAPI + SQLAlchemy + Alembic\n- **Database:** Postgres (Supabase or Neon)\n- **Frontend:** Next.js 16 + TypeScript + Tailwind + shadcn/ui\n- **Auth:** native cookie-JWT sessions (`services/session.py`), with emailed sign-in codes as a new-device second factor; Clerk and Google/Microsoft OAuth are env-gated add-ons\n- **Billing:** Stripe\n- **Data feed:** Massive Stocks Starter ($29/mo) — formerly Polygon.io, rebranded 2025-10-30. Licence scope is under review; see `docs/LICENSE_AUDIT.md`\n- **Macro / fundamentals / smart money:** FRED · Finnhub (fundamentals, SEC Form 4 insider transactions, earnings + IPO calendars)\n- **Deployment:** Fly.io — `tapeline-backend` (API + scoring worker) and `tapeline-web` (Next.js frontend, serves tapeline.io). Vercel builds PR previews only\n- **Email:** Resend\n\n## Product tabs (v1)\n\n1. **📡 Scanner** — ~2,500 tickers, composite score, filters, sort\n2. **🔥 Squeeze Watch** — BB squeeze days, volume expansion, OBV trend, suggested window\n3. **🌊 Market Regime** — current regime, VIX, DXY, 10Y, rate direction, sector leaders\n4. **🏛️ Congress Trades** — recent politician buys/sells aggregated by ticker. *Surface and Premium gate are built, but no disclosure feed is wired: the table does not accrue rows in production (see `docs/DATA_SOURCES.md`).*\n\n## Pricing\n\n- **Free** $0 — top-10 scanner rows, live (no delay), 12 ticker look-ups per UTC day, watchlist of 5, 2 browser-push alert rules. *(Open-access promo, ends 2026-09-08: scanner rows only are lifted 10 → 1,000 for signed-in Free accounts — `tier.py:PROMO_OPEN_ACCESS_UNTIL`. Look-ups, watchlist and push caps are unchanged, no Pro feature unlocks, and anonymous visitors still see the top 10.)*\n- **Pro** $9.99/mo or $8.25/mo billed annually ($99/yr) — full universe live, squeeze + regime + heatmap, watchlist 50, email alerts (10/day), CSV export, browser push.\n- **Premium** $19.99/mo or $16.58/mo billed annually ($199/yr) — everything in Pro plus Congressional trades, Recent insider buys (SEC Form 4), unlimited email alerts, watchlist 200, saved scans 100, public API (1,000 req/day).\n\nAccounts created from 2026-08-22 add a card at first sign-in, which starts a 14-day Premium trial: $0 that day, first charge on day 14, one click to cancel. Accounts created before that date are grandfathered and are never asked for a card. The public record — scorecard, daily picks, per-ticker pages, the CSV/JSON exports and the public API — needs no account and no card.\n\n## Repo layout\n\n```\nbackend/          FastAPI + scoring worker\nfrontend/        Next.js dashboard (initialize with `npx create-next-app@latest`)\ninfra/           Docker, deployment config\ndocs/            Architecture, legal checklist, data sources, pricing\nscripts/         One-off ops scripts\n```\n\n## Getting started\n\nSee `docs/ARCHITECTURE.md` for the full technical plan and `docs/LEGAL_CHECKLIST.md` for pre-launch must-dos.\n\n## What this is NOT\n\nTapeline is a **quantitative scanning and research tool**. It does not:\n\n- Provide individualized investment advice\n- Execute trades\n- Make price predictions\n- Manage customer funds\n\nAll output is factual data synthesis. Users make their own decisions. See `docs/LEGAL_CHECKLIST.md`.\n",
  "bytes": 5401,
  "sha": "5a640c8ea19819d1117d29dd8e5dd622b7e7d188bb5a20aa423a996af630a5dd",
  "repo_slug": "cham-p24/tapeline",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_tapeline_tapeline_79fb39c4/readme"
}