\n\nReal-time crypto news from **300+ sources** with one HTTP call. No API key, no signup, no rate-limit paperwork. Live at **[cryptocurrency.cv](https://cryptocurrency.cv)**.\n\n**For AI agents:** `curl https://cryptocurrency.cv/api/news` • [llms.txt](https://cryptocurrency.cv/llms.txt) • [llms-full.txt](https://cryptocurrency.cv/llms-full.txt) • [OpenAPI](https://cryptocurrency.cv/api/openapi.json) • MCP: `https://cryptocurrency.cv/api/mcp` • [AGENTS.md](AGENTS.md) • [SKILLS.md](SKILLS.md)\n\n> ⭐ If this saves you time, star the repo. It helps others find it.\n\n---\n\n## ⚡ Quick Start\n\nThirty seconds, no key required. cURL works as-is:\n\n```bash\n# Latest headlines from every source\ncurl https://cryptocurrency.cv/api/news\n\n# Only the last two hours\ncurl https://cryptocurrency.cv/api/breaking\n\n# Full-text search\ncurl \"https://cryptocurrency.cv/api/search?q=bitcoin%20etf\"\n\n# Filter by category, cap the result size\ncurl \"https://cryptocurrency.cv/api/news?category=defi&limit=20\"\n\n# Ask a question, answered from today's news (AI)\ncurl \"https://cryptocurrency.cv/api/ask?q=why%20is%20ETH%20up%20today\"\n```\n\nEvery endpoint returns JSON, is CORS-enabled, and works from a browser, a script, or an agent tool call. Response shape:\n\n```json\n{\n \"articles\": [\n {\n \"title\": \"Bitcoin Hits New ATH\",\n \"link\": \"https://coindesk.com/...\",\n \"description\": \"Bitcoin surpassed...\",\n \"pubDate\": \"2026-01-02T12:00:00Z\",\n \"source\": \"CoinDesk\",\n \"timeAgo\": \"2h ago\"\n }\n ],\n \"totalCount\": 150,\n \"fetchedAt\": \"2026-01-02T14:30:00Z\"\n}\n```\n\nFrom code, `npm install @nirholas/crypto-news`:\n\n```ts\nimport { CryptoNews } from '@nirholas/crypto-news';\nconst news = await new CryptoNews().getLatest(10);\n```\n\nPython, Go, PHP, Rust, Ruby, Swift, Kotlin, Java, C#, and R clients live in [`sdk/`](sdk/) as copy-in source; runnable samples for bots, agents, and 12 languages live in [`examples/`](examples/).\n\n---\n\n## 🎁 What You Get\n\n| Capability | Details |\n| --- | --- |\n| **Sources** | 300+ RSS feeds in 21 categories plus 77 international outlets (KO, ZH, JA, ES and more) with on-the-fly translation. Tiered by credibility. [Details](docs/reference/international-sources.md) |\n| **Endpoints** | 450+ routes: news, search, categories, market data, DeFi, whales, regulatory, portfolio, trading signals, feeds. [Catalog](docs/reference/endpoints.md) |\n| **Historical archive** | 662,047 articles from September 2017 onward, searchable by date, ticker, sentiment and full text. [Archive](docs/reference/archive.md) |\n| **AI endpoints** | Summaries, sentiment, fact-checks, narratives, research mode, RAG over the archive, daily briefs. Free, powered by Groq. [AI docs](docs/AI-FEATURES.md) |\n| **MCP server** | Hosted Streamable-HTTP endpoint plus a local stdio server, 40+ tools. [Below](#-mcp-server) |\n| **Feeds and streaming** | RSS 2.0, Atom, OPML, Server-Sent Events, WebSocket. [Realtime](docs/REALTIME.md) |\n| **Widgets** | Drop-in HTML/JS news ticker and carousel. [`widget/`](widget/) |\n| **Web app** | 89 pages: dashboards, portfolio, watchlists, alerts, charts, installable PWA. [Pages](docs/reference/pages.md) |\n| **SDK examples** | Clients in [`sdk/`](sdk/), samples in [`examples/`](examples/), guides in [`docs/sdks/`](docs/sdks/index.md) |\n| **Agent-ready** | `llms.txt`, OpenAPI 3.1, `/.well-known/agent.json`, `/.well-known/ai-plugin.json`, x402 micropayments for premium routes. [AGENTS.md](AGENTS.md) |\n\n### How it compares\n\n| | Free Crypto News | CryptoPanic | Others |\n| ----------------- | ------------------------------- | ------------ | -------- |\n| **Price** | 🆓 Free | $29-299/mo | Paid |\n| **API Key** | ❌ None needed | Required | Required |\n| **Rate Limit** | Unlimited\\* | 100-1000/day | Limited |\n| **Sources** | 300+ English + 77 international | 1 | Varies |\n| **Historical** | 📚 662,000+ articles (2017-2026) | Limited | None |\n| **International** | 🌏 KO, ZH, JA, ES + translation | No | No |\n| **Self-host** | ✅ Docker / Cloud Run / Vercel | No | No |\n| **PWA** | ✅ Installable | No | No |\n| **MCP** | ✅ Hosted + local | No | No |\n| **SDK examples** | 12 languages | 0 | 1-2 |\n| **AI Features** | 30+ AI endpoints (free) | No | No |\n\n\\* Fair use. Cache on your side and identify your client with a `User-Agent`; abusive traffic gets throttled.\n\n---\n\n## 🔌 Endpoints\n\nA compact map of the API, grouped by area. The interactive explorer is at **[cryptocurrency.cv/developers](https://cryptocurrency.cv/developers)**, the narrative reference is [docs/API.md](docs/API.md), and the complete 450+ route catalog is [docs/reference/endpoints.md](docs/reference/endpoints.md).\n\n| Area | Endpoints | Notes |\n| --- | --- | --- |\n| **News** | `/api/news`, `/api/breaking`, `/api/search?q=`, `/api/news?category=` | `limit`, `source`, `page`, `category` params |\n| **Categories** | `/api/bitcoin`, `/api/defi`, `/api/news?category=institutional` | 21 categories, see the catalog |\n| **International** | `/api/news/international?lang=ko`, `/api/news?translate=es` | 77 outlets, 18 translation targets |\n| **AI** | `/api/ask`, `/api/ai` (summarize, sentiment, fact-check), `/api/ai/summarize`, `/api/ai/narratives`, `/api/ai/research`, `/api/ai/brief`, `/api/rag`, `/api/predictions` | Free via Groq |\n| **Sentiment and social** | `/api/sentiment`, `/api/fear-greed`, `/api/trending`, `/api/social` | Includes X/Twitter sentiment without a key |\n| **Market data** | `/api/market`, `/api/prices`, `/api/defi`, `/api/gas`, `/api/yields`, `/api/hyperliquid` | Prices, DeFi, gas, derivatives |\n| **On-chain** | `/api/whales`, `/api/whale-alerts`, `/api/flows`, `/api/liquidations`, `/api/unlocks` | Whale alerts, exchange flows, unlock calendar |\n| **Portfolio and signals** | `/api/portfolio`, `/api/signals`, `/api/alerts` | Portfolio-aware news, trading signals |\n| **Archive** | `/api/archive?date=2024-01`, `?ticker=BTC`, `?q=`, `?stats=true` | 662k articles, see [archive](docs/reference/archive.md) |\n| **Feeds** | `/api/rss`, `/api/atom`, `/api/opml`, `/api/sse`, WebSocket | Streaming and syndication |\n| **Meta** | `/api/sources`, `/api/health`, `/api/openapi.json`, `/api/stats` | Source list, uptime, spec |\n| **Premium (x402)** | `/api/premium/*`, `/.well-known/x402` | Pay per call with USDC, no account. [x402 docs](docs/X402.md) |\n| **Versioned** | `/api/v1/*` | Stable aliases for everything above |\n\n### AI endpoint examples\n\nThe AI routes need no key either. They run on the hosted Groq integration:\n\n```bash\n# Natural-language question over today's news\ncurl \"https://cryptocurrency.cv/api/ask?q=what%20happened%20with%20the%20SEC%20this%20week\"\n\n# One-paragraph summary of the current feed\ncurl \"https://cryptocurrency.cv/api/ai/summarize\"\n\n# Emerging narratives, ranked by momentum\ncurl \"https://cryptocurrency.cv/api/ai/narratives?emerging=true\"\n\n# Daily brief for a given date\ncurl \"https://cryptocurrency.cv/api/ai/brief?date=2026-08-26&format=summary\"\n\n# Retrieval-augmented answer over the 662k-article archive\ncurl \"https://cryptocurrency.cv/api/rag?q=bitcoin%20etf%20approval%20timeline\"\n```\n\n### Historical archive\n\n662,047 articles (CryptoPanic English coverage from September 2017 plus Odaily Chinese coverage), enriched with tickers, named entities, sentiment and the BTC/ETH price and Fear & Greed reading at capture time.\n\n```bash\ncurl \"https://cryptocurrency.cv/api/archive?date=2024-01\" # one month\ncurl \"https://cryptocurrency.cv/api/archive?ticker=BTC&limit=100\" # by ticker\ncurl \"https://cryptocurrency.cv/api/archive?q=bitcoin%20etf\" # full text\ncurl \"https://cryptocurrency.cv/api/archive?start_date=2025-01-01&end_date=2025-01-07\"\ncurl \"https://cryptocurrency.cv/api/archive?stats=true\" # counts and coverage\n```\n\nSchema, directory layout and every query parameter: [docs/reference/archive.md](docs/reference/archive.md).\n\n---\n\n## 🔮 MCP Server\n\nUse the whole API from Claude Desktop, Claude Code, Cursor, or any Model Context Protocol client. 40+ tools (news, search, archive, sentiment, market data, portfolio); the full tool list is in [mcp/README.md](mcp/README.md).\n\n**Hosted endpoint, zero install.** A Streamable-HTTP server runs at `https://cryptocurrency.cv/api/mcp`:\n\n```json\n{\n \"mcpServers\": {\n \"crypto-news\": {\n \"url\": \"https://cryptocurrency.cv/api/mcp\"\n }\n }\n}\n```\n\nClaude Code, one line:\n\n```bash\nclaude mcp add --transport http crypto-news https://cryptocurrency.cv/api/mcp\n```\n\n**Local stdio server.** The same tools on your machine, published as [`@nirholas/free-crypto-news-mcp`](https://www.npmjs.com/package/@nirholas/free-crypto-news-mcp) (source in [`mcp/`](mcp/)):\n\n```json\n{\n \"mcpServers\": {\n \"crypto-news\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@nirholas/free-crypto-news-mcp\"]\n }\n }\n}\n```\n\nOr run it from a checkout: `git clone https://github.com/nirholas/cryptocurrency.cv.git && cd cryptocurrency.cv/mcp && npm install && node index.js`.\n\nOther agent surfaces: a ChatGPT custom GPT and OpenAI plugin manifest (`/.well-known/ai-plugin.json`), Google A2A agent card (`/.well-known/agent.json`), LangChain and CrewAI samples in [`examples/agents/`](examples/agents/), and copy-paste integrations for Discord, Telegram, Slack and LangChain in [docs/reference/integrations.md](docs/reference/integrations.md).\n\n---\n\n## 🧩 Widgets\n\nEmbed a live news feed in any page with one script tag. Source and examples in [`widget/`](widget/).\n\n```html\n\n\n```\n\n`ticker.js` scrolls headlines, `carousel.js` renders cards, `embed.js` drops a full feed into a container. All three read `data-*` attributes for limit, category, speed and theme.\n\n---\n\n## 🐳 Self-Hosting\n\nEverything runs from one Next.js app. All environment variables are optional; without any, you get the full news API. Set `GROQ_API_KEY` (free at [console.groq.com](https://console.groq.com/keys)) to switch on the AI endpoints. The complete variable list, Kubernetes manifests and observability stack are in [docs/reference/self-hosting.md](docs/reference/deployment.md).\n\n**Docker**\n\n```bash\ngit clone https://github.com/nirholas/cryptocurrency.cv.git\ncd cryptocurrency.cv\ndocker compose up -d\n# API on http://localhost:3000/api/news\n```\n\nThe [`Dockerfile`](Dockerfile) builds a standalone image; [`docker-compose.yml`](docker-compose.yml) adds Redis for caching. Scale-out and observability variants: [`docker-compose.scale.yml`](docker-compose.scale.yml), [`docker-compose.observability.yml`](docker-compose.observability.yml).\n\n**Google Cloud Run**\n\n```bash\ngcloud builds submit --config cloudbuild.yaml\n```\n\nStep-by-step, including Artifact Registry, secrets and a custom domain: [docs/DEPLOY-GCP.md](docs/DEPLOY-GCP.md).\n\n**Vercel**\n\n[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fnirholas%2Fcryptocurrency.cv)\n\n**From source**\n\n```bash\npnpm install\npnpm dev # http://localhost:3000\npnpm build && pnpm start\n```\n\nRailway, Render, DigitalOcean, CasaOS, Unraid and Portainer templates are in the repo root (`railway.json`, `render.yaml`, `.do/`, `casaos-app.yaml`, `unraid-template.xml`, `portainer-template.json`). General deployment notes: [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md).\n\n---\n\n## 🏗️ Architecture\n\n1. **Next.js 15 App Router** on the Edge and Node runtimes; [`src/app/api/`](src/app/api/) holds every route handler.\n2. **Source registry** in [`src/lib/crypto-news.ts`](src/lib/crypto-news.ts) (RSS feeds by category) and [`src/lib/international-sources.ts`](src/lib/international-sources.ts); credibility tiers in [`src/lib/source-tiers.ts`](src/lib/source-tiers.ts).\n3. **Fetch layer** pulls feeds in parallel with per-source timeouts, dedupes by content hash, and normalises to the article schema above.\n4. **Caching** at three levels: in-memory, Redis (optional), and CDN `s-maxage` headers, so a cold fetch is rare.\n5. **AI layer** calls Groq for summaries, sentiment, fact-checks and briefs; RAG indexes the archive into pgvector ([docs/RAG.md](docs/RAG.md)).\n6. **Archive** is append-only JSONL by month, enriched with tickers, entities, sentiment and market context, exposed through `/api/archive`.\n7. **Realtime** via SSE and a WebSocket server ([`ws-server.js`](ws-server.js)) fed by the same fetch layer.\n8. **Payments**: premium routes are gated by x402; the facilitator lives in [`x402-facilitator/`](x402-facilitator/).\n9. **Agents**: MCP (hosted at `/api/mcp`, local in [`mcp/`](mcp/)), OpenAPI, `llms.txt`, and `/.well-known/*` manifests are generated from the same route metadata.\n10. **Web app**: 89 pages of React server and client components, installable as a PWA, localised into 42 languages.\n\nDeeper reading: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md), [docs/reference/architecture.md](docs/reference/architecture.md), [docs/SCALABILITY.md](docs/SCALABILITY.md).\n\n---\n\n## 📚 Documentation\n\n| Document | What it covers |\n| --- | --- |\n| [Developer portal](https://cryptocurrency.cv/developers) | Interactive endpoint explorer |\n| [docs/API.md](docs/API.md) | API reference with parameters and examples |\n| [docs/QUICKSTART.md](docs/QUICKSTART.md) | Five-minute integration guide |\n| [docs/AI-FEATURES.md](docs/AI-FEATURES.md) | AI endpoints and RAG |\n| [docs/sdks/](docs/sdks/index.md) | Per-language client guides |\n| [docs/reference/](docs/reference/README.md) | Everything that used to live in this README: full endpoint catalog, pages, sources, archive, PWA, integrations, deployment, roadmap |\n| [docs/USER-GUIDE.md](docs/USER-GUIDE.md) | Web app features and keyboard shortcuts |\n| [AGENTS.md](AGENTS.md) / [SKILLS.md](SKILLS.md) | Agent integration guide and skill catalog |\n| [CHANGELOG.md](CHANGELOG.md) | Version history |\n\n---\n\n## 🤝 Contributing\n\nBug fixes, new sources, translations and docs are all welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) for the workflow, [SUPPORT.md](SUPPORT.md) for where to ask questions, and [SECURITY.md](SECURITY.md) to report a vulnerability. Contributions are accepted under the repository license below.\n\n- Add a news source: open an issue with the [new source template](.github/ISSUE_TEMPLATE/new_source.md) or edit `src/lib/crypto-news.ts`.\n- Improve a translation: edit the file under [`locales/`](locales/README.md).\n\n---\n\n## 📄 License\n\nSource-available, all rights reserved. See [LICENSE](LICENSE) for the code terms.\n\nThe hosted API at [cryptocurrency.cv](https://cryptocurrency.cv) is free to use, with or without attribution. Running the code yourself, redistributing it, or building a competing hosted service requires permission under the terms in LICENSE.\n\n---\n\n## ⭐ Star History\n\n\n \n \n \n \n \n\n",
"bytes": 19415,
"sha": "3e5ee40063bf007aec958736a2751225f1fc9edc0d12646ea0b1fad0bf721bf8",
"repo_slug": "nirholas/free-crypto-news",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_github_nirholas_free_crypto_news_92a0f857/readme"
}
![\"GitHub](\"https://img.shields.io/github/stars/nirholas/cryptocurrency.cv?style=for-the-badge&logo=github&color=yellow\")
\n ![\"License:](\"https://img.shields.io/badge/license-source--available-blue?style=for-the-badge\"){kind=icon}
\n ![\"Issues\"](\"https://img.shields.io/github/issues/nirholas/cryptocurrency.cv?style=for-the-badge&color=orange\")
\n![\"Last](\"https://img.shields.io/github/last-commit/nirholas/cryptocurrency.cv?style=flat-square\")
![\"Contributors\"](\"https://img.shields.io/github/contributors/nirholas/cryptocurrency.cv?style=flat-square\")
![\"npm\"](\"https://img.shields.io/npm/v/@nirholas/crypto-news?style=flat-square&label=%40nirholas%2Fcrypto-news\")
![\"MCP](\"https://img.shields.io/badge/MCP-hosted%20endpoint-5B4EFF?style=flat-square\"){kind=icon}
![\"OpenAPI\"](\"https://img.shields.io/badge/OpenAPI-3.1-6BA539?style=flat-square\"){kind=icon}
![\"Free](\".github/demo.svg\")
\n