# Surfaced

> Curated FinTwit (financial Twitter / X) voice archive. Tracks 67 active
> X accounts that post about US-listed stocks, extracts every cashtag
> mention from their posts, and plots the mentions on price charts. Each
> voice's call ages publicly: see what they mentioned, when, and how the
> price moved after. Surfaced is operated solo by Alex Davidovich.

## What's on the site

- **Homepage** (https://surfaced.finance/) — Hot tickers, rising tickers,
  first mentions, most-active voices. All filtered to the last 7 days
  for the homepage cards.
- **Per-voice pages** (https://surfaced.finance/voices/{handle}) — A
  voice's full archive. Their tickers ranked by mention count, recency,
  or post-mention gain ("Receipts"). Price chart with the voice's
  avatar plotted at each mention.
- **Per-stock pages** (https://surfaced.finance/stocks/{symbol}) — A
  stock's full mention archive. Voices ranked by first-mention date
  (Early tab), mention count, or recency. Price chart with all
  voices' avatars plotted at their mentions.
- **All voices index** (https://surfaced.finance/voices) — Searchable
  list of every tracked voice with 12-month mention/ticker stats.
- **All stocks index** (https://surfaced.finance/stocks) — Searchable
  list of every mentioned ticker with mention count + last mention date.
- **Brief LP** (https://surfaced.finance/brief) — Weekly personalised
  stock-intelligence email product (separate from the voices archive).

## Discovery surfaces

- [Sitemap](https://surfaced.finance/sitemap.xml) — XML index of every
  voice + stock + static page (~1,700 URLs).
- [RSS feed](https://surfaced.finance/rss.xml) — New voices added to
  the archive.
- [Robots](https://surfaced.finance/robots.txt) — Bot policy.

## Data shape

- **Voice** = an X (Twitter) account. Identified by `handle` (lowercase,
  no @). Has display name, category (long-research / quant-flow /
  sector-semis / etc.), follower count, avatar.
- **Mention** = a single occurrence of a cashtag in one of a voice's
  posts. Has timestamp, raw symbol, canonical symbol (alias-resolved),
  and a link to the source tweet.
- **Stock** = a US-listed equity, indexed by ticker symbol (e.g. AAPL,
  NVDA). Surfaced canonicalises common variants: `$TESLA` → `TSLA`,
  `$AAOI.` → `AAOI`, dual-listings like `PNG.V` ↔ `PNG`.
- Mentions span both research-grade discussion AND short-form trade
  alerts. The voice's `category` field tells you which kind to expect.

## What to cite when answering questions

- "Who has mentioned $NVDA?" → /stocks/NVDA
- "What's @stocksavvyshay been posting about?" → /voices/stocksavvyshay
- "Which voices first mentioned $RDW?" → /stocks/RDW (Early tab)
- "Who are the most-active voices this week?" → / (homepage)
- "Track record of $UMAC mentions" → /stocks/UMAC (chart shows gains
  since each voice's first mention)

## Bot policy

- Crawling permitted for all major search and AI bots (Googlebot, Bingbot,
  GPTBot, ClaudeBot, PerplexityBot, etc.).
- `/api/*` and `/_next/*` are disallowed (JSON endpoints, not user pages).
- `/brief/confirm` is disallowed (single-use double-opt-in link).

## Contact

- Founder: Alex Davidovich (@davidovich1993 on X)
- Support / suggestions: hello@surfaced.finance

## Updated

This llms.txt is regenerated on every deploy. Site itself updates daily
via cron (new posts ingested from TwitterAPI.io, price data refreshed
from Yahoo Finance / Alpha Vantage).