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

Quick Start • SDKs • API • CLI • Docker • K8s • Docs

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

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

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

📚 Historical Archive

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

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

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

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

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:

Keyboard Shortcuts

Power through news with keyboard navigation:

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

🌐 Interactive Pages

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

📰 News & Content

📊 Market Data

🧠 AI Analysis

🔬 Research Tools

⚙️ User Features

📖 Documentation & Tools

🎨 UI/UX Features

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

🏠 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

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

🤖 AI-Powered Endpoints (FREE via 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:

Service Modes:

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

🔗 Relationship & Entity Analysis

💼 Portfolio Tools

� Research & Backtesting

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

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

�🔔 Real-Time & Infrastructure

SSE Real-Time Stream:

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

🐦 Social Intelligence

🐦 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

🏗️ DeFi Tools

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

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

Supported Exchanges:

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

Arbitrage Features:

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

Options Analytics:

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

Order Book Analysis:

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

Supported Exchanges:

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

Arbitrage Features:

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

Options Analytics:

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

Order Book Analysis:

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

Arbitrage Scanner Example:

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

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

Options Flow Example:

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

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

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

Order Book Example:

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

# Estimate slippage for $100k order
curl "https://fcn.dev/api/trading/orderbook?symbol=BTCUSDT&view=slippage&size=100000"

🐋 Whale Intelligence

Whale Alerts Example:

# Get recent whale transactions
curl "https://fcn.dev/api/whale-alerts?limit=50"

# Filter by blockchain
curl "https://fcn.dev/api/whale-alerts?blockchain=ethereum&minUsd=1000000"

🏛️ Regulatory Intelligence

📰 Coverage & Research

💎 Premium API (x402 Micropayments)

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

Access Passes:

How to Pay:

# 1. Make request, receive 402 with payment requirements
curl https://fcn.dev/api/premium/ai/sentiment

# 2. Pay with USDC using x402-compatible wallet
# 3. Include payment proof in header
curl -H "X-Payment: <base64-payment>" https://fcn.dev/api/premium/ai/sentiment

🔐 Admin API

🔢 Versioned API (v1)

Stable versioned API with x402 micropayment support for production integrations.

💡 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

Market Tools

Trading Tools

Coin Details

AI & Analytics

Social & Influencers

Research & Intelligence

User Features

Content

Administration

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

🔌 Platform Integrations

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

Widget Types:

📡 Nostr Integration

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

# Publish latest news to Nostr relays
curl -X POST https://cryptocurrency.cv/api/nostr \
  -H "Content-Type: application/json" \
  -d '{"action": "publish", "limit": 10}'

# Get Nostr event IDs for published articles
curl https://cryptocurrency.cv/api/nostr?action=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:

# Get entity graph for Bitcoin
curl "https://cryptocurrency.cv/api/knowledge-graph?entity=Bitcoin&depth=2"

# Filter by relationship type
curl "https://cryptocurrency.cv/api/knowledge-graph?entity=Ethereum&type=partnership"

# Get full graph snapshot
curl "https://cryptocurrency.cv/api/knowledge-graph?action=snapshot"

Returns entities (people, companies, protocols, exchanges) and their relationships (partnerships, investments, acquisitions, competitions) as a traversable graph.

🎙️ AI Podcast Generation

Generate AI-narrated crypto news podcasts on demand:

# Generate flash briefing (2 min)
curl "https://cryptocurrency.cv/api/podcast?format=flash"

# Deep-dive analysis (10 min)
curl "https://cryptocurrency.cv/api/podcast?format=deep-dive&topic=BTC"

# Market open briefing
curl "https://cryptocurrency.cv/api/podcast?format=market-open"

# Weekly recap
curl "https://cryptocurrency.cv/api/podcast?format=weekly-recap"

# Subscribe via podcast RSS
curl "https://cryptocurrency.cv/api/podcast/feed"

Formats: flash (2 min), deep-dive (10 min), market-open (5 min), weekly-recap (15 min)
Voices: 3 voice options (professional, casual, technical)

🗣️ Alexa Skill

Voice-activated crypto news for Amazon Echo devices:

"Alexa, ask Crypto News for the latest headlines" "Alexa, ask Crypto News about Bitcoin" "Alexa, ask Crypto News for DeFi updates"

# Alexa skill handler
curl -X POST https://cryptocurrency.cv/api/alexa \
  -H "Content-Type: application/json" \
  -d '{"request": {"type": "IntentRequest", "intent": {"name": "GetNewsIntent"}}}'

🖼️ Farcaster Frames

Interactive news frames for Warpcast and Farcaster clients:

# Get interactive news frame
curl "https://cryptocurrency.cv/api/frames"

# Frame with specific topic
curl "https://cryptocurrency.cv/api/frames?topic=bitcoin"

Frames support inline article previews, sentiment badges, and action buttons directly within the Farcaster social feed.

🔍 Vector Search

Semantic search across the article archive using vector embeddings:

# Semantic search (finds conceptually similar articles)
curl "https://cryptocurrency.cv/api/vector-search?q=institutional+adoption+impact+on+market"

# With filters
curl "https://cryptocurrency.cv/api/vector-search?q=defi+security+vulnerabilities&source=coindesk&limit=20"

🔬 Anomaly Detection

Advanced anomaly detection across the news landscape:

# Detect all anomalies
curl "https://cryptocurrency.cv/api/anomalies"

# Specific anomaly types
curl "https://cryptocurrency.cv/api/anomalies?type=sentiment-acceleration"
curl "https://cryptocurrency.cv/api/anomalies?type=price-narrative-divergence"
curl "https://cryptocurrency.cv/api/anomalies?type=news-velocity"

Anomaly Types:

• News Velocity — Unusual spike in article volume for a topic
• Sentiment Acceleration — Rapid sentiment shifts in short timeframes
• Price-Narrative Divergence — When news sentiment diverges from price action
• Coordinated Publishing — Multiple sources publishing similar content simultaneously
• Source Outage — Expected source goes silent

🎮 Gaming & Chain-Specific APIs

🎓 Academic Research Portal

Full-featured academic access program for researchers and institutions:

# Register institution
curl -X POST https://cryptocurrency.cv/api/academic \
  -H "Content-Type: application/json" \
  -d '{
    "institution": "MIT Media Lab",
    "email": "researcher@mit.edu",
    "purpose": "Crypto market microstructure research",
    "irb_approval": "IRB-2026-0142"
  }'

