Labsco
nirholas logo

Free Crypto News

251

from 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.

🔥🔥🔥✓ VerifiedPaid serviceAdvanced setup

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/newsLLM DocsFull API DocsOpenAPI

• 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.

Copy & paste — that's it
curl https://cryptocurrency.cv/api/news

Free Crypto NewsCryptoPanicOthers
Price🆓 Free forever$29-299/moPaid
API Key❌ None neededRequiredRequired
Rate LimitUnlimited*100-1000/dayLimited
Sources130+ English + 75 International1Varies
Historical📚 662,000+ articles (2017-2026)LimitedNone
International🌏 KO, ZH, JA, ES + translationNoNo
Self-host✅ One click (Vercel/Docker/K8s)NoNo
PWA✅ InstallableNoNo
MCP✅ Claude + ChatGPTNoNo
SDKs13 languages01-2
AI Features30+ AI endpoints (FREE)NoNo
Voice✅ Alexa + PodcastsNoNo

📚 Historical Archive

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

MetricValue
Total Articles662,047
Date RangeSeptember 2017 - February 2025
LanguagesEnglish + Chinese
Unique Sources100+
Top TickersBTC (81k), ETH (50k), USDT (19k), SOL (16k), XRP (13k)
Search Terms79,512 indexed

Data Sources:

  • CryptoPanic — 346,031 articles from 200+ English sources
  • Odaily 星球日报 — 316,016 Chinese crypto news articles
Copy & paste — that's it
# 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

BranchDescription
mainStable production branch — Original API-focused design

To try the redesign locally:

Copy & paste — that's it
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

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

Copy & paste — that's it
# 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:

Copy & paste — that's it
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:

Copy & paste — that's it
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

FeatureDescription
📲 InstallableAdd to home screen on any device
📴 Offline ModeRead cached news without internet
🔔 Push NotificationsGet breaking news alerts
Lightning FastAggressive caching strategies
🔄 Background SyncAuto-updates when back online
🎯 App ShortcutsQuick access to Latest, Breaking, Bitcoin
📤 Share TargetShare links directly to the app
🚨 Real-Time AlertsConfigurable 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:

ContentStrategyCache Duration
API responsesNetwork-first5 minutes
Static assetsCache-first7 days
ImagesCache-first30 days
NavigationNetwork-first + offline fallback24 hours

Keyboard Shortcuts

Power through news with keyboard navigation:

ShortcutAction
j / kNext / previous article
/Focus search
EnterOpen selected article
dToggle dark mode
g hGo to Home
g tGo to Trending
g sGo to Sources
g bGo to Bookmarks
?Show all shortcuts
EscapeClose modal

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


🌐 Interactive Pages

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

📰 News & Content

PageDescription
/Home page with latest news feed
/trendingTrending topics & sentiment
/searchFull-text search with filters
/sourcesBrowse news by source
/source/[id]Individual source page
/tags/[slug]Tag-based news filtering
/article/[slug]Article detail page
/topic/[slug]Topic-based news
/topicsAll topics overview
/buzzSocial buzz & mentions

📊 Market Data

PageDescription
/marketsMarket overview with prices
/markets/categoriesMarket categories browser
/coin/[coinId]Detailed coin page (CoinGecko-quality)
/fear-greedFear & Greed Index with breakdown
/fundingFunding rates across exchanges
/signalsAI trading signals (educational)
/whalesWhale alert tracking
/orderbookOrder book visualization
/liquidationsLiquidation tracking
/dominanceMarket dominance charts
/moversTop gainers/losers
/heatmapMarket heatmap visualization
/gasETH gas tracker
/arbitrageArbitrage opportunities
/optionsOptions market data
/oracleOracle price feeds

🧠 AI Analysis

PageDescription
/aiAI analysis dashboard
/factcheckClaim verification dashboard
/entitiesEntity extraction viewer
/claimsExtracted claims browser
/clickbaitClickbait detection & scoring
/narrativesMarket narrative tracking
/onchainOn-chain event correlation
/originsOriginal source finder
/citationsCitation network explorer
/sentimentSentiment analysis
/coverage-gapCoverage gap analysis

🔬 Research Tools

