🌐 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 | 简体中文 | 繁體中文 · all translations

🆓 Free Crypto News API

Real-time crypto news from 300+ sources with one HTTP call. No API key, no signup, no rate-limit paperwork. Live at cryptocurrency.cv.

For AI agents: curl https://cryptocurrency.cv/api/news • llms.txt • llms-full.txt • OpenAPI • MCP: https://cryptocurrency.cv/api/mcp • AGENTS.md • SKILLS.md

⭐ If this saves you time, star the repo. It helps others find it.

⚡ Quick Start

Thirty seconds, no key required. cURL works as-is:

# Latest headlines from every source
curl https://cryptocurrency.cv/api/news

# Only the last two hours
curl https://cryptocurrency.cv/api/breaking

# Full-text search
curl "https://cryptocurrency.cv/api/search?q=bitcoin%20etf"

# Filter by category, cap the result size
curl "https://cryptocurrency.cv/api/news?category=defi&limit=20"

# Ask a question, answered from today's news (AI)
curl "https://cryptocurrency.cv/api/ask?q=why%20is%20ETH%20up%20today"

Every endpoint returns JSON, is CORS-enabled, and works from a browser, a script, or an agent tool call. Response shape:

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

From code, npm install @nirholas/crypto-news:

import { CryptoNews } from '@nirholas/crypto-news';
const news = await new CryptoNews().getLatest(10);

Python, Go, PHP, Rust, Ruby, Swift, Kotlin, Java, C#, and R clients live in sdk/ as copy-in source; runnable samples for bots, agents, and 12 languages live in examples/.

🎁 What You Get

How it compares

* Fair use. Cache on your side and identify your client with a User-Agent; abusive traffic gets throttled.

🔌 Endpoints

A compact map of the API, grouped by area. The interactive explorer is at cryptocurrency.cv/developers, the narrative reference is docs/API.md, and the complete 450+ route catalog is docs/reference/endpoints.md.

AI endpoint examples

The AI routes need no key either. They run on the hosted Groq integration:

# Natural-language question over today's news
curl "https://cryptocurrency.cv/api/ask?q=what%20happened%20with%20the%20SEC%20this%20week"

# One-paragraph summary of the current feed
curl "https://cryptocurrency.cv/api/ai/summarize"

# Emerging narratives, ranked by momentum
curl "https://cryptocurrency.cv/api/ai/narratives?emerging=true"

# Daily brief for a given date
curl "https://cryptocurrency.cv/api/ai/brief?date=2026-08-26&format=summary"

# Retrieval-augmented answer over the 662k-article archive
curl "https://cryptocurrency.cv/api/rag?q=bitcoin%20etf%20approval%20timeline"

Historical archive

662,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.

curl "https://cryptocurrency.cv/api/archive?date=2024-01"                 # one month
curl "https://cryptocurrency.cv/api/archive?ticker=BTC&limit=100"          # by ticker
curl "https://cryptocurrency.cv/api/archive?q=bitcoin%20etf"               # full text
curl "https://cryptocurrency.cv/api/archive?start_date=2025-01-01&end_date=2025-01-07"
curl "https://cryptocurrency.cv/api/archive?stats=true"                    # counts and coverage

Schema, directory layout and every query parameter: docs/reference/archive.md.

🔮 MCP Server

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

Hosted endpoint, zero install. A Streamable-HTTP server runs at https://cryptocurrency.cv/api/mcp:

{
  "mcpServers": {
    "crypto-news": {
      "url": "https://cryptocurrency.cv/api/mcp"
    }
  }
}

Claude Code, one line:

claude mcp add --transport http crypto-news https://cryptocurrency.cv/api/mcp

Local stdio server. The same tools on your machine, published as @nirholas/free-crypto-news-mcp (source in mcp/):

{
  "mcpServers": {
    "crypto-news": {
      "command": "npx",
      "args": ["-y", "@nirholas/free-crypto-news-mcp"]
    }
  }
}

Or run it from a checkout: git clone https://github.com/nirholas/cryptocurrency.cv.git && cd cryptocurrency.cv/mcp && npm install && node index.js.

Other 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/, and copy-paste integrations for Discord, Telegram, Slack and LangChain in docs/reference/integrations.md.

🧩 Widgets

Embed a live news feed in any page with one script tag. Source and examples in widget/.

<div id="crypto-ticker" data-limit="20" data-category="all" data-theme="dark"></div>
<script src="https://cryptocurrency.cv/widget/ticker.js"></script>

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.

🐳 Self-Hosting

Everything 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) to switch on the AI endpoints. The complete variable list, Kubernetes manifests and observability stack are in docs/reference/self-hosting.md.

Docker

git clone https://github.com/nirholas/cryptocurrency.cv.git
cd cryptocurrency.cv
docker compose up -d
# API on http://localhost:3000/api/news

The Dockerfile builds a standalone image; docker-compose.yml adds Redis for caching. Scale-out and observability variants: docker-compose.scale.yml, docker-compose.observability.yml.

Google Cloud Run

gcloud builds submit --config cloudbuild.yaml

Step-by-step, including Artifact Registry, secrets and a custom domain: docs/DEPLOY-GCP.md.

Vercel

From source

pnpm install
pnpm dev        # http://localhost:3000
pnpm build && pnpm start

Railway, 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.

🏗️ Architecture

1. Next.js 15 App Router on the Edge and Node runtimes; src/app/api/ holds every route handler.
2. Source registry in src/lib/crypto-news.ts (RSS feeds by category) and src/lib/international-sources.ts; credibility tiers in src/lib/source-tiers.ts.
3. Fetch layer pulls feeds in parallel with per-source timeouts, dedupes by content hash, and normalises to the article schema above.
4. Caching at three levels: in-memory, Redis (optional), and CDN s-maxage headers, so a cold fetch is rare.
5. AI layer calls Groq for summaries, sentiment, fact-checks and briefs; RAG indexes the archive into pgvector (docs/RAG.md).
6. Archive is append-only JSONL by month, enriched with tickers, entities, sentiment and market context, exposed through /api/archive.
7. Realtime via SSE and a WebSocket server (ws-server.js) fed by the same fetch layer.
8. Payments: premium routes are gated by x402; the facilitator lives in x402-facilitator/. The discovery contract those routes publish is audited by sdk/x402-conformance/, which also ships standalone: npx @nirholas/x402-conformance <origin>.
9. Agents: MCP (hosted at /api/mcp, local in mcp/), OpenAPI, llms.txt, and /.well-known/* manifests are generated from the same route metadata.
10. Web app: 89 pages of React server and client components, installable as a PWA, localised into 42 languages.

Deeper reading: docs/ARCHITECTURE.md, docs/reference/architecture.md, docs/SCALABILITY.md.

📚 Documentation

🤝 Contributing

Bug fixes, new sources, translations and docs are all welcome. Read CONTRIBUTING.md for the workflow, SUPPORT.md for where to ask questions, and SECURITY.md to report a vulnerability. Contributions are accepted under the repository license below.

• Add a news source: open an issue with the new source template or edit src/lib/crypto-news.ts.
• Improve a translation: edit the file under locales/.

📄 License

Source-available, all rights reserved. See LICENSE for the code terms.

The hosted API at 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.

⭐ Star History