# Add co-investigators
curl -X POST https://cryptocurrency.cv/api/academic \
  -H "Content-Type: application/json" \
  -d '{"action": "add_investigator", "email": "postdoc@mit.edu", "role": "co-pi"}'

Benefits: Unlimited API access, historical data exports, citation network access, priority support, co-investigator management, IRB approval tracking.

🤖 AI Agent Skills

7 pre-built AI agent skills following the agentskills.io standard, compatible with Claude Code and Codex:

Skills are located in /skills/ and can be loaded by AI coding agents for autonomous development tasks.

🖥️ GitHub Copilot Extension

Crypto news directly in your VS Code editor via Copilot Chat:

@crypto-news /breaking     — Breaking crypto news
@crypto-news /market       — Market overview
@crypto-news /prices       — Top coin prices
@crypto-news /feargreed    — Fear & Greed Index
@crypto-news /whale        — Recent whale alerts
@crypto-news /trending     — Trending 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:

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

Quick Start:

import { ragService } from '@/lib/rag';

// Simple question answering
const response = await ragService.ask("What happened to Bitcoin last week?");
console.log(response.answer);

// Multi-hop reasoning for complex questions  
const reasoning = await ragService.askWithReasoning(
  "How did the ETF approval affect Bitcoin compared to Ethereum?"
);

API Endpoints:

# Standard RAG query
curl -X POST /api/rag -d '{"query": "Latest Bitcoin news"}'

# Streaming with progress updates
curl -N -X POST /api/rag/stream -d '{"query": "Why did crypto crash?"}'

# Search without answer generation
curl -X POST /api/rag/search -d '{"query": "DeFi hacks", "limit": 10}'

