Free Crypto News — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Free Crypto News (Agent Skill) and scored it 96/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 1 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 1 flagged
The text {match} tells the agent to skip the normal "ask the user first" gate. Used adversarially it removes the human-in-the-loop check before destructive or sensitive actions, turning a normally-gated agent into a fire-and-forget executor.
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
🌐 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 | 简体中文 | 繁體中文
<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>
curl https://cryptocurrency.cv/api/news • LLM Docs • Full API Docs • OpenAPInpx @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 |
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:
# 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.
| 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 devGet crypto news from 75 international sources across 18 languages — with automatic English translation!
| 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 |
| 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 |
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](docs/tutorials/index.md) — 19 comprehensive guides covering 150+ endpoints with complete working code.
See API docs for full details.
Free Crypto News is a fully installable PWA that works offline!
| 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 |
Desktop (Chrome/Edge):
iOS Safari:
Android Chrome:
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 |
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
The web interface provides rich, interactive pages for exploring crypto data:
| 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 |
| 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 |
| 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 |
| 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 |
| Page | Description |
|---|---|
/settings | User preferences & themes |
/watchlist | Personalized watchlist |
/bookmarks | Saved articles |
/saved | Saved content manager |
/read | Reading list |
/digest | Personalized news digest |
| 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 |
| 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 |
SVG icons work in modern browsers. For legacy support:
npm install sharp
npm run pwa:iconsWe 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.
| 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 |
The homepage fetches only from a curated subset focused on quality and signal-to-noise:
All other endpoints (/api/news, /api/search, category filters, etc.) query the full source list.
| 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) |
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
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:
GROQ_API_KEY environment variable (FREE at console.groq.com/keys)GROQ_API_KEY is setEndpoints 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 |
| 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_API_KEY (gpt-4o-mini default)ANTHROPIC_API_KEY (claude-3-haiku default)GROQ_API_KEY (llama-3.3-70b-versatile default) ⭐ FREEOPENROUTER_API_KEY (llama-3-8b-instruct default)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
| 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 |
| 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 |
| 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) |
| 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"}'| 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"}'| 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 |
| 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));| 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 |
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:
| 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 |
| 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"| 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"| 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 Features:
Options Analytics:
Order Book Analysis:
Supported Exchanges:
Arbitrage Features:
Options Analytics:
Order Book Analysis:
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"| 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"| 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 |
| 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 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/sentimentStable 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)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.
| 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) |
| 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 |
| Page | Description |
|---|---|
/arbitrage | Cross-exchange arbitrage scanner |
/options | Options flow & analytics dashboard |
/orderbook | Multi-exchange order book view |
| Page | Description |
|---|---|
/coin/[coinId] | Comprehensive coin page with charts, stats, news |
/compare | Compare multiple cryptocurrencies side-by-side |
| 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 |
| Page | Description |
|---|---|
/influencers | Influencer reliability leaderboard |
/whales | Whale alerts & tracking |
/buzz | Social buzz & trending sentiment |
| Page | Description |
|---|---|
/regulatory | Regulatory intelligence dashboard |
/coverage-gap | Coverage gap analysis |
/protocol-health | DeFi protocol health monitor |
| 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 |
| 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 |
| Page | Description |
|---|---|
/billing | Billing & subscription management |
/pricing | Pricing plans |
/developers | Developer documentation |
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:
Library Categories:
| 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 | - |
Total Integrations: 8 official SDKs + 5 platform integrations + 200+ code examples
| Integration | Description | Documentation | Status |
|---|---|---|---|
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.