PageDescription
/backtestNews-based strategy backtesting
/influencersInfluencer prediction tracking
/predictionsPrediction market integration
/portfolioPortfolio-based news feed
/screenerCustom news screener
/correlationNews-price correlation analysis

⚙️ User Features

PageDescription
/settingsUser preferences & themes
/watchlistPersonalized watchlist
/bookmarksSaved articles
/savedSaved content manager
/readReading list
/digestPersonalized news digest

📖 Documentation & Tools

PageDescription
/developersDeveloper portal & API docs
/examplesCode examples & demos
/aboutAbout the project
/pricingPricing tiers
/installInstallation guide
/blogProject blog
/calculatorCrypto calculator
/compareCoin comparison
/chartsAdvanced charting
/analyticsUsage analytics
/regulatoryRegulatory tracking
/statusSystem health dashboard

🎨 UI/UX Features

FeatureDescription
Skeleton LoadingFull-page loading skeletons during navigation
Swipe GesturesSwipe-to-close mobile navigation
Bookmark/ShareQuick action buttons on news cards
Scroll IndicatorsFade edges + arrows for horizontal scroll
Dark ModeSystem-aware with flash prevention
Reduced MotionRespects prefers-reduced-motion
AccessibilitySkip links, focus rings, ARIA labels

Generate PNG Icons

SVG icons work in modern browsers. For legacy support:

Copy & paste — that's it
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

TierCredibilityReputationExamples
Tier 1 — Mainstream / institutional0.88–0.9890–100Bloomberg, Reuters, WSJ, FT, CNBC, Forbes
Tier 2 — Premium crypto-native0.86–0.9565–90CoinDesk, The Block, Blockworks, Decrypt, The Defiant
Tier 3 — Established crypto news0.68–0.8260–80CoinTelegraph, Bitcoin Magazine, Bitcoinist
Tier 4 — Aggregators & volume0.60–0.6850–60Crypto.news, AMBCrypto, CryptoPotato
Research — Institutional & VC0.90–0.9470–72Messari, Delphi, Paradigm, a16z
Fintech — Payments (deprioritized)0.40–0.5030–35Finextra, 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

EndpointDescription
/api/newsLatest from all sources
/api/news?category=institutionalFilter by category
/api/news/categoriesList all categories
/api/news/internationalInternational sources with translation
/api/search?q=bitcoinSearch by keywords
/api/defiDeFi-specific news
/api/bitcoinBitcoin-specific news
/api/breakingLast 2 hours only
/api/trendingTrending topics with sentiment
/api/tagsTag discovery and filtering
/api/archiveHistorical news archive
/api/archive/statusArchive health status
/api/rssRSS 2.0 feed
/api/atomAtom feed
/api/opmlOPML export for RSS readers
/api/healthAPI health check
/api/cacheCache statistics
/api/statsAPI usage statistics
/api/webhooksWebhook registration
/api/pushWeb Push notifications
/api/newsletterNewsletter subscription
/api/alertsConfigurable alert rules
/api/sseServer-Sent Events stream
/api/wsWebSocket connection info
/api/exportData export (JSON, CSV, Parquet)
/api/exportsBulk export job management
/api/storage/casContent-addressable storage
/api/viewsArticle view tracking
/api/registerAPI key registration
/api/keysAPI key management
/api/gatewayUnified API gateway for integrations
/api/docsInteractive Swagger UI documentation
/api/openapi.jsonOpenAPI 3.1 specification
/api/v1/Legacy v1 API endpoints
/api/market/orderbookOrder book depth for trading pairs
/api/socialAggregated social media trends
/api/social/monitorReal-time social monitoring
/api/premium/streams/orderbookReal-time order book stream
/api/premium/streams/liquidationsReal-time liquidation stream
/api/premium/export/historyHistorical data export
/api/cron/archiveArchive maintenance (cron job)
/api/cron/socialSocial data collection (cron job)
/api/cron/feedsFeed health monitoring (cron job)
/api/market/orderbookOrder book depth for trading pairs
/api/socialAggregated social media trends
/api/social/monitorReal-time social monitoring
/api/premium/streams/orderbookReal-time order book stream
/api/premium/streams/liquidationsReal-time liquidation stream
/api/premium/export/historyHistorical data export
/api/cron/archiveArchive maintenance (cron job)
/api/cron/socialSocial data collection (cron job)
/api/cron/feedsFeed health monitoring (cron job)

