llms-full.txt

# free-crypto-news — Full LLM Reference

> Free, real-time cryptocurrency news API aggregating 130+ sources. No API key required.
> REST JSON, RSS/Atom, WebSocket, AI analysis, historical archive, MCP server, ChatGPT plugin.
> Open source (MIT). https://cryptocurrency.cv

This document is the complete inline reference intended for AI assistants and LLMs.
It contains full API documentation, usage examples, response schemas, and integration guides.

**Note:** A dynamically generated version of this document (with auto-discovered endpoints
and 500 recent articles) is available at https://cryptocurrency.cv/api/llms-full.txt

---

## Overview

**Base URL:** `https://cryptocurrency.cv`
**Authentication:** None required (all endpoints are public)
**Rate limiting:** Fair-use policy, no hard limits for reasonable use
**CORS:** Open (`Access-Control-Allow-Origin: *`)
**Format:** JSON (default), RSS, Atom, plain text where noted
**License:** MIT — free to use, modify, and redistribute

Aggregates cryptocurrency news from 130+ sources: CoinDesk, The Block, Decrypt,
CoinTelegraph, Bitcoin Magazine, Blockworks, The Defiant, BeInCrypto, NewsBTC,
CryptoSlate, Messari, Delphi Digital, Bankless, Unchained, Pomp Letters, and 115+ more.

---

## Core News Endpoints

### GET /api/news
Returns latest cryptocurrency news from all sources.

Params: `limit` (1–100, default 20), `source` (e.g. `coindesk`), `page`,
`category` (bitcoin|defi|ethereum|altcoin|nft|regulation|general), `lang`

Example: `GET /api/news?limit=5&source=coindesk&category=bitcoin`

Response:
```json
{
  "articles": [{
    "id": "coindesk-1234",
    "title": "Bitcoin Hits New ATH",
    "link": "https://coindesk.com/...",
    "description": "Bitcoin surged past...",
    "pubDate": "2026-02-21T10:30:00Z",
    "source": "CoinDesk",
    "sourceKey": "coindesk",
    "category": "bitcoin",
    "timeAgo": "2h ago",
    "sentiment": "bullish",
    "tags": ["bitcoin", "price", "ath"]
  }],
  "totalCount": 1,
  "fetchedAt": "2026-02-21T12:00:00Z",
  "cached": false
}
```

### GET /api/search
Full-text search across all aggregated news.
Params: `q` (required), `limit`, `from` (ISO date), `to` (ISO date), `source`
Example: `GET /api/search?q=ethereum+ETF&limit=5`

### GET /api/search/semantic
Semantic (vector) search over news archive. Params: `q`, `limit`

### GET /api/bitcoin
Bitcoin-specific news. Params: `limit`, `page`

### GET /api/defi
DeFi news: yield farming, DEXs, lending protocols, hacks. Params: `limit`, `page`

### GET /api/breaking
Articles from the last 2 hours. Params: `limit` (default 5)

### GET /api/trending
Trending keywords and topics across all sources.

### GET /api/sources
All 130+ news sources with status, RSS URL, language. Returns `sources[]`, `totalActive`.

### GET /api/news/categories
List of available news categories with article counts.

### GET /api/news/international
International / non-English news feed.

### GET /api/narratives
Currently trending market narratives.

### GET /api/tags
Tag-based news browsing. Params: `tag`

### GET /api/tags/[slug]
News articles for a specific tag.

---

## AI & Intelligence Endpoints

### POST /api/ai
AI analysis of article content.
```json
{
  "action": "summarize|sentiment|facts|factcheck|questions|categorize|translate",
  "title": "Article headline",
  "content": "Article body...",
  "options": { "length": "short|medium|long", "targetLanguage": "es" }
}
```

### GET /api/ask
Natural language Q&A about crypto news. Params: `q` (required)
Example: `GET /api/ask?q=What+happened+to+Bitcoin+this+week`

### GET /api/ai/research
Deep multi-source research on a topic. Params: `q` (required)

### GET /api/ai/narratives
Emerging market narratives detected from news patterns.

### GET /api/ai/brief
AI-generated short briefing / digest of recent news.

