Summary
Aggregates cryptocurrency news from over 200 sources including major outlets like CoinDesk, Cointelegraph, and regional sources across 18 languages with automatic English translation. Exposes news retrieval actions through both HTTP and stdio MCP modes, letting Claude pull current crypto headlines or search through a historical archive of 662,000+ articles dating back to 2017. Requires no authentication and includes ticker-specific filtering for Bitcoin, Ethereum, and other cryptocurrencies. The server connects to the cryptocurrency.cv API with 150+ endpoints, making it straightforward to add real-time crypto news capabilities to Claude conversations without API key management.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →🌐 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
🤖 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
Quick Start • SDKs • API • CLI • Docker • K8s • Docs
⭐ 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):
- Visit cryptocurrency.cv
- Click the install icon (⊕) in the address bar
- Click "Install"
iOS Safari:
- Visit the site in Safari
- Tap Share (📤) → "Add to Home Screen"
Android Chrome:
- Visit the site
- 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_KEYenvironment variable (FREE at console.groq.com/keys) - Translation is auto-enabled when
GROQ_API_KEYis 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):
- OpenAI -
OPENAI_API_KEY(gpt-4o-mini default) - Anthropic -
ANTHROPIC_API_KEY(claude-3-haiku default) - Groq -
GROQ_API_KEY(llama-3.3-70b-versatile default) ⭐ FREE - 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
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