📂 Category Filter

Filter news by specialized categories:

Copy & paste — that's it
# 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:

Copy & paste — that's it
# 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/trendingTrending topics with sentiment
/api/analyzeNews with topic classification
/api/statsAnalytics & statistics
/api/sourcesList all sources
/api/healthAPI & feed health status
/statusSystem status dashboard (UI)
/api/rssAggregated RSS feed
/api/atomAggregated Atom feed
/api/opmlOPML export for RSS readers
/api/docsInteractive API documentation
/api/webhooksWebhook registration
/api/archiveHistorical news archive
/api/pushWeb Push notifications
/api/originsFind original news sources
/api/portfolioPortfolio-based news + prices
/api/news/internationalInternational sources with translation

🤖 AI-Powered Endpoints (FREE via Groq)

EndpointDescriptionProvider
/api/aiUnified AI endpoint (7 actions)All
/api/summarizeAI summaries with style options (brief/detailed/bullet/eli5/technical)Groq
/api/ask?q=...Ask questions about crypto newsGroq
/api/digestAI-generated news digest (6h/12h/24h periods)Groq
/api/sentimentDeep sentiment analysis with confidence scoresGroq
/api/entitiesExtract entities (7 types: ticker/person/company/protocol/exchange/regulator/event)Groq
/api/narrativesIdentify market narratives with strength scoringGroq
/api/factcheckExtract & verify claims (verified/likely/unverified/disputed)Groq
/api/clickbaitDetect clickbait with scoring (0-100) and rewritten titlesGroq
/api/classifyEvent classification (13 types: funding/hack/regulation/launch/partnership/listing/airdrop/upgrade/legal/market/executive/acquisition/general)All
/api/claimsClaim extraction with attribution (fact/opinion/prediction/announcement)All
/api/ai/briefDaily brief with executive summary & market overviewAll
/api/ai/counterCounter-arguments with strength scoringAll
/api/ai/debateBull vs Bear debate generationAll
/api/ai/oracleThe Oracle - natural language crypto intelligence chatGroq
/api/ai/summarizeEnterprise summarization with compression ratioGroq
/api/ai/entitiesEnterprise entity extraction with graph supportGroq
/api/ai/relationshipsRelationship extraction (11 types) with clusteringGroq
/api/ai/synthesizeAuto-cluster duplicate articles into comprehensive summariesGroq
/api/ai/explainAI explains why any topic is trending with full contextGroq
/api/ai/portfolio-newsScore news by relevance to your portfolio holdingsGroq
/api/ai/correlationDetect correlations between news and price movementsGroq
/api/ai/flash-briefingUltra-short AI summaries for voice assistantsGroq
/api/ai/narrativesTrack crypto narratives through lifecycle phases (emerging/growing/peak/declining)Groq
/api/ai/cross-lingualRegional sentiment divergence & alpha signal detectionGroq
/api/ai/source-qualityAI-powered source scoring & clickbait detectionGroq
/api/ai/researchDeep-dive research reports on any crypto topicGroq
/api/detect/ai-contentAI-generated content detection (offline, no API needed)None
/api/i18n/translateArticle 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.

Copy & paste — that's it
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:

FeatureDescription
Hybrid SearchBM25 + semantic vector search with RRF fusion
Query RoutingIntelligent strategy selection (semantic/keyword/temporal/agentic)
Advanced RerankingLLM reranking + time decay + source credibility + MMR diversity
Self-RAGAdaptive retrieval with hallucination detection
Contextual CompressionExtract key facts, reduce context to relevant content
Answer AttributionInline citations [1], [2] with source quotes
Confidence ScoringMulti-dimensional quality assessment (high/medium/low)
Conversation MemoryMulti-turn context for follow-up questions
Suggested QuestionsAI-generated follow-up questions
Related ArticlesContent discovery based on context

Service Modes:

ModeFunctionSpeedUse Case
FastaskFast()~220msQuick queries, high volume
BalancedaskUltimate()~520msMost use cases (recommended)
CompleteaskComplete()~850msMaximum quality, all features

Example Response:

Copy & paste — that's it
{
  "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

EndpointDescription
/api/analytics/anomaliesDetect unusual patterns (volume spikes/coordinated publishing/sentiment shifts/ticker surges/source outages)
/api/analytics/credibilitySource credibility scoring with accuracy/timeliness metrics
/api/analytics/headlinesHeadline mutation tracking with sentiment shift detection
/api/analytics/causalityCausal inference (Granger/diff-in-diff/event study methods)
/api/regulatoryMulti-jurisdictional regulatory tracking (15 jurisdictions, 30+ agencies)
/api/influencersInfluencer reliability scoring with accuracy rates
/api/predictionsPrediction tracking with outcome resolution & leaderboards
/api/citationsAcademic citation network with bibliometric metrics

🔗 Relationship & Entity Analysis

EndpointDescription
/api/relationshipsExtract entity relationships (11 types: partnership/competition/investment/acquisition/collaboration/conflict/regulation/development/market_impact/mention/association)
/api/predictionsPrediction registry with timestamped predictions & accuracy scoring
/api/onchain/eventsLink news to on-chain events

💼 Portfolio Tools

EndpointDescription
/api/portfolioPortfolio-based news + prices
/api/portfolio/performancePerformance charts, P&L, risk metrics
/api/portfolio/taxTax report generation (Form 8949)

� Research & Backtesting

EndpointDescription
/api/research/backtestStrategy backtesting with historical news data
/api/academicAcademic access program registration
/api/citationsAcademic citation network analysis
/api/predictionsPrediction tracking with accuracy scoring

Backtest Example:

Copy & paste — that's it
# 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

EndpointDescription
/api/social/monitorDiscord & Telegram channel monitoring via webhooks
/api/social/influencer-scoreInfluencer reliability scoring

Social Monitor Example:

Copy & paste — that's it
# 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

EndpointDescription
/api/storage/casContent-addressable storage (IPFS-style hashing)
/api/exportExport data in CSV/JSON/Parquet formats
/api/exportsBulk export job management
/api/exports/[id]Download export file

�🔔 Real-Time & Infrastructure

EndpointDescription
/api/sseServer-Sent Events for real-time news stream
/api/wsWebSocket connection info & SSE fallback
/api/webhooksWebhook registration & management
/api/pushWeb Push notification registration
/api/newsletter/subscribeNewsletter subscription
/api/alertsPrice & news alerts
/api/cacheCache management
/api/viewsArticle view tracking
/api/keysAPI key management
/api/gatewayUnified API gateway
/api/billingSubscription & billing management
/api/billing/usageCurrent billing usage
/api/upgradeAPI key tier upgrades (x402)
/api/registerUser registration

SSE Real-Time Stream:

Copy & paste — that's it
const events = new EventSource("/api/sse?sources=coindesk,theblock");
events.onmessage = (e) => console.log(JSON.parse(e.data));

🐦 Social Intelligence

EndpointDescription
/api/social/discordDiscord channel monitoring
/api/social/x/listsManage X/Twitter influencer lists
/api/social/x/sentimentX sentiment from custom influencer lists

🐦 X/Twitter Sentiment (No API Key!)

Automated X/Twitter sentiment analysis without paid API:

Copy & paste — that's it
# 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

EndpointDescription
/api/market/coinsList all coins with market data
/api/market/trendingTrending cryptocurrencies
/api/market/categoriesMarket categories
/api/market/exchangesExchange listings
/api/market/searchSearch coins
/api/market/compareCompare 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/defiDeFi market overview
/api/market/derivativesDerivatives market data
/api/chartsChart data for visualizations
/api/fear-greedCrypto Fear & Greed Index with 30-day history

🏗️ DeFi Tools

EndpointDescription
/api/defiDeFi news and protocol coverage
/api/defi/protocol-healthProtocol health & risk scoring
/api/defi/protocol-health?action=rankingProtocol safety rankings
/api/defi/protocol-health?action=incidentsSecurity incident tracker

Protocol Health Example:

Copy & paste — that's it
# 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

EndpointDescription
/api/integrations/tradingviewTradingView widgets & Pine Script generation
/api/tradingviewTradingView webhook receiver

TradingView Example:

Copy & paste — that's it
# 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

EndpointDescription
/api/arbitrageCross-exchange arbitrage scanner with triangular arb
/api/trading/arbitrageReal-time arbitrage opportunities (spot + triangular)
/api/fundingFunding rate dashboard (Binance, Bybit, OKX, Hyperliquid)
/api/optionsOptions flow, volatility surface, max pain, gamma exposure
/api/trading/optionsOptions dashboard from Deribit, OKX, Bybit
/api/liquidationsReal-time liquidations feed (CoinGlass integration)
/api/orderbookMulti-exchange order book aggregation
/api/trading/orderbookAggregated 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:

Copy & paste — that's it
# 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:

Copy & paste — that's it
# 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:

Copy & paste — that's it
# 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

EndpointDescription
/api/whale-alertsMonitor large transactions across blockchains
/api/influencersInfluencer reliability tracking & prediction scoring

Whale Alerts Example:

Copy & paste — that's it
# 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

EndpointDescription
/api/regulatoryRegulatory news with jurisdiction & agency tracking
/api/regulatory?action=jurisdictionsJurisdiction profiles
/api/regulatory?action=agenciesAgency information
/api/regulatory?action=deadlinesUpcoming compliance deadlines
/api/regulatory?action=summaryIntelligence summary

📰 Coverage & Research

EndpointDescription
/api/coverage-gapAnalyze under-covered topics and assets
/api/extractFull article content extraction from URLs
/api/academicAcademic access program for researchers
/api/citationsCitation network analysis for academic papers

💎 Premium API (x402 Micropayments)

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

EndpointDescriptionPrice
/api/premiumPremium API documentation & pricingFree
/api/premium/ai/sentimentAdvanced AI sentiment analysis$0.02
/api/premium/ai/analyzeDeep article analysis$0.03
/api/premium/ai/signalsPremium trading signals$0.05
/api/premium/ai/summaryExtended summaries$0.02
/api/premium/ai/compareMulti-asset AI comparison$0.03
/api/premium/whales/alertsReal-time whale alerts$0.05
/api/premium/whales/transactionsWhale transaction history$0.03
/api/premium/smart-moneySmart money flow tracking$0.05
/api/premium/screener/advancedAdvanced coin screener$0.03
/api/premium/analytics/screenerAnalytics screener$0.03
/api/premium/market/coinsPremium market data$0.02
/api/premium/market/historyExtended price history$0.02
/api/premium/defi/protocolsDeFi protocol analytics$0.03
/api/premium/streams/pricesReal-time price streams$0.01
/api/premium/portfolio/analyticsPortfolio analytics$0.03
/api/premium/export/portfolioPortfolio data export$0.05
/api/premium/alerts/whalesWhale alert configuration$0.02
/api/premium/alerts/customCustom alert rules$0.02
/api/premium/api-keysAPI key managementFree

Access Passes:

PassPriceDuration
1 Hour Pass$0.251 hour
24 Hour Pass$2.0024 hours
Weekly Pass$10.007 days

How to Pay:

Copy & paste — that's it
# 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.

EndpointDescription
/api/v1API documentation & pricing
/api/v1/coinsCoin listings with market data
/api/v1/coin/[coinId]Individual coin details
/api/v1/market-dataGlobal market data
/api/v1/trendingTrending coins
/api/v1/searchSearch coins
/api/v1/exchangesExchange listings
/api/v1/defiDeFi protocols data
/api/v1/gasGas price tracker
/api/v1/globalGlobal crypto market stats
/api/v1/assetsAsset listings
/api/v1/assets/[assetId]/historyAsset price history
/api/v1/historical/[coinId]Historical data
/api/v1/alertsPrice alerts
/api/v1/exportData export
/api/v1/usageAPI usage stats
/api/v1/x402x402 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

PageDescription
/marketsMarket 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
/trendingTrending cryptocurrencies
/moversTop gainers and losers (24h)

Market Tools

PageDescription
/calculatorCrypto calculator with conversion & P/L
/gasEthereum gas tracker with cost estimates
/heatmapMarket heatmap visualization
/screenerAdvanced coin screener with filters
/correlationPrice correlation matrix (7/30/90 days)
/dominanceMarket cap dominance chart
/liquidationsReal-time liquidations feed
/buzzSocial buzz & trending sentiment
/chartsTradingView-style charts

Trading Tools

PageDescription
/arbitrageCross-exchange arbitrage scanner
/optionsOptions flow & analytics dashboard
/orderbookMulti-exchange order book view

Coin Details

PageDescription
/coin/[coinId]Comprehensive coin page with charts, stats, news
/compareCompare multiple cryptocurrencies side-by-side

AI & Analytics

PageDescription
/ai/oracleThe Oracle - AI crypto assistant
/ai/briefAI-generated market brief
/ai/debateAI Bull vs Bear debate generator
/ai/counterAI counter-argument generator
/sentimentSentiment analysis dashboard
/analyticsNews analytics overview
/analytics/headlines🆕 Headline tracking & mutations
/predictionsPrediction tracking & leaderboard
/digestAI-generated daily digest

Social & Influencers

PageDescription
/influencersInfluencer reliability leaderboard
/whalesWhale alerts & tracking
/buzzSocial buzz & trending sentiment

Research & Intelligence

PageDescription
/regulatoryRegulatory intelligence dashboard
/coverage-gapCoverage gap analysis
/protocol-healthDeFi protocol health monitor

User Features

PageDescription
/portfolioPortfolio management with holdings tracking
/watchlistWatchlist with price alerts
/bookmarks🆕 Saved articles & reading list
/settingsUser preferences and notifications
/install🆕 PWA installation guide

Content

PageDescription
/searchSearch news articles
/topic/[topic]Topic-specific news
/topicsBrowse all topics
/source/[source]Source-specific news
/sourcesAll news sources
/category/[category]Category-specific news
/article/[id]Individual article view
/read/[id]🆕 Distraction-free reader mode
/share/[id]🆕 Share & embed articles
/defiDeFi news section
/blogBlog posts

Administration

PageDescription
/billingBilling & subscription management
/pricingPricing plans
/developersDeveloper 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

PackageDescriptionVersion
React<CryptoNews /> drop-in componentsv0.1.0
TypeScriptFull TypeScript SDK with type safetyv0.1.0
PythonZero-dependency Python clientv0.1.0
JavaScriptBrowser & Node.js SDKv0.1.0
GoGo client libraryv0.1.0
PHPPHP SDKv0.1.0
RubyRuby gem with async supportv0.2.0
RustRust crate with async/sync clientsv0.2.0
UI ComponentsInternal navigation & search components-

🔌 Platform Integrations

Total Integrations: 8 official SDKs + 5 platform integrations + 200+ code examples

IntegrationDescriptionDocumentationStatus
ChatGPTCustom GPT with OpenAPI schemaGuide✅ Production
MCP ServerModel Context Protocol (stdio + HTTP/SSE)Guide✅ Production
Chrome ExtensionBrowser extension (Manifest V3)Guide✅ Chrome Ready
Alfred WorkflowmacOS Alfred 4+ integrationGuide✅ Production
RaycastRaycast extension (6 commands)Guide✅ Production
Widgets3 embeddable widget typesGuide✅ Production
CLICommand-line interfaceREADME✅ Production
PostmanPostman collection (182 endpoints)README✅ Complete

Widget Types:

WidgetTypeUse Case
Main WidgetiframeFull news feed embed
TickerJavaScriptScrolling header ticker
CarouselJavaScriptFeatured news rotator

📡 Nostr Integration

Decentralized news distribution via the Nostr protocol (NIP-23 long-form content):

Copy & paste — that's it
# 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=events

Articles 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:

Copy & paste — that's it
# 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:

Copy & paste — that's it
# 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"

Copy & paste — that's it
# 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:

Copy & paste — that's it
# 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:

Copy & paste — that's it
# 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:

Copy & paste — that's it
# 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

EndpointDescription
/api/gamingBlockchain gaming market data with chain breakdown
/api/suiSui blockchain data (balances, objects, transactions)
/api/aptosAptos blockchain data (events, resources, transactions)
/api/hyperliquidHyperliquid DEX trading data

🎓 Academic Research Portal

Full-featured academic access program for researchers and institutions:

Copy & paste — that's it
# 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:

SkillDescription
crypto-news-briefingGenerate comprehensive news briefings
market-sentimentAnalyze market sentiment across sources
coin-researchDeep-dive research on any cryptocurrency
rug-pull-news-checkScan news for rug pull warning signs
historical-trend-analysisAnalyze historical news trends
scale-to-1mScale the system to 1M+ requests/day
add-data-sourcesAdd 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:

Copy & paste — that's it
@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 topics

Also 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:

Copy & paste — that's it
# Launch terminal dashboard
node terminal/dashboard.js

# With custom API URL
API_URL=http://localhost:3000 node terminal/dashboard.js

Features:

  • 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.

FeatureDescription
Hybrid SearchBM25 + semantic search with reciprocal rank fusion
Multi-hop ReasoningAgentic RAG for complex questions requiring multiple articles
Conversation MemoryMulti-turn chat with context tracking
Advanced RerankingLLM scoring, time decay, source credibility, MMR diversity
Query UnderstandingIntent classification, decomposition, HyDE
Streaming APIReal-time SSE responses with step-by-step updates

Quick Start:

Copy & paste — that's it
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:

Copy & paste — that's it
# 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:

LanguageFilesFunctionsDescription
Python12 files150+Full SDK with all endpoints
JavaScript11 files120+Node.js & browser examples
TypeScript3 files80+Type-safe SDK
Go1 file60+Go client library
cURL1 file100+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):

