# free-crypto-news — Full LLM Reference (Dynamic) > Free, real-time cryptocurrency news API aggregating 300+ 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 rebuilt on every cache miss (~hourly) and is intended for AI assistants and LLMs. It contains rich API docs, a complete auto-discovered endpoint registry, and the 500 most recent archived articles by category. --- ## Data Freshness - **Generated:** 2026-04-25T01:59:37.413Z - **Articles listed:** 0 - **Public API endpoints discovered:** 432 - **Archive available in this env:** false - **Cache-Control:** public, max-age=3600, s-maxage=3600 --- ## Site Description **free-crypto-news** is an open-source project by nirholas (https://github.com/nirholas) deployed at https://cryptocurrency.cv. Aggregates cryptocurrency news from 300+ sources including CoinDesk, The Block, Decrypt, CoinTelegraph, Bitcoin Magazine, Blockworks, The Defiant, BeInCrypto, NewsBTC, CryptoSlate, Messari, Bankless, Unchained, and 115+ more. **Key properties:** - Base URL: `https://cryptocurrency.cv` - Authentication: none — all endpoints are public - CORS: open (`Access-Control-Allow-Origin: *`) - Rate limiting: fair-use, no hard limits for reasonable use - License: MIT --- ## Core Endpoint Documentation ### GET /api/news Returns latest cryptocurrency news from all sources. Params: `limit` (1–100, default 20), `source`, `page`, `category` (bitcoin|defi|ethereum|altcoin|nft|regulation|general), `lang` Response shape: ```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/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 300+ news sources with status, RSS URL, language. Returns `sources[]`, `totalActive`. ### GET /api/sentiment AI-powered sentiment aggregated from news. Params: `asset` (BTC|ETH|SOL|...), `period` (1h|24h|7d|30d) ### GET /api/fear-greed Crypto Fear & Greed index. Returns `value`, `classification`, `timestamp`. ### 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/exchanges Exchange list with volume and trust score. ### GET /api/market/defi DeFi protocol stats: TVL, APY, protocol counts. ### GET /api/gas Current gas prices (Ethereum, other chains). ### GET /api/global Global market stats: total market cap, BTC dominance, active coins. ### GET /api/ask Natural language Q&A about crypto news. Params: `q` (required). Example: `GET /api/ask?q=What+happened+to+Bitcoin+this+week` ### 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/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/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/cross-lingual Cross-lingual news comparison for a topic. ### GET /api/ai/blog-generator AI-powered crypto blog post generator. ### 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. ### GET /api/rag Retrieval-Augmented Generation over the news archive. ### 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/rss RSS 2.0 feed. Params: `limit`, `source`, `category` ### GET /api/atom Atom 1.0 feed. ### GET /api/sse Server-Sent Events real-time stream. Usage: `new EventSource("/api/sse")` ### 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/social/x/sentiment X (Twitter) sentiment analysis for crypto assets. ### GET /api/social/trending-narratives Trending narratives across social platforms. ### GET /api/liquidations Liquidation data: long/short liquidations by exchange and asset. ### 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/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. ### GET /api/onchain/events On-chain events correlated with news. ### GET /api/onchain/correlate Correlation between on-chain metrics and news sentiment. ### GET /api/factcheck AI fact-checking of crypto news claims. Params: `claim` or article body ### GET /api/translate Translate news articles. Params: `text`, `to` (language code) ### GET /api/classify Classify news articles by category and topic. ### GET /api/entities Entity extraction across recent news. ### GET /api/relationships Entity relationship graph from news. ### GET /api/claims Claim extraction from news articles. ### 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/academic Academic/research articles related to crypto topics. ### 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. ### 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/portfolio Portfolio news feed. Params: `coins` (comma-separated tickers) ### GET /api/portfolio/performance Portfolio performance vs. news sentiment. ### GET /api/portfolio/tax Tax-relevant news and events for a portfolio. ### GET /api/watchlist Watchlist news feed. ### GET /api/alerts Alert management for keyword/asset news triggers. ### GET /api/tags Tag-based news browse. Params: `tag` ### GET /api/digest Daily/weekly news digest. ### GET /api/newsletter/subscribe Subscribe to the email newsletter. ### GET /api/search/semantic Semantic (vector) search over news archive. Params: `q` ### GET /api/nostr Nostr protocol integration: crypto news as Nostr events. ### GET /api/graphql GraphQL interface for flexible news queries. ### GET /api/openapi.json Machine-readable OpenAPI 3.1 specification for all endpoints. --- ## 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** → `GET /api/sentiment?asset=BTC&period=24h` 5. **Trending topics** → `GET /api/trending` 6. **Market overview** → `GET /api/market/coins` + `GET /api/fear-greed` 7. **Ask a question** → `GET /api/ask?q=What+is+happening+with+Ethereum` 8. **AI briefing** → `GET /api/ai/brief` 9. **RAG answer** → `GET /api/rag/ask?q=Why+did+BTC+drop` 10. **Whale activity** → `GET /api/whale-alerts` 11. **DeFi research** → `GET /api/ai/research?q=DeFi+TVL+trends` 12. **Token narratives** → `GET /api/ai/narratives` --- ## 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 --- ## Integrations ### 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/JS + React hooks: https://github.com/nirholas/free-crypto-news/tree/main/sdk - Python: https://github.com/nirholas/free-crypto-news/tree/main/sdk - CLI: https://github.com/nirholas/free-crypto-news/tree/main/cli - Embeddable widget: https://github.com/nirholas/free-crypto-news/tree/main/widget --- ## Complete Public API Registry (432 endpoints, auto-discovered) _This section is generated at runtime by scanning the live codebase._ ### AI & Intelligence - `/api/ai` - `/api/ai/blog-generator` - `/api/ai/brief` - `/api/ai/correlation` - `/api/ai/counter` - `/api/ai/cross-lingual` - `/api/ai/debate` - `/api/ai/digest` - `/api/ai/entities` - `/api/ai/entities/extract` - `/api/ai/explain` - `/api/ai/flash-briefing` - `/api/ai/narratives` - `/api/ai/oracle` - `/api/ai/portfolio-news` - `/api/ai/relationships` - `/api/ai/research` - `/api/ai/social` - `/api/ai/source-quality` - `/api/ai/summarize` - `/api/ai/summarize/stream` - `/api/ai/synthesize` ### AI Anchor - `/api/ai-anchor` ### Alerts - `/api/alerts` - `/api/alerts/[id]` - `/api/alerts/stream` ### Analytics - `/api/analytics/anomalies` - `/api/analytics/causality` - `/api/analytics/credibility` - `/api/analytics/events` - `/api/analytics/forensics` - `/api/analytics/gaps` - `/api/analytics/headlines` - `/api/analytics/influencers` - `/api/analytics/news-onchain` - `/api/analytics/usage` ### Aptos - `/api/aptos` - `/api/aptos/events` - `/api/aptos/resources` - `/api/aptos/transactions` ### Auth - `/api/auth/login` - `/api/auth/logout` - `/api/auth/me` - `/api/auth/refresh` - `/api/auth/verify` ### Authors - `/api/authors` - `/api/authors/[slug]` ### Bitcoin - `/api/bitcoin` - `/api/bitcoin/address/[address]` - `/api/bitcoin/block-height` - `/api/bitcoin/blocks` - `/api/bitcoin/blocks/[hash]` - `/api/bitcoin/difficulty` - `/api/bitcoin/mempool/blocks` - `/api/bitcoin/mempool/fees` - `/api/bitcoin/mempool/info` - `/api/bitcoin/network-stats` - `/api/bitcoin/stats` - `/api/bitcoin/tx/[txid]` ### Coincap - `/api/coincap` - `/api/coincap/assets/[id]` ### Coinpaprika - `/api/coinpaprika` - `/api/coinpaprika/coins` - `/api/coinpaprika/exchanges` - `/api/coinpaprika/search` - `/api/coinpaprika/tickers` - `/api/coinpaprika/tickers/[coinId]` - `/api/coinpaprika/tickers/[coinId]/ohlcv` ### Dashboard - `/api/dashboard/keys` - `/api/dashboard/keys/[keyId]` - `/api/dashboard/usage` ### Data-sources - `/api/data-sources` - `/api/data-sources/defi/dashboard` - `/api/data-sources/derivatives` - `/api/data-sources/onchain` - `/api/data-sources/social` ### DeFi (extended) - `/api/defi` - `/api/defi/bridges` - `/api/defi/dex-volumes` - `/api/defi/protocol-health` - `/api/defi/stablecoins` - `/api/defi/summary` - `/api/defi/yields` - `/api/defi/yields/[poolId]/chart` - `/api/defi/yields/chains` - `/api/defi/yields/median` - `/api/defi/yields/projects` - `/api/defi/yields/search` - `/api/defi/yields/stablecoins` - `/api/defi/yields/stats` ### Derivatives - `/api/derivatives` - `/api/derivatives/aggregated/funding` - `/api/derivatives/aggregated/open-interest` - `/api/derivatives/bybit/funding/[symbol]` - `/api/derivatives/bybit/open-interest/[symbol]` - `/api/derivatives/bybit/tickers` - `/api/derivatives/dydx/markets` - `/api/derivatives/okx/funding` - `/api/derivatives/okx/open-interest` - `/api/derivatives/okx/tickers` - `/api/derivatives/opportunities` ### Exchange-rates - `/api/exchange-rates` - `/api/exchange-rates/convert` ### Export - `/api/export` - `/api/export/jobs` - `/api/export/jobs/[jobId]` ### Exports - `/api/exports` - `/api/exports/[id]` ### Funding - `/api/funding` - `/api/funding/dashboard` - `/api/funding/history/[symbol]` ### Gaming - `/api/gaming` - `/api/gaming/chains` - `/api/gaming/top` ### Gas - `/api/gas` - `/api/gas/estimate` - `/api/gas/history` ### L2 - `/api/l2` - `/api/l2/activity` - `/api/l2/projects` - `/api/l2/projects/[projectId]` - `/api/l2/risk` ### Macro - `/api/macro` - `/api/macro/correlations` - `/api/macro/dxy` - `/api/macro/fed` - `/api/macro/indicators` - `/api/macro/risk-appetite` ### Market Data - `/api/market/categories` - `/api/market/categories/[id]` - `/api/market/coins` - `/api/market/coins/[coinId]/community` - `/api/market/coins/[coinId]/developer` - `/api/market/compare` - `/api/market/defi` - `/api/market/derivatives` - `/api/market/dominance` - `/api/market/exchanges` - `/api/market/exchanges/[id]` - `/api/market/gainers` - `/api/market/global-defi` - `/api/market/heatmap` - `/api/market/history/[coinId]` - `/api/market/losers` - `/api/market/movers` - `/api/market/ohlc/[coinId]` - `/api/market/orderbook` - `/api/market/pumps` - `/api/market/search` - `/api/market/snapshot/[coinId]` - `/api/market/social/[coinId]` - `/api/market/stream` - `/api/market/tickers/[coinId]` ### News (extended) - `/api/news` - `/api/news/categories` - `/api/news/extract` - `/api/news/international` - `/api/news/stream` ### Newsletter - `/api/newsletter` - `/api/newsletter/subscribe` ### Nft - `/api/nft` - `/api/nft/collections/[slug]` - `/api/nft/collections/[slug]/activity` - `/api/nft/collections/[slug]/stats` - `/api/nft/collections/search` - `/api/nft/collections/trending` - `/api/nft/market` - `/api/nft/sales/recent` ### Notifications - `/api/notifications/email/verify` - `/api/notifications/preferences` ### Og - `/api/og` - `/api/og/coin` - `/api/og/market` ### On-Chain - `/api/onchain/aave/markets` - `/api/onchain/aave/rates` - `/api/onchain/compound/markets` - `/api/onchain/correlate` - `/api/onchain/cross-protocol` - `/api/onchain/curve/pools` - `/api/onchain/events` - `/api/onchain/exchange-flows` - `/api/onchain/funding-metrics` - `/api/onchain/gmx/stats` - `/api/onchain/health` - `/api/onchain/lido/stats` - `/api/onchain/lth-metrics` - `/api/onchain/maker/stats` - `/api/onchain/metrics` - `/api/onchain/miner-metrics` - `/api/onchain/multichain` - `/api/onchain/protocol/[protocol]` - `/api/onchain/uniswap/pools` - `/api/onchain/uniswap/swaps` - `/api/onchain/whale-metrics` ### Oracle - `/api/oracle` - `/api/oracle/chainlink` - `/api/oracle/prices` ### Orderbook - `/api/orderbook` - `/api/orderbook/stream` ### Portfolio - `/api/portfolio` - `/api/portfolio/benchmark` - `/api/portfolio/correlation` - `/api/portfolio/holding` - `/api/portfolio/performance` - `/api/portfolio/tax` - `/api/portfolio/tax-report` ### Predictions - `/api/predictions` - `/api/predictions/history` - `/api/predictions/markets` ### Premium - `/api/premium` - `/api/premium/ai/analyze` - `/api/premium/ai/compare` - `/api/premium/ai/sentiment` - `/api/premium/ai/signals` - `/api/premium/ai/summary` - `/api/premium/alerts/custom` - `/api/premium/alerts/whales` - `/api/premium/analytics/screener` - `/api/premium/api-keys` - `/api/premium/defi/protocols` - `/api/premium/export/portfolio` - `/api/premium/market/coins` - `/api/premium/market/history` - `/api/premium/portfolio/analytics` - `/api/premium/screener/advanced` - `/api/premium/smart-money` - `/api/premium/streams/prices` - `/api/premium/whales/alerts` - `/api/premium/whales/transactions` ### Press-release - `/api/press-release` - `/api/press-release/[id]` ### Prices - `/api/prices` - `/api/prices/stream` ### Providers - `/api/providers/health` - `/api/providers/metrics` - `/api/providers/status` ### RAG (Retrieval-Augmented Generation) - `/api/rag` - `/api/rag/ask` - `/api/rag/batch` - `/api/rag/eval` - `/api/rag/feedback` - `/api/rag/metrics` - `/api/rag/personalization` - `/api/rag/search` - `/api/rag/similar/[id]` - `/api/rag/stats` - `/api/rag/stream` - `/api/rag/summary/[crypto]` - `/api/rag/timeline` ### Search - `/api/search` - `/api/search/semantic` - `/api/search/v2` ### Signals - `/api/signals` - `/api/signals/narrative` ### Social & Sentiment - `/api/social` - `/api/social/coins` - `/api/social/coins/[symbol]` - `/api/social/coins/[symbol]/feed` - `/api/social/discord` - `/api/social/influencer-score` - `/api/social/influencers` - `/api/social/monitor` - `/api/social/sentiment` - `/api/social/sentiment/market` - `/api/social/topics/trending` - `/api/social/trending-narratives` - `/api/social/x/lists` - `/api/social/x/sentiment` ### Solana - `/api/solana` - `/api/solana/assets` - `/api/solana/balances` - `/api/solana/collections` - `/api/solana/defi` - `/api/solana/nfts` - `/api/solana/priority-fees` - `/api/solana/search` - `/api/solana/tokens` - `/api/solana/transactions` - `/api/solana/wallet` ### Stablecoins - `/api/stablecoins` - `/api/stablecoins/[symbol]` - `/api/stablecoins/chains` - `/api/stablecoins/depeg` - `/api/stablecoins/dominance` - `/api/stablecoins/flows` ### Sui - `/api/sui` - `/api/sui/balances` - `/api/sui/objects` - `/api/sui/transactions` ### Tags - `/api/tags` - `/api/tags/[slug]` ### Trading - `/api/trading/arbitrage` - `/api/trading/options` - `/api/trading/orderbook` ### v1 (Versioned) - `/api/v1` - `/api/v1/ai/explain` - `/api/v1/ai/research` - `/api/v1/alerts` - `/api/v1/ask` - `/api/v1/assets` - `/api/v1/assets/[assetId]/history` - `/api/v1/bitcoin` - `/api/v1/categories` - `/api/v1/classify` - `/api/v1/coin/[coinId]` - `/api/v1/coins` - `/api/v1/defi` - `/api/v1/derivatives` - `/api/v1/dex` - `/api/v1/digest` - `/api/v1/exchanges` - `/api/v1/export` - `/api/v1/fear-greed` - `/api/v1/forecast` - `/api/v1/fundamentals` - `/api/v1/gas` - `/api/v1/global` - `/api/v1/historical/[coinId]` - `/api/v1/knowledge-graph` - `/api/v1/liquidations` - `/api/v1/market-data` - `/api/v1/narratives` - `/api/v1/news` - `/api/v1/ohlcv` - `/api/v1/onchain` - `/api/v1/orderbook` - `/api/v1/predictions` - `/api/v1/search` - `/api/v1/sentiment` - `/api/v1/signals` - `/api/v1/sources` - `/api/v1/stablecoins` - `/api/v1/summarize` - `/api/v1/system/status` - `/api/v1/tags` - `/api/v1/trending` - `/api/v1/usage` - `/api/v1/whale-alerts` - `/api/v1/x402` ### Well-known - `/api/well-known/agents` - `/api/well-known/ai-plugin` ### Whale Alerts - `/api/whale-alerts` - `/api/whale-alerts/context` ### Miscellaneous - `/api/academic` - `/api/airdrops` - `/api/alexa` - `/api/analyze` - `/api/anomalies` - `/api/arbitrage` - `/api/arkham` - `/api/article` - `/api/articles` - `/api/ask` - `/api/atom` - `/api/backtest` - `/api/batch` - `/api/blog/posts` - `/api/breaking` - `/api/bridges` - `/api/chart-analysis` - `/api/charts` - `/api/citations` - `/api/claims` - `/api/classify` - `/api/clickbait` - `/api/coinmarketcap` - `/api/commentary` - `/api/compare` - `/api/contact` - `/api/contributors` - `/api/coverage-gap` - `/api/cryptocompare` - `/api/cryptopanic` - `/api/detect/ai-content` - `/api/dex-volumes` - `/api/digest` - `/api/dune` - `/api/entities` - `/api/events` - `/api/exchanges` - `/api/extract` - `/api/factcheck` - `/api/fear-greed` - `/api/flows` - `/api/forecast` - `/api/funding-rates` - `/api/geckoterminal` - `/api/global` - `/api/glossary` - `/api/health` - `/api/hyperliquid` - `/api/i18n/translate` - `/api/influencers` - `/api/inngest` - `/api/integrations/tradingview` - `/api/knowledge-graph` - `/api/liquidations` - `/api/monitor` - `/api/nansen` - `/api/narratives` - `/api/nostr` - `/api/ohlc` - `/api/on-chain` - `/api/oneinch` - `/api/openapi.json` - `/api/opml` - `/api/options` - `/api/origins` - `/api/pipelines` - `/api/podcast` - `/api/regulatory` - `/api/relationships` - `/api/research/backtest` - `/api/rss` - `/api/rss-proxy` - `/api/sample` - `/api/sentiment` - `/api/sources` - `/api/sse` - `/api/summarize` - `/api/token-unlocks` - `/api/tokenterminal` - `/api/tradingview` - `/api/translate` - `/api/trending` - `/api/unlocks` - `/api/validators` - `/api/vector-search` - `/api/videos` - `/api/watchlist` - `/api/whales` - `/api/yields` ### Internal / Operational (20 endpoints) _Not intended for external use: cron jobs, admin, billing._ - `/api/billing` - `/api/billing/usage` - `/api/cache` - `/api/cron/expire-subscriptions` - `/api/cron/warm` - `/api/frames` - `/api/frames/image` - `/api/gateway` - `/api/keys` - `/api/keys/rotate` - `/api/keys/upgrade` - `/api/keys/usage` - `/api/metrics` - `/api/push` - `/api/register` - `/api/stats` - `/api/storage/cas` - `/api/upgrade` - `/api/views` - `/api/ws` --- ## Recent Articles _Archive not available in this environment._ --- ## 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 - **Document generated:** 2026-04-25T01:59:37.413Z - **Compact reference:** https://cryptocurrency.cv/llms.txt