Integration
Cryptocurrency.Cv
By Free crypto news API - real-time aggregator for Bitcoin, Ethereum, DeFi, Solana & altcoins. No API key required. RSS/Atom feeds, JSON REST API, historical archive with market context, embeddable widgets, ChatGPT plugin, Claude MCP server, SDKs (Python, TypeScript, Go, React, PHP). AI/LLM ready. Vibe coding friendly. Open source.
Install
npm install @nirholas/crypto-news`:Configuration Example
{
"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"
}README
---
name: Free Crypto News API
type: api
category: cryptocurrency
auth: none
pricing: free
endpoints: 450+
sources: 300+
llms_txt: https://cryptocurrency.cv/llms.txt
openapi: https://cryptocurrency.cv/api/openapi.json
mcp_server: https://cryptocurrency.cv/api/mcp (hosted) or npx -y @nirholas/free-crypto-news-mcp (local)
license: source-available (all rights reserved), hosted API free to use
---
🌐 **Languages (42):** English | [العربية](locales/README.ar.md) | [Български](locales/README.bg.md) | [বাংলা](locales/README.bn.md) | [Čeština](locales/README.cs.md) | [Dansk](locales/README.da.md) | [Deutsch](locales/README.de.md) | [Ελληνικά](locales/README.el.md) | [Español](locales/README.es.md) | [فارسی](locales/README.fa.md) | [Suomi](locales/README.fi.md) | [Français](locales/README.fr.md) | [עברית](locales/README.he.md) | [हिन्दी](locales/README.hi.md) | [Hrvatski](locales/README.hr.md) | [Magyar](locales/README.hu.md) | [Indonesia](locales/README.id.md) | [Italiano](locales/README.it.md) | [日本語](locales/README.ja.md) | [한국어](locales/README.ko.md) | [Melayu](locales/README.ms.md) | [Nederlands](locales/README.nl.md) | [Norsk](locales/README.no.md) | [Polski](locales/README.pl.md) | [Português](locales/README.pt.md) | [Română](locales/README.ro.md) | [Русский](locales/README.ru.md) | [Slovenčina](locales/README.sk.md) | [Slovenščina](locales/README.sl.md) | [Српски](locales/README.sr.md) | [Svenska](locales/README.sv.md) | [Kiswahili](locales/README.sw.md) | [தமிழ்](locales/README.ta.md) | [తెలుగు](locales/README.te.md) | [ไทย](locales/README.th.md) | [Filipino](locales/README.tl.md) | [Türkçe](locales/README.tr.md) | [Українська](locales/README.uk.md) | [اردو](locales/README.ur.md) | [Tiếng Việt](locales/README.vi.md) | [简体中文](locales/README.zh-CN.md) | [繁體中文](locales/README.zh-TW.md) · [all translations](locales/README.md)
# 🆓 Free Crypto News API
<p align="center">
<a href="https://github.com/nirholas/cryptocurrency.cv/stargazers"><img src="https://img.shields.io/github/stars/nirholas/cryptocurrency.cv?style=for-the-badge&logo=github&color=yellow" alt="GitHub Stars"></a>
<a href="https://github.com/nirholas/cryptocurrency.cv/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-source--available-blue?style=for-the-badge" alt="License: source-available"></a>
<a href="https://github.com/nirholas/cryptocurrency.cv/issues"><img src="https://img.shields.io/github/issues/nirholas/cryptocurrency.cv?style=for-the-badge&color=orange" alt="Issues"></a>
</p>
<p align="center">
<a href="https://github.com/nirholas/cryptocurrency.cv/commits/main"><img src="https://img.shields.io/github/last-commit/nirholas/cryptocurrency.cv?style=flat-square" alt="Last Commit"></a>
<a href="https://github.com/nirholas/cryptocurrency.cv/graphs/contributors"><img src="https://img.shields.io/github/contributors/nirholas/cryptocurrency.cv?style=flat-square" alt="Contributors"></a>
<a href="https://www.npmjs.com/package/@nirholas/crypto-news"><img src="https://img.shields.io/npm/v/@nirholas/crypto-news?style=flat-square&label=%40nirholas%2Fcrypto-news" alt="npm"></a>
<a href="https://cryptocurrency.cv/api/mcp"><img src="https://img.shields.io/badge/MCP-hosted%20endpoint-5B4EFF?style=flat-square" alt="MCP Server"></a>
<a href="https://cryptocurrency.cv/api/openapi.json"><img src="https://img.shields.io/badge/OpenAPI-3.1-6BA539?style=flat-square" alt="OpenAPI"></a>
</p>
<p align="center">
<a href="#-quick-start">Quick Start</a> •
<a href="#-what-you-get">What You Get</a> •
<a href="#-endpoints">Endpoints</a> •
<a href="#-mcp-server">MCP</a> •
<a href="#-self-hosting">Self-Host</a> •
<a href="https://cryptocurrency.cv/developers">Docs</a>
</p>
<p align="center">
<img src=".github/demo.svg" alt="Free Crypto News API Demo" width="700">
</p>
Real-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)**.
**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)
> ⭐ If this saves you time, star the repo. It helps others find it.
---
## ⚡ Quick Start
Thirty seconds, no key required. cURL works as-is:
```bash
# 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:
```json
{
"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`:
```ts
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/`](sdk/) as copy-in source; runnable samples for bots, agents, and 12 languages live in [`examples/`](examples/).
---
## 🎁 What You Get
| Capability | Details |
| --- | --- |
| **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) |
| **Endpoints** | 450+ routes: news, search, categories, market data, DeFi, whales, regulatory, portfolio, trading signals, feeds. [Catalog](docs/reference/endpoints.md) |
| **Historical archive** | 662,047 articles from September 2017 onward, searchable by date, ticker, sentiment and full text. [Archive](docs/reference/archive.md) |
| **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) |
| **MCP server** | Hosted Streamable-HTTP endpoint plus a local stdio server, 40+ tools. [Below](#-mcp-server) |
| **Feeds and streaming** | RSS 2.0, Atom, OPML, Server-Sent Events, WebSocket. [Realtime](docs/REALTIME.md) |
| **Widgets** | Drop-in HTML/JS news ticker and carousel. [`widget/`](widget/) |
| **Web app** | 89 pages: dashboards, portfolio, watchlists, alerts, charts, installable PWA. [Pages](docs/reference/pages.md) |
| **SDK examples** | Clients in [`sdk/`](sdk/), samples in [`examples/`](examples/), guides in [`docs/sdks/`](docs/sdks/index.md) |
| **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) |
### How it compares
| | Free Crypto News | CryptoPanic | Others |
| ----------------- | ------------------------------- | ------------ | -------- |
| **Price** | 🆓 Free | $29-299/mo | Paid |
| **API Key** | ❌ None needed | Required | Required |
| **Rate Limit** | Unlimited\* | 100-1000/day | Limited |
| **Sources** | 300+ English + 77 international | 1 | Varies |
| **Historical** | 📚 662,000+ articles (2017-2026) | Limited | None |
| **International** | 🌏 KO, ZH, JA, ES + translation | No | No |
| **Self-host** | ✅ Docker / Cloud Run / Vercel | No | No |
| **PWA** | ✅ Installable | No | No |
| **MCP** | ✅ Hosted + local | No | No |
| **SDK examples** | 12 languages | 0 | 1-2 |
| **AI Features** | 30+ AI endpoints (free) | No | No |
\* 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](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).
| Area | Endpoints | Notes |
| --- | --- | --- |
| **News** | `/api/news`, `/api/breaking`, `/api/search?q=`, `/api/news?category=` | `limit`, `source`, `page`, `category` params |
| **Categories** | `/api/bitcoin`, `/api/defi`, `/api/news?category=institutional` | 21 categories, see the catalog |
| **International** | `/api/news/international?lang=ko`, `/api/news?translate=es` | 77 outlets, 18 translation targets |
| **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 |
| **Sentiment and social** | `/api/sentiment`, `/api/fear-greed`, `/api/trending`, `/api/social` | Includes X/Twitter sentiment without a key |
| **Market data** | `/api/market`, `/api/prices`, `/api/defi`, `/api/gas`, `/api/yields`, `/api/hyperliquid` | Prices, DeFi, gas, derivatives |
| **On-chain** | `/api/whales`, `/api/whale-alerts`, `/api/flows`, `/api/liquidations`, `/api/unlocks` | Whale alerts, exchange flows, unlock calendar |
| **Portfolio and signals** | `/api/portfolio`, `/api/signals`, `/api/alerts` | Portfolio-aware news, trading signals |
| **Archive** | `/api/archive?date=2024-
... (truncated)
integration
Comments
Sign in to leave a comment