Skip to content

Kernalsmelly/crypto-terminal

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

4 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ–ฅ๏ธ Crypto Sentiment Terminal

A professional-grade, real-time crypto market intelligence dashboard. One stop shop for every signal you need before placing a trade โ€” no subscriptions, no API keys, no paywalls.

Dashboard Overview


โœจ Features

๐Ÿ“Š Long Conditions Meter

Six weighted signals aggregated into a single 0โ€“100 score with a clear trade verdict: EASY LONGS โ†’ LEAN LONG โ†’ NEUTRAL โ†’ CAUTION โ†’ AVOID LONGS

Signals include Fear & Greed Index, VIX volatility, BTC 7-day trend, S&P 500 macro context, crypto sector breadth, and 24h market momentum โ€” each weighted by predictive strength.

Long Conditions + Fear & Greed


๐Ÿ“ˆ Live Price Action

Interactive BTC / ETH / SOL charts with 1D, 7D, and 30D views. Area chart with neon gradient fill โ€” green on up days, red on down days.


๐ŸŒ Cross-Market Intelligence

18 TradFi assets in one panel โ€” real-time via Yahoo Finance:

Category Assets
Indices S&P 500, Nasdaq, Dow Jones, VIX
Stocks NVDA, AAPL, MSFT, META, GOOGL, TSLA, AMZN, COIN
Commodities Gold, Crude Oil, Silver, Natural Gas
Forex EUR/USD, GBP/USD, USD/JPY

Every row shows price, % change, point change, day range bar, and a 5-day sparkline.

Cross-Market Panel


๐Ÿ”ฅ Top Movers 24H

Side-by-side gainers and losers from the top 50 coins by market cap. Coin icons, price, and % change. Updates every 45 seconds.


๐Ÿฆ DeFi TVL

Top 15 protocols ranked by total value locked. Toggle between Protocols and Chains view. Live from DefiLlama.

๐Ÿ—บ๏ธ Sector Heatmap

12 crypto categories colour-coded by 24h performance. Instant visual read on which sectors are hot and which are bleeding.

๐Ÿ“ฐ Market Intelligence News

Live crypto headlines with BULLISH / BEARISH / NEUTRAL sentiment tags. Sourced from CoinDesk, The Block, Blockworks, and Decrypt.

DeFi TVL + Sector Heatmap + News


๐Ÿ’ธ DeFi Capital Flows

Net 24h TVL inflows and outflows by protocol โ€” which protocols are gaining capital and which are losing it.

๐Ÿช™ Stablecoin Pulse

Real-time supply changes for USDT, USDC, USDe, and DAI. Rising stablecoin supply = fresh capital entering the market.

โš™๏ธ BTC Options (Deribit)

  • Put/Call ratio (open interest based) โ€” market sentiment from derivatives traders
  • Max Pain for nearest expiry โ€” where market makers want price to go
  • Open interest breakdown by expiry

Flows + Stablecoin + Options


๐Ÿ“ก Market Analytics โ€” Momentum

BTC 7-day Rate of Change as a momentum bar chart. Green bars = positive momentum building. Red bars = momentum fading. Defaults to Momentum view.

๐Ÿšจ Live Alerts Ticker

Scrolling bottom ticker with live ETH volume, BTC volume, USDT volume, and market sentiment score. Always visible.


๐Ÿ› ๏ธ Tech Stack

Layer Technology
Framework Next.js 16 (App Router + Turbopack)
Language TypeScript
Styling Tailwind CSS v4 (CSS-based config)
Animation Framer Motion
Charts Recharts (AreaChart, BarChart, LineChart)
Data fetching SWR with server-side API proxy routes
Runtime Node.js (server-side caching, no database needed)

๐Ÿ“ก Data Sources

All free. All live. No API keys required.

Source Data Refresh
CoinGecko Global market cap, coins, sectors, BTC/ETH/SOL charts 45s
Alternative.me Fear & Greed Index (0โ€“100) 5 min
DefiLlama DeFi TVL by protocol and chain, capital flows 5 min
Yahoo Finance Stocks, indices, commodities, forex (v8 chart API) 5 min
Binance Futures ETH gas, funding rates, open interest 30s
Deribit BTC options โ€” put/call ratio, max pain, OI by expiry 5 min

๐Ÿ—๏ธ Architecture

Browser (SWR polling)
    โ”‚
    โ–ผ
