stock-signal

KO | EN

gitlite — search

#javascript #hacktoberfest #react #llm #go #rust #linux #docker #macos #cli #kubernetes #pytorch #ios #open-source

(★ 16)

No description available.

stock-signal Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Stock Signal Dashboard

Multi-blogger stock mention tracker that monitors X (Twitter) accounts for stock mentions, aggregates them by ticker, and displays interactive price charts with mention markers.

## Features

- Track multiple X bloggers, each with distinct color-coded markers
- Auto-extract stock tickers via $CASHTAG and keyword matching
- Interactive price charts (TradingView Lightweight Charts) with per-blogger color markers; hover reveals sentiment (看多/看空)
- Sentiment detection per tweet (keyword rules + Kimi AI fallback)
- Blogger opinion divergence module with cumulative return since first mention
- AI-powered stock analysis reports (Kimi/Moonshot)
- Telegram + WeChat Work (企业微信) push notifications for new stocks, sentiment flips, and blogger divergence
- Twelve Data (OHLCV bars) + Finnhub (real-time quote and company profiles)

## Tech Stack

Next.js 15 (App Router) · TypeScript · Supabase PostgreSQL · Prisma ORM · TradingView Lightweight Charts · Tailwind CSS · Railway

## Setup

```bash
npm install
cp .env.example .env   # Fill in all required values
npx prisma db push
npx prisma db seed
npm run dev
```

## Environment Variables

See `.env.example` for the full list:

- `DATABASE_URL` — Supabase PostgreSQL connection string
- `TWITTER_API_KEY` — TwitterAPI.io key
- `TELEGRAM_BOT_TOKEN` / `TELEGRAM_CHAT_ID` — Telegram push (personal chat)
- `TELEGRAM_GROUP_CHAT_ID` — Telegram push (group/channel, optional)
- `WECHAT_WEBHOOK_URL` — WeChat Work group bot webhook (optional, sends in parallel with Telegram)
- `CRON_SECRET` — Shared secret for cron and admin endpoints
- `KIMI_API_KEY` — Moonshot Kimi API key for stock analysis and sentiment fallback
- `TWELVE_DATA_API_KEY` — Twelve Data API key for OHLCV bars
- `FINNHUB_API_KEY` — Finnhub API key for real-time quotes and company profiles

## Daily Automation

A combined cron endpoint at `/api/cron/daily` runs six steps sequentially:

1. **Fetch posts** — pull new tweets from tracked bloggers, identify stock mentions, detect sentiment, push Telegram + WeChat on new stocks / flips / divergence
2. **Sync prices** — backfill daily OHLCV bars via Twelve Data (OTC tickers skipped gracefully)
3. **Update latest** — refresh real-time prices via Finnhub
4. **Sync profiles** — fetch Finnhub company profiles for all stocks (24h cache)
5. **Generate analyses** — generate Kimi AI analysis for stocks with profile but no analysis (permanent)
6. **Pre-warm cache** — compute full stock detail response JSON for every ticker and store in `stocks.cached_response`; detail API reads this single column with no joins

Trigger via GET with `?secret=<CRON_SECRET>` or POST with `Authorization: Bearer <CRON_SECRET>`.

Scheduled daily at 02:00 Beijing time via cron-job.org.

## Deployment

Push to `main` branch → Railway auto-deploys via GitHub integration.

stock-signal

stock-signal Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

stock-signal

stock-signal Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README