Copy & paste — that's it
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):

Copy & paste — that's it
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:

ExampleLanguageFilePurpose
AI AnalysisPythonexamples/ai-analysis.pySentiment & summarization
LangChain ToolPythonexamples/langchain-tool.pyAI agent integration
Discord BotJavaScriptexamples/discord-bot.jsChannel posting
Telegram BotPythonexamples/telegram-bot.pyCommand handler
Telegram DigestPythonexamples/telegram-digest.pyScheduled digests
Slack BotJavaScriptexamples/slack-bot.jsWebhook posting
Real-time StreamJavaScriptexamples/realtime-stream.jsSSE streaming
curl ExamplesShellexamples/curl.shAPI testing
x402 PythonPythonexamples/x402-client.pyPayment protocol
x402 TypeScriptTypeScriptexamples/x402-client.tsPayment protocol
x402 GoGoexamples/x402-client.goPayment protocol

📖 Complete API Tutorials

Step-by-step tutorials with full working code for every API endpoint:

TutorialEndpoints CoveredDescription
News Basics/api/news, /api/latest, /api/breaking, /api/trendingFetching, filtering, and paginating news articles
Search & Filtering/api/search, /api/news?source=, /api/categoriesFull-text search, source filtering, category browsing
Archive & Export/api/archive, /api/export, /api/rss, /api/atomHistorical data access, bulk exports, RSS/Atom feeds
International News/api/news/international, /api/sources/international, /api/languages, /api/regionsMulti-language news with auto-translation
AI Sentiment/api/ai/sentiment, /api/ai/sentiment/history, /api/ai/sentiment/marketReal-time sentiment analysis for any asset
AI Features/api/ask, /api/summarize, /api/digest, /api/entities, /api/narratives, /api/signalsQ&A, summarization, NER, narratives, trading signals
Trading Signals/api/trading/arbitrage, /api/trading/signals, /api/trading/fundingArbitrage opportunities, AI signals, funding rates
Market Data/api/market/coins, /api/market/ohlc, /api/market/fear-greed, /api/market/dominancePrice data, OHLCV, market indicators
DeFi & NFT/api/defi, /api/defi/protocols, /api/defi/yields, /api/nft, /api/nft/collectionsDeFi protocols, yield farming, NFT analytics
Analytics & Research/api/analytics/trends, /api/analytics/correlations, /api/researchMarket analytics, correlation analysis, research tools
[Social Intelligence](https://github.com/nirholas/free-crypto-news/blob/HEAD/docs/tutorials/social-intelligen