📚 Full RAG Documentation — Architecture, API reference, configuration, and advanced features.

🚀 Code Examples & SDKs (200+ Examples)

Complete examples for all 184 API endpoints across 5 languages:

Python Example Files:

• news.py - News feeds, search, categories (13 functions)
• ai.py - Sentiment, summarization, NLP (20 functions)
• market.py - Coins, OHLC, exchanges (16 functions)
• trading.py - Arbitrage, signals, funding (10 functions)
• social.py - Twitter, Reddit, Discord (15 functions)
• blockchain.py - DeFi, NFT, on-chain (17 functions)
• regulatory.py - ETF, SEC, regulations (14 functions)
• analytics.py - Trends, correlations (15 functions)
• feeds.py - RSS, exports, webhooks (13 functions)
• portfolio.py - Alerts, watchlists (15 functions)
• premium.py - Premium tier features (12 functions)

Quick Start (Python):

import requests
BASE_URL = "https://cryptocurrency.cv"

# Get latest news
news = requests.get(f"{BASE_URL}/api/news?limit=10").json()

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

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

Quick Start (JavaScript):

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

// Get latest news
const news = await fetch(`${BASE_URL}/api/news?limit=10`).then(r => r.json());

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

📚 Full Examples Documentation | API Tutorial

Bot Integration Examples:

📖 Complete API Tutorials

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

📚 View All Tutorials — Complete documentation covering 150+ endpoints with Python, JavaScript, TypeScript, and cURL examples.

MCP Server Modes:

• stdio: For Claude Desktop (local)
• HTTP/SSE: For ChatGPT Developer Mode (remote)
• Tools: 40 tools available for AI assistants

📚 Documentation

Base URL: https://cryptocurrency.cv

Failsafe Mirror: https://nirholas.github.io/free-crypto-news/

Query Parameters

AI Endpoint Parameters

Response Format

{
  "articles": [
    {
      "title": "Bitcoin Hits New ATH",
      "link": "https://coindesk.com/...",
      "description": "Bitcoin surpassed...",
      "pubDate": "2025-01-02T12:00:00Z",
      "source": "CoinDesk",
      "timeAgo": "2h ago"
    }
  ],
  "totalCount": 150,
  "fetchedAt": "2025-01-02T14:30:00Z"
}

🤖 AI Endpoint Examples

Ask questions about crypto news:

curl "https://cryptocurrency.cv/api/ask?q=What%20is%20happening%20with%20Bitcoin%20today"

Get AI-powered summaries:

curl "https://cryptocurrency.cv/api/summarize?limit=5&style=brief"

Daily digest:

curl "https://cryptocurrency.cv/api/digest?period=24h"

Deep sentiment analysis:

curl "https://cryptocurrency.cv/api/sentiment?asset=BTC"

Extract entities (people, companies, tickers):

curl "https://cryptocurrency.cv/api/entities?type=person"

Identify market narratives:

curl "https://cryptocurrency.cv/api/narratives?emerging=true"

News-based trading signals:

curl "https://cryptocurrency.cv/api/signals?min_confidence=70"

Fact-check claims:

curl "https://cryptocurrency.cv/api/factcheck?type=prediction"

Detect clickbait:

curl "https://cryptocurrency.cv/api/clickbait?threshold=50"

🆕 AI Products

Daily Brief - Comprehensive crypto news digest:

curl "https://cryptocurrency.cv/api/ai/brief?format=full"

Bull vs Bear Debate - Generate balanced perspectives:

curl -X POST "https://cryptocurrency.cv/api/ai/debate" \
  -H "Content-Type: application/json" \
  -d '{"topic": "Bitcoin reaching $200k in 2026"}'

Counter-Arguments - Challenge any claim:

curl -X POST "https://cryptocurrency.cv/api/ai/counter" \
  -H "Content-Type: application/json" \
  -d '{"claim": "Ethereum will flip Bitcoin by market cap"}'

🏗️ Technical Architecture

Runtime & Performance

Edge Runtime: 140+ endpoints optimized for Edge runtime
Target Metrics:

• TTFB: <200ms (actual ~150ms on Edge)
• FCP: <1.8s (actual ~1.2s)
• LCP: <2.5s (actual ~2.0s)
• CLS: <0.1 (actual ~0.05)
• TTI: <3.8s (actual ~2.8s)

Caching Strategy (4-Layer)

Database Backends

Supported Storage:

• ✅ Vercel KV (Primary - Production)
• ✅ Upstash Redis (Alternative - Production)
• 🔧 Memory (Development only)
• 🔧 File System (Local testing)

Features:

• Document-based operations with versioning
• TTL support for automatic expiration
• Batch operations (mget, mset)
• Pattern matching for keys
• Statistics and monitoring
• Content-addressable storage (CAS)

Data Architecture

Database Schema Patterns:

Real-time Updates

🔐 Authentication & Security

API Key System

Key Format: cda_{tier}_{random}

Tiers & Limits:

Features:

• SHA-256 key hashing for security
• Per-key rate limiting
• Usage tracking and analytics
• Automatic expiration support
• Tier upgrades via x402 payments
• API key management endpoints

Create API Key:

curl -X POST https://cryptocurrency.cv/api/register \
  -H "Content-Type: application/json" \
  -d '{"email": "your@email.com", "tier": "free"}'

Use API Key:

curl -H "X-API-Key: cda_free_abc123" \
  https://cryptocurrency.cv/api/news

Security Headers

x402 Payment Security

Protocol: x402 v2
Network: Base Mainnet (eip155:8453)
Token: USDC (0x833589...)

Verification Steps:

1. Parse payment signature from PAYMENT-SIGNATURE header
2. Validate signature format and structure
3. Verify payment amount matches endpoint price
4. Check facilitator confirmation
5. Verify wallet signature cryptographically
6. Grant access if all checks pass

Discovery: /.well-known/x402 provides machine-readable pricing

🧪 Testing & Quality Assurance

Test Coverage

Test Suites:

• E2E Tests: 9 Playwright test files covering critical user paths
• Component Tests: 8 Storybook stories for key UI components
• API Tests: Postman collection with 182 endpoint tests
• Unit Tests: Vitest for core utility functions

E2E Test Coverage:

Run Tests:

# E2E tests
npm run test:e2e

# Component tests
npm run storybook

# Unit tests
npm run test

🏗️ Technical Architecture

Runtime & Performance

Edge Runtime: 140+ endpoints optimized for Edge runtime
Target Metrics:

• TTFB: <200ms (actual ~150ms on Edge)
• FCP: <1.8s (actual ~1.2s)
• LCP: <2.5s (actual ~2.0s)
• CLS: <0.1 (actual ~0.05)
• TTI: <3.8s (actual ~2.8s)

Caching Strategy (4-Layer)

Database Backends

Supported Storage:

• ✅ Vercel KV (Primary - Production)
• ✅ Upstash Redis (Alternative - Production)
• 🔧 Memory (Development only)
• 🔧 File System (Local testing)

Features:

• Document-based operations with versioning
• TTL support for automatic expiration
• Batch operations (mget, mset)
• Pattern matching for keys
• Statistics and monitoring
• Content-addressable storage (CAS)

Data Architecture

Database Schema Patterns:

Real-time Updates

🔐 Authentication & Security

API Key System

Key Format: cda_{tier}_{random}

Tiers & Limits:

Features:

• SHA-256 key hashing for security
• Per-key rate limiting
• Usage tracking and analytics
• Automatic expiration support
• Tier upgrades via x402 payments
• API key management endpoints

Create API Key:

curl -X POST https://cryptocurrency.cv/api/register \
  -H "Content-Type: application/json" \
  -d '{"email": "your@email.com", "tier": "free"}'

Use API Key:

curl -H "X-API-Key: cda_free_abc123" \
  https://cryptocurrency.cv/api/news

Security Headers

x402 Payment Security

Protocol: x402 v2
Network: Base Mainnet (eip155:8453)
Token: USDC (0x833589...)

Verification Steps:

1. Parse payment signature from PAYMENT-SIGNATURE header
2. Validate signature format and structure
3. Verify payment amount matches endpoint price
4. Check facilitator confirmation
5. Verify wallet signature cryptographically
6. Grant access if all checks pass

Discovery: /.well-known/x402 provides machine-readable pricing

✨ Advanced Features

📦 Content-Addressable Storage (CAS)

IPFS-style content addressing for articles:

# Store content with automatic hash
curl -X POST https://cryptocurrency.cv/api/storage/cas \
  -H "Content-Type: application/json" \
  -d '{"content": "Article content here"}'

# Returns: {"hash": "bafybei..."}

# Retrieve by hash
curl https://cryptocurrency.cv/api/storage/cas?hash=bafybei...

📊 Data Export Formats

Export news data in multiple formats:

Supported Formats:

• JSON (structured)
• CSV (spreadsheet-compatible)
• Parquet (analytics/big data)

# Create export job
curl -X POST https://cryptocurrency.cv/api/export \
  -H "Content-Type: application/json" \
  -d '{
    "format": "csv",
    "dateFrom": "2026-01-01",
    "dateTo": "2026-01-31",
    "sources": ["coindesk", "theblock"]
  }'

# Returns: {"exportId": "exp_123"}

# Download export
curl https://cryptocurrency.cv/api/exports/exp_123 -o news.csv

Bulk Export Management:

# List all exports
curl https://cryptocurrency.cv/api/exports

# Get export status
curl https://cryptocurrency.cv/api/exports/exp_123

# Delete export
curl -X DELETE https://cryptocurrency.cv/api/exports/exp_123

🏛️ Regulatory Intelligence

Multi-jurisdictional regulatory tracking:

Coverage:

• 15 jurisdictions (US, EU, UK, CN, JP, KR, SG, etc.)
• 30+ agencies (SEC, CFTC, FCA, ESMA, etc.)
• Compliance deadlines tracking
• Regulatory change detection

# Get regulatory news
curl https://cryptocurrency.cv/api/regulatory

# Get jurisdiction profiles
curl https://cryptocurrency.cv/api/regulatory?action=jurisdictions

# Get agency information
curl https://cryptocurrency.cv/api/regulatory?action=agencies

# Get upcoming deadlines
curl https://cryptocurrency.cv/api/regulatory?action=deadlines

# Get intelligence summary
curl https://cryptocurrency.cv/api/regulatory?action=summary

🏥 DeFi Protocol Health Monitoring

Features:

• Protocol health & risk scoring
• Security incident tracking
• TVL monitoring
• Smart contract risk assessment
• Protocol safety rankings

# Get protocol health score
curl "https://cryptocurrency.cv/api/defi/protocol-health?protocol=aave-v3"

# Get safety rankings by category
curl "https://cryptocurrency.cv/api/defi/protocol-health?action=ranking&category=lending"

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

🐋 Whale Alert Features

Capabilities:

• Large transaction monitoring
• Multi-blockchain support (ETH, BTC, SOL, etc.)
• Exchange flow tracking
• Wallet address identification
• Historical whale activity

# Get recent whale transactions
curl "https://cryptocurrency.cv/api/whale-alerts?limit=50"

# Filter by blockchain and minimum value
curl "https://cryptocurrency.cv/api/whale-alerts?blockchain=ethereum&minUsd=1000000"

🎯 Prediction Tracking System

Features:

• Timestamped prediction registry
• Accuracy scoring and leaderboards
• Influencer reliability tracking
• Outcome resolution
• Historical performance analysis

# Get predictions
curl https://cryptocurrency.cv/api/predictions

# Get prediction leaderboard
curl https://cryptocurrency.cv/api/predictions?action=leaderboard

# Get influencer track record
curl https://cryptocurrency.cv/api/influencers?username=crypto_analyst

📈 Strategy Backtesting

Backtest news-based trading strategies:

Available Strategies:

• Sentiment momentum
• News volume signals
• Narrative tracking
• Entity mention correlation
• Breaking news reaction

curl -X POST https://cryptocurrency.cv/ap