### GET /api/ai/debate
Bull vs bear debate format for a given topic or asset.

### GET /api/ai/counter
Counter-argument generation for a given claim or headline.

### GET /api/ai/digest
Daily AI digest summary.

### GET /api/ai/flash-briefing
Short AI flash briefing (smart speaker / widget compatible).

### GET /api/ai/correlation
AI correlation analysis between tokens/narratives.

### GET /api/ai/cross-lingual
Cross-lingual news comparison for a topic.

### GET /api/ai/entities
Named-entity extraction from news.

### GET /api/ai/explain
Plain-English explanation of a crypto concept or headline.

### GET /api/ai/social
AI summary of social sentiment for an asset.

### GET /api/ai/synthesize
Synthesise multiple articles into a unified narrative.

### GET /api/ai/oracle
AI predictions as a news-backed oracle.

### GET /api/ai/portfolio-news
News filtered and summarised for a given portfolio of assets.

### GET /api/ai/relationships
Token/entity relationship graph derived from news.

### GET /api/ai/source-quality
AI credibility scoring for news sources.

### GET /api/ai/blog-generator
AI-powered crypto blog post generator.

### GET /api/ai/summarize
Standalone article summarisation endpoint.

### GET /api/ai/summarize/stream
Streaming article summarisation (SSE).

### GET /api/ai-anchor
AI news anchor / presenter mode.

### GET /api/summarize
Summarise any URL or article text.

### GET /api/classify
Classify news articles by category and topic.

### GET /api/factcheck
AI fact-checking of crypto news claims. Params: `claim` or article body.

### GET /api/claims
Claim extraction from news articles.

### GET /api/entities
Entity extraction across recent news.

### GET /api/relationships
Entity relationship graph from news.

### GET /api/clickbait
Clickbait detection for news headlines.

### GET /api/detect/ai-content
AI-generated content detection for news articles.

### GET /api/citations
Citation and source verification for claims.

### GET /api/compare
Compare two assets or topics by news coverage and sentiment.

### GET /api/coverage-gap
Detect under-covered stories in the crypto news cycle.

### GET /api/translate
Translate news articles. Params: `text`, `to` (language code)

### GET /api/i18n/translate
Bulk translation for internationalisation.

### GET /api/extract
Extract structured data from article content.

### GET /api/news/extract
Extract news metadata from a URL.

### GET /api/analyze
General analysis endpoint (multi-mode).

---

## Predictions

### GET /api/predictions
AI-generated market predictions from news analysis.

### GET /api/predictions/history
Historical AI predictions with outcome tracking.

### GET /api/predictions/markets
Prediction market data aggregation.

---

## RAG (Retrieval-Augmented Generation)

### GET /api/rag
Top-level RAG endpoint — status and capabilities.

### GET /api/rag/ask
RAG-powered natural language Q&A. Params: `q`

### GET /api/rag/search
Semantic search over archived articles. Params: `q`, `limit`

### GET /api/rag/stream
Streaming RAG response (SSE). Params: `q`

### GET /api/rag/summary/[crypto]
AI summary for a specific cryptocurrency using RAG over recent news.

### GET /api/rag/timeline
Chronological RAG timeline for a topic or asset.

### GET /api/rag/stats
RAG index statistics (article count, last update, coverage).

### GET /api/rag/metrics
RAG quality metrics (recall, precision).

### GET /api/rag/similar/[id]
Articles similar to a given article ID.

### GET /api/rag/batch
Batch RAG processing for multiple queries.

### GET /api/rag/eval
RAG evaluation against a test set.

### GET /api/rag/feedback
Submit feedback on RAG answers.

### GET /api/rag/personalization
Personalised RAG based on user preferences.

---

## Market Data Endpoints

### GET /api/market/coins
Full coin list with prices, market caps, 24h changes.

### GET /api/market/history/[coinId]
Historical OHLCV for a coin. Params: `days`, `interval`

### GET /api/market/ohlc/[coinId]
OHLC candle data for a coin.

### GET /api/market/snapshot/[coinId]
Full market snapshot for a single coin.

### GET /api/market/tickers/[coinId]
Exchange tickers for a coin.

### GET /api/market/exchanges
Exchange list with volume and trust score.

### GET /api/market/exchanges/[id]
Single exchange details.

### GET /api/market/defi
DeFi protocol stats: TVL, APY, protocol counts.

### GET /api/market/derivatives
Derivatives market data.

### GET /api/market/orderbook
Aggregated order book data.

### GET /api/market/categories
Market categories (Layer 1, DeFi, NFT, etc.) with metrics.

### GET /api/market/categories/[id]
Coins in a specific market category.

### GET /api/market/compare
Side-by-side comparison of multiple coins.

### GET /api/market/social/[coinId]
Social stats for a coin (Twitter followers, Reddit subscribers, etc.)

### GET /api/market/search
Search coins by name/symbol.

### GET /api/sentiment
AI-powered sentiment aggregated from news.
Params: `asset` (BTC|ETH|SOL|...), `period` (1h|24h|7d|30d)

Response:
```json
{
  "overall": "bullish",
  "score": 0.72,
  "breakdown": { "bullish": 65, "neutral": 20, "bearish": 15 },
  "assets": {
    "BTC": { "sentiment": "bullish", "score": 0.81, "articleCount": 142 }
  }
}
```

### GET /api/fear-greed
Crypto Fear & Greed index. Returns `value`, `classification`, `timestamp`.

### GET /api/global
Global market stats: total market cap, BTC dominance, active coins.

### GET /api/exchange-rates
Cryptocurrency exchange rates.

### GET /api/ohlc
OHLC data (generic endpoint).

### GET /api/prices
Current prices for requested assets. Params: `coins`

### GET /api/gas
Current gas prices (Ethereum, other chains).

### GET /api/funding
Futures funding rates.

### GET /api/yields
DeFi yield rates.

### GET /api/derivatives
Crypto derivatives overview.

### GET /api/flows
On-chain fund flows.

### GET /api/unlocks
Token unlock schedule and upcoming unlocks.

### GET /api/arbitrage
Cross-exchange arbitrage opportunities.

### GET /api/orderbook
Aggregated order book.

### GET /api/backtest
News sentiment backtesting against price data.

---

## Social & On-Chain

### GET /api/social
Social mentions aggregation.

### GET /api/social/x/sentiment
X (Twitter) sentiment for crypto assets.

### GET /api/social/x/lists
Curated X lists for crypto topics.

### GET /api/social/trending-narratives
Trending narratives across social platforms.

### GET /api/social/influencer-score
Influencer credibility scoring.

### GET /api/social/monitor
Real-time social monitoring.

### GET /api/social/discord
Discord community sentiment.

### GET /api/influencers
Top news and social influencers for crypto.

### GET /api/onchain/events
On-chain events correlated with news.

### GET /api/onchain/correlate
Correlation between on-chain metrics and news sentiment.

### GET /api/whale-alerts
On-chain large-transaction news and alerts.

### GET /api/whale-alerts/context
AI-generated context for whale transactions.

### GET /api/whales
Whale wallet activity aggregation.

### GET /api/liquidations
Liquidation data: long/short liquidations by exchange and asset.

### GET /api/nostr
Nostr protocol integration: crypto news as Nostr events.

---

## Signals & Oracle

### GET /api/signals
Trading signals derived from news sentiment and on-chain data.

### GET /api/signals/narrative
Narrative-based trading signals.

### GET /api/oracle
News-backed on-chain oracle data.

### GET /api/oracle/chainlink
Chainlink-compatible oracle news feed.

---

## Analytics

### GET /api/analytics/anomalies
Anomaly detection in news volume and sentiment.

### GET /api/analytics/causality
Granger causality between news events and price.

### GET /api/analytics/credibility
Source credibility scoring at scale.

### GET /api/analytics/forensics
News forensics: manipulation detection, astroturfing signals.

### GET /api/analytics/headlines
Headline analysis and pattern detection.

### GET /api/analytics/influencers
Top news influencers by topic.

### GET /api/analytics/news-onchain
Cross-correlation of news events with on-chain activity.

### GET /api/analytics/gaps
Gap analysis in news coverage.

### GET /api/analytics/usage
API usage analytics.

---

## Portfolio

### GET /api/portfolio
Portfolio news feed. Params: `coins` (comma-separated tickers)

### GET /api/portfolio/holding
Holdings-weighted news feed.

### GET /api/portfolio/performance
Portfolio performance vs. news sentiment.

### GET /api/portfolio/tax
Tax-relevant news and events for a portfolio.

### GET /api/portfolio/tax-report
Generate a tax report.

---

## Trading

### GET /api/trading/arbitrage
Cross-exchange arbitrage opportunities.

### GET /api/trading/options
Options market data.

### GET /api/trading/orderbook
Order book data.

---

## Archive & Historical

**Total archived articles:** 24,209  
**Date range:** 2010-07-31 → 2026-01-11  
**Last updated:** 2026-02-05

### GET /api/archive
Historical news by date. Params: `date` (YYYY-MM-DD), `year`, `month`
Archive covers 2010–present with full metadata and market context.

### GET /api/archive/v2
Enhanced archive API with richer filtering.

### GET /api/archive/ipfs
IPFS-pinned archive access.

### GET /api/archive/status
Archive ingestion status.

Flat file indexes (direct HTTP):
- `GET /archive/indexes/by-date.json` — date → article IDs
- `GET /archive/indexes/by-source.json` — source → article IDs
- `GET /archive/indexes/by-ticker.json` — ticker → article IDs

---

## Regulatory & Academic

### GET /api/regulatory
Regulatory news and enforcement actions.

### GET /api/academic
Academic / research articles about crypto.

---

## Community & Distribution

### GET /api/alerts
Alert management for keyword/asset news triggers.

### GET /api/alerts/[id]
Single alert details.

### GET /api/digest
Daily/weekly news digest.

### GET /api/newsletter/subscribe
Subscribe to the email newsletter.

### GET /api/watchlist
Watchlist news feed.

### GET /api/origins
Article origin tracking.

---

## Feeds & Streaming

### GET /api/rss
RSS 2.0 feed. Params: `limit`, `source`, `category`

### GET /api/atom
Atom 1.0 feed.

### GET /api/opml
OPML export of all RSS sources.

### GET /api/sse
Server-Sent Events real-time stream. Usage: `new EventSource("/api/sse")`

### GET /api/alexa
Alexa smart home skill integration.

---

## API Metadata

### GET /api/openapi.json
Machine-readable OpenAPI 3.1 specification.

### GET /api/docs
API documentation redirect.

### GET /api/health
API health check. Returns `{ "status": "ok", "uptime": ... }`

### GET /api/graphql
GraphQL interface for flexible news queries.

### GET /api/v1
V1 versioned API entry point.

### GET /api/v1/coins
V1 coin list.

### GET /api/v1/market-data
V1 market data endpoint.

### GET /api/v1/search
V1 search endpoint.

### GET /api/v1/trending
V1 trending endpoint.

### GET /api/v1/defi
V1 DeFi endpoint.

### GET /api/v1/global
V1 global market stats.

### GET /api/v1/gas
V1 gas prices.

### GET /api/v1/exchanges
V1 exchange list.

### GET /api/v1/export
V1 data export.

### GET /api/v1/assets
V1 asset list.

### GET /api/v1/assets/[assetId]/history
V1 asset price history.

### GET /api/v1/coin/[coinId]
V1 single coin data.

### GET /api/v1/historical/[coinId]
V1 historical coin data.

### GET /api/v1/alerts
V1 alerts.

### GET /api/v1/usage
V1 usage stats.

---

## Premium Endpoints

Premium endpoints require an API key (header: `X-API-Key`).

- `GET /api/premium/ai/analyze` — deep AI analysis
- `GET /api/premium/ai/compare` — multi-asset AI comparison
- `GET /api/premium/ai/sentiment` — premium sentiment with finer granularity
- `GET /api/premium/ai/signals` — premium trading signals
- `GET /api/premium/ai/summary` — premium AI summaries
- `GET /api/premium/alerts/custom` — custom alert rules
- `GET /api/premium/alerts/whales` — premium whale alerts
- `GET /api/premium/analytics/screener` — news-based screener
- `GET /api/premium/api-keys` — API key management
- `GET /api/premium/defi/protocols` — premium DeFi protocol data
- `GET /api/premium/export/portfolio` — portfolio data export
- `GET /api/premium/market/coins` — premium coin data
- `GET /api/premium/market/history` — premium price history
- `GET /api/premium/portfolio/analytics` — portfolio analytics
- `GET /api/premium/screener/advanced` — advanced screener
- `GET /api/premium/smart-money` — smart money tracking
- `GET /api/premium/streams/prices` — real-time price streams
- `GET /api/premium/whales/alerts` — whale alert stream
- `GET /api/premium/whales/transactions` — whale transaction details

---

## Common Use Cases for AI Assistants

1. **Current crypto news** → `GET /api/breaking` + `GET /api/sentiment`
2. **Bitcoin news** → `GET /api/bitcoin?limit=10`
3. **Search a topic** → `GET /api/search?q=defi+hack&limit=10`
4. **Sentiment check** → `GET /api/sentiment?asset=BTC&period=24h`
5. **Market overview** → `GET /api/market/coins` + `GET /api/fear-greed`
6. **Ask a question** → `GET /api/ask?q=What+happened+to+Bitcoin+this+week`
7. **AI briefing** → `GET /api/ai/brief`
8. **RAG answer** → `GET /api/rag/ask?q=Why+did+BTC+drop`
9. **Whale activity** → `GET /api/whale-alerts`
10. **DeFi research** → `GET /api/ai/research?q=DeFi+TVL+trends`
11. **Token narratives** → `GET /api/ai/narratives`
12. **Liquidations** → `GET /api/liquidations`

---

## Response Common Fields

All news endpoints return articles with:
- `id` — unique article identifier
- `title` — article headline
- `link` — canonical URL
- `description` — article summary (≤ 500 chars)
- `pubDate` — ISO 8601 publication timestamp
- `source` / `sourceKey` — human/machine-readable source name
- `category` — general|bitcoin|defi|ethereum|nft|regulation|altcoin
- `timeAgo` — human-readable recency ("2h ago")
- `sentiment` — bullish|bearish|neutral (optional)
- `tags` — extracted topic tags array

---

## Integration Protocols

### MCP Server (Claude)
```json
{
  "mcpServers": {
    "free-crypto-news": {
      "command": "node",
      "args": ["/path/to/free-crypto-news/mcp/index.js"]
    }
  }
}
```
MCP tools: get_latest_news, search_news, get_sentiment, get_trending,
get_bitcoin_news, get_defi_news

### ChatGPT Plugin
Manifest: https://cryptocurrency.cv/.well-known/ai-plugin.json
OpenAPI spec: https://cryptocurrency.cv/api/openapi.json

---

## SDKs

### TypeScript / JavaScript
```typescript
import { CryptoNewsClient } from 'free-crypto-news';
const client = new CryptoNewsClient();
const news = await client.getLatestNews({ limit: 10 });
const btcNews = await client.getBitcoinNews();
const sentiment = await client.getSentiment('BTC');
```

### React Hook
```tsx
import { useCryptoNews } from 'free-crypto-news/react';
function NewsWidget() {
  const { articles, loading } = useCryptoNews({ limit: 10 });
  return <ul>{articles.map(a => <li key={a.id}>{a.title}</li>)}</ul>;
}
```

### Python
```python
from free_crypto_news import CryptoNewsClient
client = CryptoNewsClient()
news = client.get_latest_news(limit=10)
```

### cURL
```bash
curl https://cryptocurrency.cv/api/news
curl "https://cryptocurrency.cv/api/search?q=bitcoin+ETF&limit=5"
curl "https://cryptocurrency.cv/api/sentiment?asset=BTC"
curl "https://cryptocurrency.cv/api/ai/brief"
curl "https://cryptocurrency.cv/api/rag/ask?q=What+is+DeFi"
```

---

## Valid Source Keys

Use these values with the `?source=` query parameter on any news endpoint.
Example: `GET /api/news?source=coindesk&limit=10`

beincrypto, binance, bitcoinist, bitfinex, blockworks, bravenewcoin,
ccn, chainlink, coinspeaker, coindesk, cointelegraph, cryptobriefing, cryptoglobe,
cryptoslate, cryptoninjas, dailyhodl, decrypt, forkast, finbold,
forbes, medium, newsbtc, pancakeswap, reddit, theblock, trustnodes, twitter,
utoday

---

## MCP Tool Signatures

The Claude MCP server (`mcp/`) exposes these tools. Each tool maps to a
REST endpoint. Install via: `npx -y @smithery/cli install cryptocurrency-news`

### get_crypto_news
Fetch the latest crypto news. Args: category (bitcoin|ethereum|defi|solana|nft|
altcoin|regulation|exchange|whale|general), limit (1-50, default 10),
ticker (filter by asset e.g. BTC).

### search_crypto_news
Full-text search the archive. Args: query (required), limit (1-50), category.

### get_defi_news
DeFi-specific news feed. Args: limit (1-50, default 10).

### get_bitcoin_news
Bitcoin-only news. Args: limit (1-50, default 10).

### get_breaking_news
Latest breaking articles (newest first). Args: limit (1-50, default 5).

### get_market_data
Current crypto market data (prices, market caps, 24h change).
Args: coins (comma-separated list, e.g. "bitcoin,ethereum"), currency (default usd).

### get_fear_greed_index
Crypto Fear & Greed Index. Args: days (number of historical points, default 1).

### get_gas_prices
Ethereum gas prices (slow/standard/fast in gwei). No args.

### get_regulatory_news
Regulatory and legal crypto news. Args: limit (1-50, default 10).

### get_whale_alerts
Large on-chain transactions (whale movements). Args: limit (1-50, default 10),
min_value_usd (minimum USD value, default 1000000).

### get_funding_rates
Perpetual futures funding rates. Args: symbols (comma-separated, default "BTC,ETH").

### get_liquidations
Recent liquidation events. Args: limit (1-50, default 20).

### get_defi_yields
DeFi protocol yield rates. Args: limit (1-50, default 10), min_apy (minimum APY filter).

### get_ai_market_brief
AI-generated market summary (sentiment, key themes, recent headlines). No args.

### compare_coins
Compare two or more coins. Args: coins (comma-separated, required),
metric (price|volume|market_cap|change, default price).

### get_exchange_flows
Exchange inflow/outflow data. Args: exchange (optional, e.g. "binance"), limit (default 10).

### get_token_unlocks
Upcoming token unlock schedules. Args: limit (1-50, default 10).

### get_social_sentiment
Social-media sentiment for a coin. Args: coin (required, e.g. "bitcoin"), days (default 7).

### get_news_sources
List all available news sources with metadata. No args.

---

## OpenAPI Schemas

Canonical response shapes for all news endpoints.

### NewsArticle
```
title:       string   — Headline text
link:        string   — Original article URL
description: string   — Short summary / lede
pubDate:     string   — ISO 8601 publication date
source:      string   — Human-readable source name (e.g. "CoinDesk")
sourceKey:   string   — Machine key (e.g. "coindesk") for ?source= filter
category:    string   — Enum: general | bitcoin | defi
timeAgo:     string   — Human-readable relative time (e.g. "2 hours ago")
```

### NewsResponse
```
articles: NewsArticle[]  — Array of article objects
total:    integer        — Total matches available
page:     integer        — Current page (1-based)
limit:    integer        — Page size used
```

### SourceInfo
```
name:        string   — Human-readable source name
key:         string   — Machine identifier (use with ?source=)
url:         string   — Source homepage
category:    string   — Primary content category
articleCount:integer  — Number of articles in archive
lastSeen:    string   — ISO date of most recent article
```

### SourcesResponse
```
sources:    SourceInfo[]  — Array of source objects
total:      integer       — Total number of sources
```

---

## Project Information

- **GitHub:** https://github.com/nirholas/free-crypto-news
- **Live site:** https://cryptocurrency.cv
- **Author:** nirholas (https://github.com/nirholas)
- **Language:** TypeScript (Next.js)
- **License:** MIT
- **Last updated:** March 2026
- **Dynamic version:** https://cryptocurrency.cv/api/llms-full.txt
- **Compact reference:** https://cryptocurrency.cv/llms.txt