---

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

🤖 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

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

---

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

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

---

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

---

📚 Historical Archive

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

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

Data Sources:

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

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

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

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

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

---

🌿 Branches

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

To try the redesign locally:

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

---

🌍 International News Sources

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

Supported Sources by Language

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

Legacy Region View

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

Quick Examples

cURL:

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

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

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

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

Python:

import requests

BASE_URL = "https://cryptocurrency.cv"

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

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

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

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

JavaScript:

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

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

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

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

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

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

Features

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

See API docs for full details.

---

📱 Progressive Web App (PWA)

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

Features

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

Install the App

Desktop (Chrome/Edge):

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

iOS Safari:

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

Android Chrome:

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

Service Worker Caching

The PWA uses smart caching strategies:

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

Keyboard Shortcuts

Power through news with keyboard navigation:

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

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

---

🌐 Interactive Pages

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

📰 News & Content

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

📊 Market Data

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

🧠 AI Analysis

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

🔬 Research Tools

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

⚙️ User Features

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

📖 Documentation & Tools

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

🎨 UI/UX Features

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

---

Generate PNG Icons

SVG icons work in modern browsers. For legacy support:

npm install sharp
npm run pwa:icons

---

Sources

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

Source Tiers

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

🏠 Homepage Feed (curated high-signal sources)

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

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

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

---

Endpoints

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

📂 Category Filter

Filter news by specialized categories:

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

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

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

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

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

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

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

🌍 API Translation (18 Languages)

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

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

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

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

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

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

Requirements:

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

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

🤖 AI-Powered Endpoints (FREE via Groq)

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

Supported AI Providers (priority order):

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

🧠 RAG System (Retrieval-Augmented Generation)

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

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

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

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

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

RAG Capabilities:

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

Service Modes:

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

Example Response:

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

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

📊 Analytics & Intelligence

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

🔗 Relationship & Entity Analysis

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

💼 Portfolio Tools

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

� Research & Backtesting

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

Backtest Example:

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

📡 Social Monitoring

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

Social Monitor Example:

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

🗄️ Data Storage & Export

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

�🔔 Real-Time & Infrastructure

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

SSE Real-Time Stream:

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

🐦 Social Intelligence

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

🐦 X/Twitter Sentiment (No API Key!)

Automated X/Twitter sentiment analysis without paid API:

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

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

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

Features:

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

📈 Market Data

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

🏗️ DeFi Tools

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

Protocol Health Example:

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

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

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

📺 Integrations

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

TradingView Example:

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

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

📊 Trading Tools

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

Supported Exchanges:

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

Arbitrage Features:

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

Options Analytics:

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

Order Book Analysis:

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

Supported Exchanges:

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

Arbitrage Features:

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

Options Analytics:

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

Order Book Analysis:

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

Arbitrage Scanner Example:

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

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

Options Flow Example:

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

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

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

Order Book Example:

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

# Estimate slippage for $10