
Free Crypto News
★ 251from nirholas
Free crypto news API + MCP - real-time aggregator for Bitcoin, Ethereum, DeFi, Solana & altcoins. No API key required. RSS/Atom feeds, JSON REST API, historical archive with market context, embeddable widgets, ChatGPT plugin, Claude MCP server, SDKs (Python, TypeScript, Go, React, PHP). AI/LLM ready. Vibe coding friendly. Open source.
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):
- 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:iconsSources
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_xxxFeatures:
- ✅ 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 client | v0.1.0 |
| JavaScript | Browser & Node.js SDK | v0.1.0 |
| Go | Go client library | v0.1.0 |
| PHP | PHP SDK | v0.1.0 |
| Ruby | Ruby gem with async support | v0.2.0 |
| Rust | Rust crate with async/sync clients | v0.2.0 |
| UI Components | Internal navigation & search components | - |
🔌 Platform Integrations
Total Integrations: 8 official SDKs + 5 platform integrations + 200+ code examples
| Integration | Description | Documentation | Status |
|---|---|---|---|
| ChatGPT | Custom GPT with OpenAPI schema | Guide | ✅ Production |
| MCP Server | Model Context Protocol (stdio + HTTP/SSE) | Guide | ✅ Production |
| Chrome Extension | Browser extension (Manifest V3) | Guide | ✅ Chrome Ready |
| Alfred Workflow | macOS Alfred 4+ integration | Guide | ✅ Production |
| Raycast | Raycast extension (6 commands) | Guide | ✅ Production |
| Widgets | 3 embeddable widget types | Guide | ✅ Production |
| CLI | Command-line interface | README | ✅ Production |
| Postman | Postman collection (182 endpoints) | README | ✅ Complete |
Widget Types:
| Widget | Type | Use Case |
|---|---|---|
| Main Widget | iframe | Full news feed embed |
| Ticker | JavaScript | Scrolling header ticker |
| Carousel | JavaScript | Featured news rotator |
📡 Nostr Integration
Decentralized news distribution via the Nostr protocol (NIP-23 long-form content):
# Publish latest news to Nostr relays
curl -X POST https://cryptocurrency.cv/api/nostr \
-H "Content-Type: application/json" \
-d '{"action": "publish", "limit": 10}'
# Get Nostr event IDs for published articles
curl https://cryptocurrency.cv/api/nostr?action=eventsArticles are published as NIP-23 long-form events to configured Nostr relays, enabling censorship-resistant news distribution.
🧩 Knowledge Graph API
Explore entity relationships across the crypto news landscape:
# Get entity graph for Bitcoin
curl "https://cryptocurrency.cv/api/knowledge-graph?entity=Bitcoin&depth=2"
# Filter by relationship type
curl "https://cryptocurrency.cv/api/knowledge-graph?entity=Ethereum&type=partnership"
# Get full graph snapshot
curl "https://cryptocurrency.cv/api/knowledge-graph?action=snapshot"Returns entities (people, companies, protocols, exchanges) and their relationships (partnerships, investments, acquisitions, competitions) as a traversable graph.
🎙️ AI Podcast Generation
Generate AI-narrated crypto news podcasts on demand:
# Generate flash briefing (2 min)
curl "https://cryptocurrency.cv/api/podcast?format=flash"
# Deep-dive analysis (10 min)
curl "https://cryptocurrency.cv/api/podcast?format=deep-dive&topic=BTC"
# Market open briefing
curl "https://cryptocurrency.cv/api/podcast?format=market-open"
# Weekly recap
curl "https://cryptocurrency.cv/api/podcast?format=weekly-recap"
# Subscribe via podcast RSS
curl "https://cryptocurrency.cv/api/podcast/feed"Formats: flash (2 min), deep-dive (10 min), market-open (5 min), weekly-recap (15 min)
Voices: 3 voice options (professional, casual, technical)
🗣️ Alexa Skill
Voice-activated crypto news for Amazon Echo devices:
"Alexa, ask Crypto News for the latest headlines" "Alexa, ask Crypto News about Bitcoin" "Alexa, ask Crypto News for DeFi updates"
# Alexa skill handler
curl -X POST https://cryptocurrency.cv/api/alexa \
-H "Content-Type: application/json" \
-d '{"request": {"type": "IntentRequest", "intent": {"name": "GetNewsIntent"}}}'🖼️ Farcaster Frames
Interactive news frames for Warpcast and Farcaster clients:
# Get interactive news frame
curl "https://cryptocurrency.cv/api/frames"
# Frame with specific topic
curl "https://cryptocurrency.cv/api/frames?topic=bitcoin"Frames support inline article previews, sentiment badges, and action buttons directly within the Farcaster social feed.
🔍 Vector Search
Semantic search across the article archive using vector embeddings:
# Semantic search (finds conceptually similar articles)
curl "https://cryptocurrency.cv/api/vector-search?q=institutional+adoption+impact+on+market"
# With filters
curl "https://cryptocurrency.cv/api/vector-search?q=defi+security+vulnerabilities&source=coindesk&limit=20"🔬 Anomaly Detection
Advanced anomaly detection across the news landscape:
# Detect all anomalies
curl "https://cryptocurrency.cv/api/anomalies"
# Specific anomaly types
curl "https://cryptocurrency.cv/api/anomalies?type=sentiment-acceleration"
curl "https://cryptocurrency.cv/api/anomalies?type=price-narrative-divergence"
curl "https://cryptocurrency.cv/api/anomalies?type=news-velocity"Anomaly Types:
- News Velocity — Unusual spike in article volume for a topic
- Sentiment Acceleration — Rapid sentiment shifts in short timeframes
- Price-Narrative Divergence — When news sentiment diverges from price action
- Coordinated Publishing — Multiple sources publishing similar content simultaneously
- Source Outage — Expected source goes silent
🎮 Gaming & Chain-Specific APIs
| Endpoint | Description |
|---|---|
/api/gaming | Blockchain gaming market data with chain breakdown |
/api/sui | Sui blockchain data (balances, objects, transactions) |
/api/aptos | Aptos blockchain data (events, resources, transactions) |
/api/hyperliquid | Hyperliquid DEX trading data |
🎓 Academic Research Portal
Full-featured academic access program for researchers and institutions:
# Register institution
curl -X POST https://cryptocurrency.cv/api/academic \
-H "Content-Type: application/json" \
-d '{
"institution": "MIT Media Lab",
"email": "researcher@mit.edu",
"purpose": "Crypto market microstructure research",
"irb_approval": "IRB-2026-0142"
}'
# Add co-investigators
curl -X POST https://cryptocurrency.cv/api/academic \
-H "Content-Type: application/json" \
-d '{"action": "add_investigator", "email": "postdoc@mit.edu", "role": "co-pi"}'Benefits: Unlimited API access, historical data exports, citation network access, priority support, co-investigator management, IRB approval tracking.
🤖 AI Agent Skills
7 pre-built AI agent skills following the agentskills.io standard, compatible with Claude Code and Codex:
| Skill | Description |
|---|---|
crypto-news-briefing | Generate comprehensive news briefings |
market-sentiment | Analyze market sentiment across sources |
coin-research | Deep-dive research on any cryptocurrency |
rug-pull-news-check | Scan news for rug pull warning signs |
historical-trend-analysis | Analyze historical news trends |
scale-to-1m | Scale the system to 1M+ requests/day |
add-data-sources | Add new RSS/API data sources |
Skills are located in /skills/ and can be loaded by AI coding agents for autonomous development tasks.
🖥️ GitHub Copilot Extension
Crypto news directly in your VS Code editor via Copilot Chat:
@crypto-news /breaking — Breaking crypto news
@crypto-news /market — Market overview
@crypto-news /prices — Top coin prices
@crypto-news /feargreed — Fear & Greed Index
@crypto-news /whale — Recent whale alerts
@crypto-news /trending — Trending topicsAlso supports natural language queries: "@crypto-news What's happening with Ethereum?"
Install from the VS Code Marketplace or build from source: /copilot-extension/
🖥️ Terminal Dashboard
Full-screen terminal dashboard with real-time news updates:
# Launch terminal dashboard
node terminal/dashboard.js
# With custom API URL
API_URL=http://localhost:3000 node terminal/dashboard.jsFeatures:
- Real-time SSE streaming updates
- ASCII art dashboard layout with blessed UI
- Keyboard shortcuts for navigation and filtering
- Multiple view modes (all news, breaking only, by source)
- Works over SSH — perfect for headless servers
See /terminal/ for details.
🧠 RAG AI System
Production-grade Retrieval-Augmented Generation for intelligent crypto news Q&A.
| Feature | Description |
|---|---|
| Hybrid Search | BM25 + semantic search with reciprocal rank fusion |
| Multi-hop Reasoning | Agentic RAG for complex questions requiring multiple articles |
| Conversation Memory | Multi-turn chat with context tracking |
| Advanced Reranking | LLM scoring, time decay, source credibility, MMR diversity |
| Query Understanding | Intent classification, decomposition, HyDE |
| Streaming API | Real-time SSE responses with step-by-step updates |
Quick Start:
import { ragService } from '@/lib/rag';
// Simple question answering
const response = await ragService.ask("What happened to Bitcoin last week?");
console.log(response.answer);
// Multi-hop reasoning for complex questions
const reasoning = await ragService.askWithReasoning(
"How did the ETF approval affect Bitcoin compared to Ethereum?"
);API Endpoints:
# Standard RAG query
curl -X POST /api/rag -d '{"query": "Latest Bitcoin news"}'
# Streaming with progress updates
curl -N -X POST /api/rag/stream -d '{"query": "Why did crypto crash?"}'
# Search without answer generation
curl -X POST /api/rag/search -d '{"query": "DeFi hacks", "limit": 10}'📚 Full RAG Documentation — Architecture, API reference, configuration, and advanced features.
🚀 Code Examples & SDKs (200+ Examples)
Complete examples for all 184 API endpoints across 5 languages:
| Language | Files | Functions | Description |
|---|---|---|---|
| Python | 12 files | 150+ | Full SDK with all endpoints |
| JavaScript | 11 files | 120+ | Node.js & browser examples |
| TypeScript | 3 files | 80+ | Type-safe SDK |
| Go | 1 file | 60+ | Go client library |
| cURL | 1 file | 100+ | Shell script examples |
Python Example Files:
news.py- News feeds, search, categories (13 functions)ai.py- Sentiment, summarization, NLP (20 functions)market.py- Coins, OHLC, exchanges (16 functions)trading.py- Arbitrage, signals, funding (10 functions)social.py- Twitter, Reddit, Discord (15 functions)blockchain.py- DeFi, NFT, on-chain (17 functions)regulatory.py- ETF, SEC, regulations (14 functions)analytics.py- Trends, correlations (15 functions)feeds.py- RSS, exports, webhooks (13 functions)portfolio.py- Alerts, watchlists (15 functions)premium.py- Premium tier features (12 functions)
Quick Start (Python):
import requests
BASE_URL = "https://cryptocurrency.cv"
# Get latest news
news = requests.get(f"{BASE_URL}/api/news?limit=10").json()
# Get Bitcoin sentiment
sentiment = requests.get(f"{BASE_URL}/api/ai/sentiment?asset=BTC").json()
print(f"BTC: {sentiment['label']} ({sentiment['score']:.2f})")
# Get Fear & Greed
fg = requests.get(f"{BASE_URL}/api/market/fear-greed").json()
print(f"Market: {fg['classification']} ({fg['value']})")Quick Start (JavaScript):
const BASE_URL = 'https://cryptocurrency.cv';
// Get latest news
const news = await fetch(`${BASE_URL}/api/news?limit=10`).then(r => r.json());
// Stream real-time updates
const events = new EventSource(`${BASE_URL}/api/stream`);
events.onmessage = (e) => console.log('New:', JSON.parse(e.data).title);📚 Full Examples Documentation | API Tutorial
Bot Integration Examples:
| Example | Language | File | Purpose |
|---|---|---|---|
| AI Analysis | Python | examples/ai-analysis.py | Sentiment & summarization |
| LangChain Tool | Python | examples/langchain-tool.py | AI agent integration |
| Discord Bot | JavaScript | examples/discord-bot.js | Channel posting |
| Telegram Bot | Python | examples/telegram-bot.py | Command handler |
| Telegram Digest | Python | examples/telegram-digest.py | Scheduled digests |
| Slack Bot | JavaScript | examples/slack-bot.js | Webhook posting |
| Real-time Stream | JavaScript | examples/realtime-stream.js | SSE streaming |
| curl Examples | Shell | examples/curl.sh | API testing |
| x402 Python | Python | examples/x402-client.py | Payment protocol |
| x402 TypeScript | TypeScript | examples/x402-client.ts | Payment protocol |
| x402 Go | Go | examples/x402-client.go | Payment protocol |
📖 Complete API Tutorials
Step-by-step tutorials with full working code for every API endpoint:
| Tutorial | Endpoints Covered | Description |
|---|---|---|
| News Basics | /api/news, /api/latest, /api/breaking, /api/trending | Fetching, filtering, and paginating news articles |
| Search & Filtering | /api/search, /api/news?source=, /api/categories | Full-text search, source filtering, category browsing |
| Archive & Export | /api/archive, /api/export, /api/rss, /api/atom | Historical data access, bulk exports, RSS/Atom feeds |
| International News | /api/news/international, /api/sources/international, /api/languages, /api/regions | Multi-language news with auto-translation |
| AI Sentiment | /api/ai/sentiment, /api/ai/sentiment/history, /api/ai/sentiment/market | Real-time sentiment analysis for any asset |
| AI Features | /api/ask, /api/summarize, /api/digest, /api/entities, /api/narratives, /api/signals | Q&A, summarization, NER, narratives, trading signals |
| Trading Signals | /api/trading/arbitrage, /api/trading/signals, /api/trading/funding | Arbitrage opportunities, AI signals, funding rates |
| Market Data | /api/market/coins, /api/market/ohlc, /api/market/fear-greed, /api/market/dominance | Price data, OHLCV, market indicators |
| DeFi & NFT | /api/defi, /api/defi/protocols, /api/defi/yields, /api/nft, /api/nft/collections | DeFi protocols, yield farming, NFT analytics |
| Analytics & Research | /api/analytics/trends, /api/analytics/correlations, /api/research | Market analytics, correlation analysis, research tools |
| [Social Intelligence](https://github.com/nirholas/free-crypto-news/blob/HEAD/docs/tutorials/social-intelligen |
git checkout redesign/pro-news-ui
npm install && npm run devBefore it works, you'll need: GROQ_API_KEYGROQ_API_KEYOPENAI_API_KEYANTHROPIC_API_KEYGROQ_API_KEYOPENROUTER_API_KEY
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.