Next.js API Routes (/app/api/*)     โ† server-side proxy layer
    โ”‚  โ”œโ”€โ”€ /api/market              โ† CoinGecko (in-memory cache + fallback)
    โ”‚  โ”œโ”€โ”€ /api/feargreed           โ† Alternative.me
    โ”‚  โ”œโ”€โ”€ /api/defi                โ† DefiLlama
    โ”‚  โ”œโ”€โ”€ /api/gas                 โ† Blocknative / Binance
    โ”‚  โ”œโ”€โ”€ /api/tradfi              โ† Yahoo Finance v8 chart API
    โ”‚  โ”œโ”€โ”€ /api/derivatives         โ† Binance Futures public endpoints
    โ”‚  โ”œโ”€โ”€ /api/options             โ† Deribit public API
    โ”‚  โ””โ”€โ”€ /api/news                โ† Crypto news aggregator
    โ”‚
    โ–ผ
External APIs (never called from browser โ€” no CORS issues)

Why proxy routes?

  • No CORS errors
  • Server-side in-memory cache returns stale data on rate limits (CoinGecko 429s)
  • Static fallback data ensures panels never go blank
  • No API keys required โ€” but the pattern is ready if keys are added later

๐Ÿš€ Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn

Install & Run

git clone https://github.com/Kernalsmelly/crypto-terminal.git
cd crypto-terminal
npm install
npm run dev

Open http://localhost:3002 in your browser.

Note: The first load may show cached/fallback data for a few seconds while all API routes warm up. Everything populates automatically.


๐Ÿ“ Project Structure

crypto-terminal/
โ”œโ”€โ”€ app/
โ”‚   โ”œโ”€โ”€ api/                    # Server-side proxy routes
โ”‚   โ”‚   โ”œโ”€โ”€ market/route.ts     # CoinGecko proxy
โ”‚   โ”‚   โ”œโ”€โ”€ tradfi/route.ts     # Yahoo Finance proxy
โ”‚   โ”‚   โ”œโ”€โ”€ options/route.ts    # Deribit proxy
โ”‚   โ”‚   โ””โ”€โ”€ ...
โ”‚   โ”œโ”€โ”€ page.tsx                # Main dashboard layout (12-col grid)
โ”‚   โ””โ”€โ”€ globals.css             # Theme variables + scrollbar styling
โ”œโ”€โ”€ components/
โ”‚   โ”œโ”€โ”€ LongConditions.tsx      # 6-signal trade readiness meter
โ”‚   โ”œโ”€โ”€ CrossMarket.tsx         # TradFi assets table with sparklines
โ”‚   โ”œโ”€โ”€ SentimentChart.tsx      # BTC/ETH/SOL price chart
โ”‚   โ”œโ”€โ”€ FearGreedGauge.tsx      # SVG arc gauge with animated needle
โ”‚   โ”œโ”€โ”€ SectorHeatmap.tsx       # 12-category colour grid
โ”‚   โ”œโ”€โ”€ OptionsPanel.tsx        # Deribit put/call ratio + max pain
โ”‚   โ””โ”€โ”€ ...                     # 15 components total
โ”œโ”€โ”€ hooks/
โ”‚   โ”œโ”€โ”€ useMarketData.ts        # CoinGecko SWR hooks
โ”‚   โ”œโ”€โ”€ useTradFi.ts            # Yahoo Finance SWR hook
โ”‚   โ””โ”€โ”€ ...                     # 10 hooks total
โ””โ”€โ”€ lib/
    โ”œโ”€โ”€ api.ts                  # Shared fetch helpers + formatters
    โ””โ”€โ”€ utils.ts                # cn(), pct(), isPos()

๐ŸŽจ Design

  • Dark theme โ€” deep #060608 background with subtle ambient colour glows
  • Colour language โ€” green for bullish/positive, red for bearish/negative, amber for caution, slate for neutral
  • Typography โ€” Geist Sans for readability, Geist Mono for data values and Terminal Mode
  • Responsive โ€” 12-column CSS grid collapses cleanly to single column on mobile
  • Terminal Mode โ€” toggle in the header enables monospace font + CRT scanline overlay

๐Ÿ”ฎ What Could Come Next

  • Liquidation heatmap (Coinglass)
  • Whale alert feed for large on-chain transactions
  • Price alerts with browser push notifications
  • Deploy to Vercel with zero config
  • Portfolio tracker overlay

๐Ÿ“„ License

MIT โ€” do whatever you want with it.


Built with Claude ยท Data from CoinGecko, DefiLlama, Yahoo Finance, Binance & Deribit

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors