Free Crypto News MCP Server

---

name: Free Crypto News API
type: api category: cryptocurrency auth: none pricing: free endpoints: 150+ sources: 200+ llms_txt: https://cryptocurrency.cv/llms.txt openapi: https://cryptocurrency.cv/api/openapi.json mcp_server: "@anthropic-ai/mcp-server-crypto-news"

🌐 Languages (42): English | العربية | Български | বাংলা | Čeština | Dansk | Deutsch | Ελληνικά | Español | فارسی | Suomi | Français | עברית | हिन्दी | Hrvatski | Magyar | Indonesia | Italiano | 日本語 | 한국어 | Melayu | Nederlands | Norsk | Polski | Português | Română | Русский | Slovenčina | Slovenščina | Српски | Svenska | Kiswahili | தமிழ் | తెలుగు | ไทย | Filipino | Türkçe | Українська | اردو | Tiếng Việt | 简体中文 | 繁體中文

---

🆓 Free Crypto News API

<p align="center"> <a href="https://github.com/nirholas/free-crypto-news/stargazers"><img src="https://img.shields.io/github/stars/nirholas/free-crypto-news?style=for-the-badge&logo=github&color=yellow" alt="GitHub Stars"></a> <a href="https://github.com/nirholas/free-crypto-news/blob/main/LICENSE"><img src="https://img.shields.io/github/license/nirholas/free-crypto-news?style=for-the-badge&color=blue" alt="License"></a> <a href="https://github.com/nirholas/free-crypto-news/issues"><img src="https://img.shields.io/github/issues/nirholas/free-crypto-news?style=for-the-badge&color=orange" alt="Issues"></a> </p> <p align="center"> <a href="https://github.com/nirholas/free-crypto-news/pkgs/container/free-crypto-news"><img src="https://img.shields.io/badge/container-ghcr.io-blue?style=flat-square&logo=docker" alt="Docker (GHCR)"></a> <a href="https://github.com/nirholas/free-crypto-news/commits/main"><img src="https://img.shields.io/github/last-commit/nirholas/free-crypto-news?style=flat-square" alt="Last Commit"></a> <a href="https://github.com/nirholas/free-crypto-news/graphs/contributors"><img src="https://img.shields.io/github/contributors/nirholas/free-crypto-news?style=flat-square" alt="Contributors"></a> <a href="https://github.com/nirholas/free-crypto-news"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat-square" alt="PRs Welcome"></a> <a href="https://www.npmjs.com/package/@anthropic-ai/mcp-server-crypto-news"><img src="https://img.shields.io/badge/MCP-Server-5B4EFF?style=flat-square" alt="MCP Server"></a> </p>

🤖 AI Agents: Free, no-auth crypto news API with 200+ sources.

curl https://cryptocurrency.cv/api/news • LLM Docs • Full API Docs • OpenAPI

• MCP: npx @anthropic-ai/mcp-server-crypto-news

<p align="center"> <a href="#-quick-start">Quick Start</a> • <a href="#-sdks">SDKs</a> • <a href="#-api-endpoints">API</a> • <a href="#-cli">CLI</a> • <a href="#-docker">Docker</a> • <a href="#%EF%B8%8F-kubernetes-deployment">K8s</a> • <a href="https://cryptocurrency.cv/developers">Docs</a> </p> <p align="center"> <img src=".github/demo.svg" alt="Free Crypto News API Demo" width="700"> </p>

⭐ If you find this useful, please star the repo! It helps others discover this project and motivates continued development.

---

Get real-time crypto news from 200+ sources with one API call.

curl https://cryptocurrency.cv/api/news

---

	Free Crypto News	CryptoPanic	Others
Price	🆓 Free forever	$29-299/mo	Paid
API Key	❌ None needed	Required	Required
Rate Limit	Unlimited*	100-1000/day	Limited
Sources	130+ English + 75 International	1	Varies
Historical	📚 662,000+ articles (2017-2026)	Limited	None
International	🌏 KO, ZH, JA, ES + translation	No	No
Self-host	✅ One click (Vercel/Docker/K8s)	No	No
PWA	✅ Installable	No	No
MCP	✅ Claude + ChatGPT	No	No
SDKs	13 languages	0	1-2
AI Features	30+ AI endpoints (FREE)	No	No
Voice	✅ Alexa + Podcasts	No	No

---

📚 Historical Archive

Access 662,000+ crypto news articles spanning 2017-2025 — the largest free crypto news dataset available!

Metric	Value
Total Articles	662,047
Date Range	September 2017 - February 2025
Languages	English + Chinese
Unique Sources	100+
Top Tickers	BTC (81k), ETH (50k), USDT (19k), SOL (16k), XRP (13k)
Search Terms	79,512 indexed

Data Sources:

• CryptoPanic — 346,031 articles from 200+ English sources
• Odaily 星球日报 — 316,016 Chinese crypto news articles

# Query historical archive
curl "https://cryptocurrency.cv/api/archive?date=2024-01"

# Search by ticker
curl "https://cryptocurrency.cv/api/archive?ticker=BTC&limit=100"

# Full-text search
curl "https://cryptocurrency.cv/api/archive?q=bitcoin%20etf"

📁 Raw data available in /archive/ — JSONL format by month.

---

🌿 Branches

Branch	Description
main	Stable production branch — Original API-focused design

To try the redesign locally:

git checkout redesign/pro-news-ui
npm install && npm run dev

---

🌍 International News Sources

Get crypto news from 75 international sources across 18 languages — with automatic English translation!

Supported Sources by Language

Language	Count	Sample Sources
🇨🇳 Chinese (zh)	10	8BTC, Jinse Finance, Odaily, ChainNews, PANews, TechFlow, BlockBeats, MarsBit, Wu Blockchain, Foresight News
🇰🇷 Korean (ko)	9	Block Media, TokenPost, CoinDesk Korea, Decenter, Cobak, The B.Chain, Upbit Blog, Blockchain Today Korea, CryptoQuant Blog
🇯🇵 Japanese (ja)	6	CoinPost, CoinDesk Japan, Cointelegraph Japan, btcnews.jp, Crypto Times Japan, CoinJinja
🇧🇷 Portuguese (pt)	5	Cointelegraph Brasil, Livecoins, Portal do Bitcoin, BeInCrypto Brasil, Bitcoin Block
🇮🇳 Hindi (hi)	5	CoinSwitch, CoinDCX, WazirX, ZebPay, Crypto News India
🇪🇸 Spanish (es)	5	Cointelegraph Español, Diario Bitcoin, CriptoNoticias, BeInCrypto Español, Bitcoiner Today
🇩🇪 German (de)	4	BTC-ECHO, Cointelegraph Deutsch, Coincierge, CryptoMonday
🇫🇷 French (fr)	4	Journal du Coin, Cryptonaute, Cointelegraph France, Cryptoast
🇮🇷 Persian (fa)	4	Arz Digital, Mihan Blockchain, Ramz Arz, Nobitex
🇹🇷 Turkish (tr)	3	Cointelegraph Türkçe, Koin Medya, Coinsider
🇷🇺 Russian (ru)	3	ForkLog, Cointelegraph Russia, Bits.Media
🇮🇹 Italian (it)	3	Cointelegraph Italia, The Cryptonomist, Criptovalute.it
🇮🇩 Indonesian (id)	3	Cointelegraph Indonesia, Blockchain Media, Pintu Academy
🇻🇳 Vietnamese (vi)	2	Tạp chí Bitcoin, Coin68
🇹🇭 Thai (th)	2	Siam Blockchain, Bitcoin Addict Thailand
🇵🇱 Polish (pl)	2	Kryptowaluty.pl, Bitcoin.pl
🇳🇱 Dutch (nl)	2	Bitcoin Magazine NL, Crypto Insiders
🇸🇦 Arabic (ar)	2	Cointelegraph Arabic, ArabiCrypto

Legacy Region View

| Region | Sources | | 🇰🇷 Korea | Block Media, TokenPost, CoinDesk Korea | | 🇨🇳 China | 8BTC (巴比特), Jinse Finance (金色财经), Odaily (星球日报) | | 🇯🇵 Japan | CoinPost, CoinDesk Japan, Cointelegraph Japan | | 🇪🇸 Latin America | Cointelegraph Español, Diario Bitcoin, CriptoNoticias |

Quick Examples

cURL:

# Get latest news
curl "https://cryptocurrency.cv/api/news?limit=10"

# Get Bitcoin sentiment
curl "https://cryptocurrency.cv/api/ai/sentiment?asset=BTC"

# Search articles
curl "https://cryptocurrency.cv/api/search?q=ethereum%20upgrade"

# Get international news with translation
curl "https://cryptocurrency.cv/api/news/international?language=ko&translate=true"

Python:

import requests

BASE_URL = "https://cryptocurrency.cv"

# Get latest news
news = requests.get(f"{BASE_URL}/api/news?limit=10").json()
for article in news["articles"]:
    print(f"• {article['title']} ({article['source']})")

# Get Bitcoin sentiment analysis
sentiment = requests.get(f"{BASE_URL}/api/ai/sentiment?asset=BTC").json()
print(f"BTC Sentiment: {sentiment['label']} ({sentiment['score']:.2f})")

# Get Fear & Greed Index
fg = requests.get(f"{BASE_URL}/api/market/fear-greed").json()
print(f"Market: {fg['classification']} ({fg['value']}/100)")

# Stream real-time updates
import sseclient
response = requests.get(f"{BASE_URL}/api/stream", stream=True)
client = sseclient.SSEClient(response)
for event in client.events():
    print(f"New: {event.data}")

JavaScript:

const BASE_URL = 'https://cryptocurrency.cv';

// Get latest news
const news = await fetch(`${BASE_URL}/api/news?limit=10`).then(r => r.json());
news.articles.forEach(a => console.log(`• ${a.title} (${a.source})`));

// Get AI-powered summary
const summary = await fetch(`${BASE_URL}/api/summarize?style=bullet`).then(r => r.json());
console.log(summary.summary);

// Stream real-time updates
const events = new EventSource(`${BASE_URL}/api/stream`);
events.onmessage = (e) => console.log('New:', JSON.parse(e.data).title);

// Ask questions about crypto news
const answer = await fetch(`${BASE_URL}/api/ask?q=What's happening with Bitcoin?`).then(r => r.json());
console.log(answer.response);

📚 Full Tutorials & Examples — 19 comprehensive guides covering 150+ endpoints with complete working code.

Features

• ✅ Auto-translation to English via Groq AI
• ✅ 7-day translation cache for efficiency
• ✅ Original + English text preserved
• ✅ Rate-limited (1 req/sec) to respect APIs
• ✅ Fallback handling for unavailable sources
• ✅ Deduplication across sources

See API docs for full details.

---

📱 Progressive Web App (PWA)

Free Crypto News is a fully installable PWA that works offline!

Features

Feature	Description
📲 Installable	Add to home screen on any device
📴 Offline Mode	Read cached news without internet
🔔 Push Notifications	Get breaking news alerts
⚡ Lightning Fast	Aggressive caching strategies
🔄 Background Sync	Auto-updates when back online
🎯 App Shortcuts	Quick access to Latest, Breaking, Bitcoin
📤 Share Target	Share links directly to the app
🚨 Real-Time Alerts	Configurable alerts for price & news conditions

Install the App

Desktop (Chrome/Edge):

1. Visit cryptocurrency.cv
2. Click the install icon (⊕) in the address bar
3. Click "Install"

iOS Safari:

1. Visit the site in Safari
2. Tap Share (📤) → "Add to Home Screen"

Android Chrome:

1. Visit the site
2. Tap the install banner or Menu → "Install app"

Service Worker Caching

The PWA uses smart caching strategies:

Content	Strategy	Cache Duration
API responses	Network-first	5 minutes
Static assets	Cache-first	7 days
Images	Cache-first	30 days
Navigation	Network-first + offline fallback	24 hours

Keyboard Shortcuts

Power through news with keyboard navigation:

Shortcut	Action
j / k	Next / previous article
/	Focus search
Enter	Open selected article
d	Toggle dark mode
g h	Go to Home
g t	Go to Trending
g s	Go to Sources
g b	Go to Bookmarks
?	Show all shortcuts
Escape	Close modal

📖 Full user guide: docs/USER-GUIDE.md

---

🌐 Interactive Pages

The web interface provides rich, interactive pages for exploring crypto data:

📰 News & Content

Page	Description
/	Home page with latest news feed
/trending	Trending topics & sentiment
/search	Full-text search with filters
/sources	Browse news by source
/source/[id]	Individual source page
/tags/[slug]	Tag-based news filtering
/article/[slug]	Article detail page
/topic/[slug]	Topic-based news
/topics	All topics overview
/buzz	Social buzz & mentions

📊 Market Data

Page	Description
/markets	Market overview with prices
/markets/categories	Market categories browser
/coin/[coinId]	Detailed coin page (CoinGecko-quality)
/fear-greed	Fear & Greed Index with breakdown
/funding	Funding rates across exchanges
/signals	AI trading signals (educational)
/whales	Whale alert tracking
/orderbook	Order book visualization
/liquidations	Liquidation tracking
/dominance	Market dominance charts
/movers	Top gainers/losers
/heatmap	Market heatmap visualization
/gas	ETH gas tracker
/arbitrage	Arbitrage opportunities
/options	Options market data
/oracle	Oracle price feeds

🧠 AI Analysis

Page	Description
/ai	AI analysis dashboard
/factcheck	Claim verification dashboard
/entities	Entity extraction viewer
/claims	Extracted claims browser
/clickbait	Clickbait detection & scoring
/narratives	Market narrative tracking
/onchain	On-chain event correlation
/origins	Original source finder
/citations	Citation network explorer
/sentiment	Sentiment analysis
/coverage-gap	Coverage gap analysis

🔬 Research Tools

Page	Description
/backtest	News-based strategy backtesting
/influencers	Influencer prediction tracking
/predictions	Prediction market integration
/portfolio	Portfolio-based news feed
/screener	Custom news screener
/correlation	News-price correlation analysis

⚙️ User Features

Page	Description
/settings	User preferences & themes
/watchlist	Personalized watchlist
/bookmarks	Saved articles
/saved	Saved content manager
/read	Reading list
/digest	Personalized news digest

📖 Documentation & Tools

Page	Description
/developers	Developer portal & API docs
/examples	Code examples & demos
/about	About the project
/pricing	Pricing tiers
/install	Installation guide
/blog	Project blog
/calculator	Crypto calculator
/compare	Coin comparison
/charts	Advanced charting
/analytics	Usage analytics
/regulatory	Regulatory tracking
/status	System health dashboard

🎨 UI/UX Features

Feature	Description
Skeleton Loading	Full-page loading skeletons during navigation
Swipe Gestures	Swipe-to-close mobile navigation
Bookmark/Share	Quick action buttons on news cards
Scroll Indicators	Fade edges + arrows for horizontal scroll
Dark Mode	System-aware with flash prevention
Reduced Motion	Respects prefers-reduced-motion
Accessibility	Skip links, focus rings, ARIA labels

---

Generate PNG Icons

SVG icons work in modern browsers. For legacy support:

npm install sharp
npm run pwa:icons

---

Sources

We aggregate from 130+ English outlets + 76 international sources across 21 categories. Source quality is defined in a single canonical tier system (src/lib/source-tiers.ts) used consistently across the feed, RAG re-ranker, and archive reliability tracker.

Source Tiers

Tier	Credibility	Reputation	Examples
Tier 1 — Mainstream / institutional	0.88–0.98	90–100	Bloomberg, Reuters, WSJ, FT, CNBC, Forbes
Tier 2 — Premium crypto-native	0.86–0.95	65–90	CoinDesk, The Block, Blockworks, Decrypt, The Defiant
Tier 3 — Established crypto news	0.68–0.82	60–80	CoinTelegraph, Bitcoin Magazine, Bitcoinist
Tier 4 — Aggregators & volume	0.60–0.68	50–60	Crypto.news, AMBCrypto, CryptoPotato
Research — Institutional & VC	0.90–0.94	70–72	Messari, Delphi, Paradigm, a16z
Fintech — Payments (deprioritized)	0.40–0.50	30–35	Finextra, PYMNTS, Fintech Futures

🏠 Homepage Feed (curated high-signal sources)

The homepage fetches only from a curated subset focused on quality and signal-to-noise:

• Tier 1 & 2 — Major crypto news: CoinDesk, The Block, Decrypt, CoinTelegraph, Bitcoin Magazine, Blockworks, The Defiant, Bitcoinist, CryptoSlate, NewsBTC
• Research & Analysis: Messari, Glassnode, Delphi Digital, Paradigm, a16z, The Block Research
• Security: CertiK, OpenZeppelin, Trail of Bits, Immunefi, samczsun, SlowMist
• Ethereum & Alt L1s: Etherscan Blog, NEAR, Cosmos, Avalanche, Sui, Aptos, Cardano, Polkadot
• Stablecoins: Circle Blog, Tether News
• Institutional / VC: Galaxy Digital, Pantera, Multicoin, Placeholder, Variant, Dragonfly
• ETF / Asset Managers: Grayscale, Bitwise, VanEck, CoinShares, ARK, 21Shares, WisdomTree
• Developer Tools: Alchemy, Chainlink, Infura, The Graph, Hardhat, Foundry
• Exchange Blogs: Coinbase, Binance
• Mainstream (selected): Bloomberg Crypto, Forbes Crypto

All other endpoints (/api/news, /api/search, category filters, etc.) query the full source list.

---

Endpoints

Endpoint	Description
/api/news	Latest from all sources
/api/news?category=institutional	Filter by category
/api/news/categories	List all categories
/api/news/international	International sources with translation
/api/search?q=bitcoin	Search by keywords
/api/defi	DeFi-specific news
/api/bitcoin	Bitcoin-specific news
/api/breaking	Last 2 hours only
/api/trending	Trending topics with sentiment
/api/tags	Tag discovery and filtering
/api/archive	Historical news archive
/api/archive/status	Archive health status
/api/rss	RSS 2.0 feed
/api/atom	Atom feed
/api/opml	OPML export for RSS readers
/api/health	API health check
/api/cache	Cache statistics
/api/stats	API usage statistics
/api/webhooks	Webhook registration
/api/push	Web Push notifications
/api/newsletter	Newsletter subscription
/api/alerts	Configurable alert rules
/api/sse	Server-Sent Events stream
/api/ws	WebSocket connection info
/api/export	Data export (JSON, CSV, Parquet)
/api/exports	Bulk export job management
/api/storage/cas	Content-addressable storage
/api/views	Article view tracking
/api/register	API key registration
/api/keys	API key management
/api/gateway	Unified API gateway for integrations
/api/docs	Interactive Swagger UI documentation
/api/openapi.json	OpenAPI 3.1 specification
/api/v1/	Legacy v1 API endpoints
/api/market/orderbook	Order book depth for trading pairs
/api/social	Aggregated social media trends
/api/social/monitor	Real-time social monitoring
/api/premium/streams/orderbook	Real-time order book stream
/api/premium/streams/liquidations	Real-time liquidation stream
/api/premium/export/history	Historical data export
/api/cron/archive	Archive maintenance (cron job)
/api/cron/social	Social data collection (cron job)
/api/cron/feeds	Feed health monitoring (cron job)
/api/market/orderbook	Order book depth for trading pairs
/api/social	Aggregated social media trends
/api/social/monitor	Real-time social monitoring
/api/premium/streams/orderbook	Real-time order book stream
/api/premium/streams/liquidations	Real-time liquidation stream
/api/premium/export/history	Historical data export
/api/cron/archive	Archive maintenance (cron job)
/api/cron/social	Social data collection (cron job)
/api/cron/feeds	Feed health monitoring (cron job)

📂 Category Filter

Filter news by specialized categories:

# Get institutional/VC research
curl "https://cryptocurrency.cv/api/news?category=institutional"

# Get on-chain analytics news
curl "https://cryptocurrency.cv/api/news?category=onchain"

# Get ETF and asset manager news
curl "https://cryptocurrency.cv/api/news?category=etf"

# Get macro economic analysis
curl "https://cryptocurrency.cv/api/news?category=macro"

# Get quantitative research
curl "https://cryptocurrency.cv/api/news?category=quant"

# List all available categories
curl "https://cryptocurrency.cv/api/news/categories"

Available categories: general, bitcoin, defi, nft, research, institutional, etf, derivatives, onchain, fintech, macro, quant, journalism, ethereum, asia, tradfi, mainstream, mining, gaming, altl1, stablecoin

🌍 API Translation (18 Languages)

All news endpoints support real-time translation via the ?lang= parameter:

# Get news in Spanish
curl "https://cryptocurrency.cv/api/news?lang=es"

# Get breaking news in Japanese
curl "https://cryptocurrency.cv/api/breaking?lang=ja"

# Get DeFi news in Arabic
curl "https://cryptocurrency.cv/api/defi?lang=ar"

# Get Bitcoin news in Chinese (Simplified)
curl "https://cryptocurrency.cv/api/bitcoin?lang=zh-CN"

Supported Languages: en, es, fr, de, pt, ja, zh-CN, zh-TW, ko, ar, ru, it, nl, pl, tr, vi, th, id

Requirements:

• Set GROQ_API_KEY environment variable (FREE at console.groq.com/keys)
• Translation is auto-enabled when GROQ_API_KEY is set

Endpoints with Translation Support:

Endpoint	?lang= Support
/api/news	✅
/api/breaking	✅
/api/defi	✅
/api/bitcoin	✅
/api/archive	✅
/api/archive/v2	✅ (redirects to /api/archive)
/api/trending	Trending topics with sentiment
/api/analyze	News with topic classification
/api/stats	Analytics & statistics
/api/sources	List all sources
/api/health	API & feed health status
/status	System status dashboard (UI)
/api/rss	Aggregated RSS feed
/api/atom	Aggregated Atom feed
/api/opml	OPML export for RSS readers
/api/docs	Interactive API documentation
/api/webhooks	Webhook registration
/api/archive	Historical news archive
/api/push	Web Push notifications
/api/origins	Find original news sources
/api/portfolio	Portfolio-based news + prices
/api/news/international	International sources with translation

🤖 AI-Powered Endpoints (FREE via Groq)

Endpoint	Description	Provider
/api/ai	Unified AI endpoint (7 actions)	All
/api/summarize	AI summaries with style options (brief/detailed/bullet/eli5/technical)	Groq
/api/ask?q=...	Ask questions about crypto news	Groq
/api/digest	AI-generated news digest (6h/12h/24h periods)	Groq
/api/sentiment	Deep sentiment analysis with confidence scores	Groq
/api/entities	Extract entities (7 types: ticker/person/company/protocol/exchange/regulator/event)	Groq
/api/narratives	Identify market narratives with strength scoring	Groq
/api/factcheck	Extract & verify claims (verified/likely/unverified/disputed)	Groq
/api/clickbait	Detect clickbait with scoring (0-100) and rewritten titles	Groq
/api/classify	Event classification (13 types: funding/hack/regulation/launch/partnership/listing/airdrop/upgrade/legal/market/executive/acquisition/general)	All
/api/claims	Claim extraction with attribution (fact/opinion/prediction/announcement)	All
/api/ai/brief	Daily brief with executive summary & market overview	All
/api/ai/counter	Counter-arguments with strength scoring	All
/api/ai/debate	Bull vs Bear debate generation	All
/api/ai/oracle	The Oracle - natural language crypto intelligence chat	Groq
/api/ai/summarize	Enterprise summarization with compression ratio	Groq
/api/ai/entities	Enterprise entity extraction with graph support	Groq
/api/ai/relationships	Relationship extraction (11 types) with clustering	Groq
/api/ai/synthesize	Auto-cluster duplicate articles into comprehensive summaries	Groq
/api/ai/explain	AI explains why any topic is trending with full context	Groq
/api/ai/portfolio-news	Score news by relevance to your portfolio holdings	Groq
/api/ai/correlation	Detect correlations between news and price movements	Groq
/api/ai/flash-briefing	Ultra-short AI summaries for voice assistants	Groq
/api/ai/narratives	Track crypto narratives through lifecycle phases (emerging/growing/peak/declining)	Groq
/api/ai/cross-lingual	Regional sentiment divergence & alpha signal detection	Groq
/api/ai/source-quality	AI-powered source scoring & clickbait detection	Groq
/api/ai/research	Deep-dive research reports on any crypto topic	Groq
/api/detect/ai-content	AI-generated content detection (offline, no API needed)	None
/api/i18n/translate	Article translation (18 languages)	Groq

Supported AI Providers (priority order):

1. OpenAI - OPENAI_API_KEY (gpt-4o-mini default)
2. Anthropic - ANTHROPIC_API_KEY (claude-3-haiku default)
3. Groq - GROQ_API_KEY (llama-3.3-70b-versatile default) ⭐ FREE
4. OpenRouter - OPENROUTER_API_KEY (llama-3-8b-instruct default)

🧠 RAG System (Retrieval-Augmented Generation)

Production-grade question answering over crypto news using vector search + LLMs.

import { askUltimate, askFast, searchNews } from '@/lib/rag';

// Ask natural language questions
const answer = await askUltimate("What happened to Bitcoin after the ETF approval?");
// Returns: answer + sources + confidence score + suggested follow-ups

// Fast mode for quick queries  
const quick = await askFast("BTC price news");

// Search documents
const results = await searchNews("Ethereum merge", { currencies: ['ETH'] });

RAG Capabilities:

Feature	Description
Hybrid Search	BM25 + semantic vector search with RRF fusion
Query Routing	Intelligent strategy selection (semantic/keyword/temporal/agentic)
Advanced Reranking	LLM reranking + time decay + source credibility + MMR diversity
Self-RAG	Adaptive retrieval with hallucination detection
Contextual Compression	Extract key facts, reduce context to relevant content
Answer Attribution	Inline citations [1], [2] with source quotes
Confidence Scoring	Multi-dimensional quality assessment (high/medium/low)
Conversation Memory	Multi-turn context for follow-up questions
Suggested Questions	AI-generated follow-up questions
Related Articles	Content discovery based on context

Service Modes:

Mode	Function	Speed	Use Case
Fast	askFast()	~220ms	Quick queries, high volume
Balanced	askUltimate()	~520ms	Most use cases (recommended)
Complete	askComplete()	~850ms	Maximum quality, all features

Example Response:

{
  "answer": "Bitcoin rose 10% [1] after the SEC approved spot ETFs [2]...",
  "sources": [
    { "title": "Bitcoin Surges Post-ETF", "source": "CoinDesk", "url": "..." }
  ],
  "confidence": { "overall": 0.87, "level": "high" },
  "suggestedQuestions": [
    { "question": "How did other cryptocurrencies react?", "type": "expansion" }
  ],
  "citations": {
    "claims": [{ "claim": "Bitcoin rose 10%", "sourceIndex": 1 }]
  }
}

📖 Full RAG documentation: docs/RAG.md | Roadmap: docs/RAG-ROADMAP.md

📊 Analytics & Intelligence

Endpoint	Description
/api/analytics/anomalies	Detect unusual patterns (volume spikes/coordinated publishing/sentiment shifts/ticker surges/source outages)
/api/analytics/credibility	Source credibility scoring with accuracy/timeliness metrics
/api/analytics/headlines	Headline mutation tracking with sentiment shift detection
/api/analytics/causality	Causal inference (Granger/diff-in-diff/event study methods)
/api/regulatory	Multi-jurisdictional regulatory tracking (15 jurisdictions, 30+ agencies)
/api/influencers	Influencer reliability scoring with accuracy rates
/api/predictions	Prediction tracking with outcome resolution & leaderboards
/api/citations	Academic citation network with bibliometric metrics

🔗 Relationship & Entity Analysis

Endpoint	Description
/api/relationships	Extract entity relationships (11 types: partnership/competition/investment/acquisition/collaboration/conflict/regulation/development/market_impact/mention/association)
/api/predictions	Prediction registry with timestamped predictions & accuracy scoring
/api/onchain/events	Link news to on-chain events

💼 Portfolio Tools

Endpoint	Description
/api/portfolio	Portfolio-based news + prices
/api/portfolio/performance	Performance charts, P&L, risk metrics
/api/portfolio/tax	Tax report generation (Form 8949)

� Research & Backtesting

Endpoint	Description
/api/research/backtest	Strategy backtesting with historical news data
/api/academic	Academic access program registration
/api/citations	Academic citation network analysis
/api/predictions	Prediction tracking with accuracy scoring

Backtest Example:

# Backtest a sentiment-based strategy
curl -X POST "https://fcn.dev/api/research/backtest" \
  -H "Content-Type: application/json" \
  -d '{"strategy": "sentiment_momentum", "asset": "BTC", "period": "1y"}'

📡 Social Monitoring

Endpoint	Description
/api/social/monitor	Discord & Telegram channel monitoring via webhooks
/api/social/influencer-score	Influencer reliability scoring

Social Monitor Example:

# Ingest messages via webhook integration
curl -X POST "https://fcn.dev/api/social/monitor" \
  -H "Content-Type: application/json" \
  -d '{"platform": "discord", "channel": "alpha-chat", "content": "BTC bullish"}'

🗄️ Data Storage & Export

Endpoint	Description
/api/storage/cas	Content-addressable storage (IPFS-style hashing)
/api/export	Export data in CSV/JSON/Parquet formats
/api/exports	Bulk export job management
/api/exports/[id]	Download export file

�🔔 Real-Time & Infrastructure

Endpoint	Description
/api/sse	Server-Sent Events for real-time news stream
/api/ws	WebSocket connection info & SSE fallback
/api/webhooks	Webhook registration & management
/api/push	Web Push notification registration
/api/newsletter/subscribe	Newsletter subscription
/api/alerts	Price & news alerts
/api/cache	Cache management
/api/views	Article view tracking
/api/keys	API key management
/api/gateway	Unified API gateway
/api/billing	Subscription & billing management
/api/billing/usage	Current billing usage
/api/upgrade	API key tier upgrades (x402)
/api/register	User registration

SSE Real-Time Stream:

const events = new EventSource("/api/sse?sources=coindesk,theblock");
events.onmessage = (e) => console.log(JSON.parse(e.data));

🐦 Social Intelligence

Endpoint	Description
/api/social/discord	Discord channel monitoring
/api/social/x/lists	Manage X/Twitter influencer lists
/api/social/x/sentiment	X sentiment from custom influencer lists

🐦 X/Twitter Sentiment (No API Key!)

Automated X/Twitter sentiment analysis without paid API:

# Get sentiment from default crypto influencers
curl https://fcn.dev/api/social/x/sentiment

# Create custom influencer list
curl -X POST https://fcn.dev/api/social/x/lists \
  -H "Content-Type: application/json" \
  -d '{
    "name": "ETH Builders",
    "users": [
      {"username": "VitalikButerin", "category": "founder", "weight": 0.9},
      {"username": "sassal0x", "category": "influencer", "weight": 0.8}
    ]
  }'

# Get sentiment from your list
curl https://fcn.dev/api/social/x/sentiment?list=list_xxx

Features:

• ✅ No API key required - Uses Nitter RSS feeds
• ✅ Automated cron - Updates every 30 minutes
• ✅ Custom lists - Track your own influencers
• ✅ AI analysis - Groq-powered sentiment scoring
• ✅ Webhook alerts - Discord/Slack/Telegram notifications

📈 Market Data

Endpoint	Description
/api/market/coins	List all coins with market data
/api/market/trending	Trending cryptocurrencies
/api/market/categories	Market categories
/api/market/exchanges	Exchange listings
/api/market/search	Search coins
/api/market/compare	Compare multiple coins
/api/market/history/[coinId]	Historical price data
/api/market/ohlc/[coinId]	OHLC candlestick data
/api/market/snapshot/[coinId]	Real-time coin snapshot
/api/market/social/[coinId]	Social metrics for coin
/api/market/tickers/[coinId]	Trading pairs for coin
/api/market/defi	DeFi market overview
/api/market/derivatives	Derivatives market data
/api/charts	Chart data for visualizations
/api/fear-greed	Crypto Fear & Greed Index with 30-day history

🏗️ DeFi Tools

Endpoint	Description
/api/defi	DeFi news and protocol coverage
/api/defi/protocol-health	Protocol health & risk scoring
/api/defi/protocol-health?action=ranking	Protocol safety rankings
/api/defi/protocol-health?action=incidents	Security incident tracker

Protocol Health Example:

# Get AAVE v3 health score
curl "https://fcn.dev/api/defi/protocol-health?protocol=aave-v3"

# Get top lending protocols by safety
curl "https://fcn.dev/api/defi/protocol-health?action=ranking&category=lending"

# Get recent security incidents
curl "https://fcn.dev/api/defi/protocol-health?action=incidents&limit=20"

📺 Integrations

Endpoint	Description
/api/integrations/tradingview	TradingView widgets & Pine Script generation
/api/tradingview	TradingView webhook receiver

TradingView Example:

# Get chart widget embed code
curl "https://fcn.dev/api/integrations/tradingview?action=widget&type=chart&symbol=BTC"

# Generate Pine Script indicator
curl "https://fcn.dev/api/integrations/tradingview?action=indicator&name=newsAlert"

📊 Trading Tools

Endpoint	Description
/api/arbitrage	Cross-exchange arbitrage scanner with triangular arb
/api/trading/arbitrage	Real-time arbitrage opportunities (spot + triangular)
/api/funding	Funding rate dashboard (Binance, Bybit, OKX, Hyperliquid)
/api/options	Options flow, volatility surface, max pain, gamma exposure
/api/trading/options	Options dashboard from Deribit, OKX, Bybit
/api/liquidations	Real-time liquidations feed (CoinGlass integration)
/api/orderbook	Multi-exchange order book aggregation
/api/trading/orderbook	Aggregated orderbook with slippage & liquidity analysis

Supported Exchanges:

• Arbitrage: Binance, Bybit, OKX, Kraken, Coinbase, KuCoin
• Options: Deribit, OKX, Bybit
• Order Book: Binance, Bybit, OKX, Kraken, Coinbase (aggregated)
• Funding Rates: Binance, Bybit, OKX, Hyperliquid

Arbitrage Features:

• Cross-exchange spot arbitrage
• Triangular arbitrage detection
• Real-time spread monitoring
• Profit estimation with fees
• Volume analysis

Options Analytics:

• Unusual options activity detection
• Volatility surface visualization
• Max pain analysis
• Gamma exposure tracking
• Block trade monitoring

Order Book Analysis:

• Multi-exchange aggregation
• Slippage estimation for orders
• Liquidity depth visualization
• Order book imbalance detection
• Support/resistance levels

Supported Exchanges:

• Arbitrage: Binance, Bybit, OKX, Kraken, Coinbase, KuCoin
• Options: Deribit, OKX, Bybit
• Order Book: Binance, Bybit, OKX, Kraken, Coinbase (aggregated)
• Funding Rates: Binance, Bybit, OKX, Hyperliquid

Arbitrage Features:

• Cross-exchange spot arbitrage
• Triangular arbitrage detection
• Real-time spread monitoring
• Profit estimation with fees
• Volume analysis

Options Analytics:

• Unusual options activity detection
• Volatility surface visualization
• Max pain analysis
• Gamma exposure tracking
• Block trade monitoring

Order Book Analysis:

• Multi-exchange aggregation
• Slippage estimation for orders
• Liquidity depth visualization
• Order book imbalance detection
• Support/resistance levels

Arbitrage Scanner Example:

# Get cross-exchange arbitrage opportunities
curl "https://fcn.dev/api/arbitrage?minProfit=0.5&limit=20"

# Get triangular arbitrage opportunities
curl "https://fcn.dev/api/trading/arbitrage?type=triangular&minSpread=0.3"

Options Flow Example:

# Get options dashboard
curl "https://fcn.dev/api/options?view=dashboard&underlying=BTC"

# Get max pain analysis
curl "https://fcn.dev/api/trading/options?view=maxpain&underlying=ETH"

# Get volatility surface
curl "https://fcn.dev/api/trading/options?view=surface"

Order Book Example:

# Get aggregated order book
curl "https://fcn.dev/api/orderbook?symbol=BTC&market=spot"

# Estimate slippage for $100k order
curl "https://fcn.dev/api/trading/orderbook?symbol=BTCUSDT&view=slippage&size=100000"

🐋 Whale Intelligence

Endpoint	Description
/api/whale-alerts	Monitor large transactions across blockchains
/api/influencers	Influencer reliability tracking & prediction scoring

Whale Alerts Example:

# Get recent whale transactions
curl "https://fcn.dev/api/whale-alerts?limit=50"

# Filter by blockchain
curl "https://fcn.dev/api/whale-alerts?blockchain=ethereum&minUsd=1000000"

🏛️ Regulatory Intelligence

Endpoint	Description
/api/regulatory	Regulatory news with jurisdiction & agency tracking
/api/regulatory?action=jurisdictions	Jurisdiction profiles
/api/regulatory?action=agencies	Agency information
/api/regulatory?action=deadlines	Upcoming compliance deadlines
/api/regulatory?action=summary	Intelligence summary

📰 Coverage & Research

Endpoint	Description
/api/coverage-gap	Analyze under-covered topics and assets
/api/extract	Full article content extraction from URLs
/api/academic	Academic access program for researchers
/api/citations	Citation network analysis for academic papers

💎 Premium API (x402 Micropayments)

Premium endpoints powered by x402 USDC micropayments. Pay per request or get access passes.

Endpoint	Description	Price
/api/premium	Premium API documentation & pricing	Free
/api/premium/ai/sentiment	Advanced AI sentiment analysis	$0.02
/api/premium/ai/analyze	Deep article analysis	$0.03
/api/premium/ai/signals	Premium trading signals	$0.05
/api/premium/ai/summary	Extended summaries	$0.02
/api/premium/ai/compare	Multi-asset AI comparison	$0.03
/api/premium/whales/alerts	Real-time whale alerts	$0.05
/api/premium/whales/transactions	Whale transaction history	$0.03
/api/premium/smart-money	Smart money flow tracking	$0.05
/api/premium/screener/advanced	Advanced coin screener	$0.03
/api/premium/analytics/screener	Analytics screener	$0.03
/api/premium/market/coins	Premium market data	$0.02
/api/premium/market/history	Extended price history	$0.02
/api/premium/defi/protocols	DeFi protocol analytics	$0.03
/api/premium/streams/prices	Real-time price streams	$0.01
/api/premium/portfolio/analytics	Portfolio analytics	$0.03
/api/premium/export/portfolio	Portfolio data export	$0.05
/api/premium/alerts/whales	Whale alert configuration	$0.02
/api/premium/alerts/custom	Custom alert rules	$0.02
/api/premium/api-keys	API key management	Free

Access Passes:

Pass	Price	Duration
1 Hour Pass	$0.25	1 hour
24 Hour Pass	$2.00	24 hours
Weekly Pass	$10.00	7 days

How to Pay:

# 1. Make request, receive 402 with payment requirements
curl https://fcn.dev/api/premium/ai/sentiment

# 2. Pay with USDC using x402-compatible wallet
# 3. Include payment proof in header
curl -H "X-Payment: <base64-payment>" https://fcn.dev/api/premium/ai/sentiment

🔐 Admin API

🔢 Versioned API (v1)

Stable versioned API with x402 micropayment support for production integrations.

Endpoint	Description
/api/v1	API documentation & pricing
/api/v1/coins	Coin listings with market data
/api/v1/coin/[coinId]	Individual coin details
/api/v1/market-data	Global market data
/api/v1/trending	Trending coins
/api/v1/search	Search coins
/api/v1/exchanges	Exchange listings
/api/v1/defi	DeFi protocols data
/api/v1/gas	Gas price tracker
/api/v1/global	Global crypto market stats
/api/v1/assets	Asset listings
/api/v1/assets/[assetId]/history	Asset price history
/api/v1/historical/[coinId]	Historical data
/api/v1/alerts	Price alerts
/api/v1/export	Data export
/api/v1/usage	API usage stats
/api/v1/x402	x402 payment info

💡 AI endpoints require GROQ_API_KEY (free at console.groq.com)

---

🖥️ Web App Pages

The web app includes 95+ pages for market data, portfolio management, AI tools, and more:

Page Breakdown: 52 server components + 43 client components across 14 major categories.

Market Data

Page	Description
/markets	Market overview with global stats and coin tables
/markets/gainers	🆕 Top gaining coins (24h)
/markets/losers	🆕 Top losing coins (24h)
/markets/trending	🆕 Trending coins by volume & social
/markets/new	🆕 Newly listed cryptocurrencies
/markets/exchanges	🆕 Exchange directory with volumes
/trending	Trending cryptocurrencies
/movers	Top gainers and losers (24h)

Market Tools

Page	Description
/calculator	Crypto calculator with conversion & P/L
/gas	Ethereum gas tracker with cost estimates
/heatmap	Market heatmap visualization
/screener	Advanced coin screener with filters
/correlation	Price correlation matrix (7/30/90 days)
/dominance	Market cap dominance chart
/liquidations	Real-time liquidations feed
/buzz	Social buzz & trending sentiment
/charts	TradingView-style charts

Trading Tools

Page	Description
/arbitrage	Cross-exchange arbitrage scanner
/options	Options flow & analytics dashboard
/orderbook	Multi-exchange order book view

Coin Details

Page	Description
/coin/[coinId]	Comprehensive coin page with charts, stats, news
/compare	Compare multiple cryptocurrencies side-by-side

AI & Analytics

Page	Description
/ai/oracle	The Oracle - AI crypto assistant
/ai/brief	AI-generated market brief
/ai/debate	AI Bull vs Bear debate generator
/ai/counter	AI counter-argument generator
/sentiment	Sentiment analysis dashboard
/analytics	News analytics overview
/analytics/headlines	🆕 Headline tracking & mutations
/predictions	Prediction tracking & leaderboard
/digest	AI-generated daily digest

Social & Influencers

Page	Description
/influencers	Influencer reliability leaderboard
/whales	Whale alerts & tracking
/buzz	Social buzz & trending sentiment

Research & Intelligence

Page	Description
/regulatory	Regulatory intelligence dashboard
/coverage-gap	Coverage gap analysis
/protocol-health	DeFi protocol health monitor

User Features

Page	Description
/portfolio	Portfolio management with holdings tracking
/watchlist	Watchlist with price alerts
/bookmarks	🆕 Saved articles & reading list
/settings	User preferences and notifications
/install	🆕 PWA installation guide

Content

Page	Description
/search	Search news articles
/topic/[topic]	Topic-specific news
/topics	Browse all topics
/source/[source]	Source-specific news
/sources	All news sources
/category/[category]	Category-specific news
/article/[id]	Individual article view
/read/[id]	🆕 Distraction-free reader mode
/share/[id]	🆕 Share & embed articles
/defi	DeFi news section
/blog	Blog posts

Administration

Page	Description
/billing	Billing & subscription management
/pricing	Pricing plans
/developers	Developer documentation

---

SDKs & Components

📊 Component & Library Overview

Total Components: 185+ React components organized in 10 directories
Total Library Functions: 298+ exported functions across 90+ library files
Custom Hooks: 5 React hooks for state management

Component Distribution:

• Root Level: 133 components (~65 Client, ~68 Server)
• cards/: 10 article display variants
• charts/: 4 TradingView integrations
• portfolio/: 7 portfolio management components
• watchlist/: 4 watchlist features
• alerts/: 4 price alert components
• billing/: 3 subscription management
• sidebar/: 4 sidebar widgets

Library Categories:

• AI/ML: 12 files, 45 functions (sentiment, summarization, NER, signals)
• Market Data: 10 files, 60 functions (prices, OHLC, exchanges, DeFi)
• Social Intelligence: 3 files, 20 functions (Twitter, Discord, Telegram)
• Analytics: 10 files, 40 functions (backtesting, predictions, anomalies)
• Database: 2 files, 25 functions (storage abstraction, CAS)
• Auth & Security: 4 files, 15 functions (API keys, rate limiting)
• x402 Payments: 9 files, 35 functions (payment protocol, verification)
• Utilities: 12 files, 50 functions (validation, logging, translation)

📦 Official SDKs

Package	Description	Version
React	<CryptoNews /> drop-in components	v0.1.0
TypeScript	Full TypeScript SDK with type safety	v0.1.0
Python	Zero-dependency Python clien