Free Crypto News
API de noticias cripto gratuita + MCP - agregador en tiempo real para Bitcoin, Ethereum, DeFi, Solana y altcoins. No requiere clave API. Feeds RSS/Atom, API REST JSON, archivo histórico con contexto de mercado, widgets integrables, plugin de ChatGPT, servidor Claude MCP, SDKs (Python, TypeScript, Go, React, PHP). Listo para IA/LLM. Compatible con vibe coding. Código abierto.
Documentación
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 (alojado) o npx -y @nirholas/free-crypto-news-mcp (local) license: código disponible (todos los derechos reservados), API alojada gratuita
🌐 Idiomas (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 | 简体中文 | 繁體中文 · todas las traducciones
🆓 API de Noticias de Criptomonedas Gratis
Inicio Rápido • Qué Obtienes • Endpoints • MCP • Autoalojamiento • Docs
Noticias de criptomonedas en tiempo real de más de 300 fuentes con una sola llamada HTTP. Sin clave API, sin registro, sin papeleo de límites de tasa. En vivo en cryptocurrency.cv.
Para agentes de IA: curl https://cryptocurrency.cv/api/news • llms.txt • llms-full.txt • OpenAPI • MCP: https://cryptocurrency.cv/api/mcp • AGENTS.md • SKILLS.md
⭐ Si esto te ahorra tiempo, dale una estrella al repositorio. Ayuda a que otros lo encuentren.
⚡ Inicio Rápido
Treinta segundos, sin clave requerida. cURL funciona tal cual:
# 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"
Cada endpoint devuelve JSON, está habilitado para CORS y funciona desde un navegador, un script o una llamada de herramienta de agente. Forma de la respuesta:
{
"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"
}
Desde código, npm install @nirholas/crypto-news:
import { CryptoNews } from '@nirholas/crypto-news';
const news = await new CryptoNews().getLatest(10);
Los clientes en Python, Go, PHP, Rust, Ruby, Swift, Kotlin, Java, C# y R viven en sdk/ como código copiable; ejemplos ejecutables para bots, agentes y 12 idiomas viven en examples/.
🎁 Qué Obtienes
| Capacidad | Detalles |
|---|---|
| Fuentes | Más de 300 feeds RSS en 21 categorías más 77 medios internacionales (KO, ZH, JA, ES y más) con traducción en tiempo real. Clasificadas por credibilidad. Detalles |
| Endpoints | Más de 450 rutas: noticias, búsqueda, categorías, datos de mercado, DeFi, ballenas, regulatorio, portafolio, señales de trading, feeds. Catálogo |
| Archivo histórico | 662,047 artículos desde septiembre de 2017, buscables por fecha, ticker, sentimiento y texto completo. Archivo |
| Endpoints de IA | Resúmenes, sentimiento, verificaciones de hechos, narrativas, modo investigación, RAG sobre el archivo, resúmenes diarios. Gratis, impulsado por Groq. Docs de IA |
| Servidor MCP | Endpoint alojado Streamable-HTTP más un servidor stdio local, más de 40 herramientas. Abajo |
| Feeds y streaming | RSS 2.0, Atom, OPML, Server-Sent Events, WebSocket. Tiempo real |
| Widgets | Ticker de noticias y carrusel HTML/JS listos para insertar. widget/ |
| Aplicación web | 89 páginas: paneles, portafolio, listas de seguimiento, alertas, gráficos, PWA instalable. Páginas |
| Ejemplos de SDK | Clientes en sdk/, ejemplos en examples/, guías en docs/sdks/ |
| Listo para agentes | llms.txt, OpenAPI 3.1, /.well-known/agent.json, /.well-known/ai-plugin.json, micropagos x402 para rutas premium. AGENTS.md |
Cómo se compara
| Free Crypto News | CryptoPanic | Otros | |
|---|---|---|---|
| Precio | 🆓 Gratis | $29-299/mes | De pago |
| Clave API | ❌ No necesaria | Requerida | Requerida |
| Límite de tasa | Ilimitado* | 100-1000/día | Limitado |
| Fuentes | 300+ en inglés + 77 internacionales | 1 | Varía |
| Histórico | 📚 662,000+ artículos (2017-2026) | Limitado | Ninguno |
| Internacional | 🌏 KO, ZH, JA, ES + traducción | No | No |
| Autoalojamiento | ✅ Docker / Cloud Run / Vercel | No | No |
| PWA | ✅ Instalable | No | No |
| MCP | ✅ Alojado + local | No | No |
| Ejemplos de SDK | 12 idiomas | 0 | 1-2 |
| Funciones de IA | Más de 30 endpoints de IA (gratis) | No | No |
* Uso justo. Almacena en caché de tu lado e identifica tu cliente con un User-Agent; el tráfico abusivo se limita.
🔌 Endpoints
Un mapa compacto de la API, agrupado por área. El explorador interactivo está en cryptocurrency.cv/developers, la referencia narrativa está en docs/API.md, y el catálogo completo de más de 450 rutas está en docs/reference/endpoints.md.
| Área | Endpoints | Notas |
|---|---|---|
| Noticias | /api/news, /api/breaking, /api/search?q=, /api/news?category= | Parámetros limit, source, page, category |
| Categorías | /api/bitcoin, /api/defi, /api/news?category=institutional | 21 categorías, ver el catálogo |
| Internacional | /api/news/international?lang=ko, /api/news?translate=es | 77 medios, 18 idiomas de traducción |
| IA | /api/ask, /api/ai (resumir, sentimiento, verificación de hechos), /api/ai/summarize, /api/ai/narratives, /api/ai/research, /api/ai/brief, /api/rag, /api/predictions | Gratis vía Groq |
| Sentimiento y redes sociales | /api/sentiment, /api/fear-greed, /api/trending, /api/social | Incluye sentimiento de X/Twitter sin clave |
| Datos de mercado | /api/market, /api/prices, /api/defi, /api/gas, /api/yields, /api/hyperliquid | Precios, DeFi, gas, derivados |
| On-chain | /api/whales, /api/whale-alerts, /api/flows, /api/liquidations, /api/unlocks | Alertas de ballenas, flujos de exchanges, calendario de desbloqueos |
| Portafolio y señales | /api/portfolio, /api/signals, /api/alerts | Noticias conscientes del portafolio, señales de trading |
| Archivo | /api/archive?date=2024-01, ?ticker=BTC, ?q=, ?stats=true | 662k artículos, ver archivo |
| Feeds | /api/rss, /api/atom, /api/opml, /api/sse, WebSocket | Streaming y sindicación |
| Meta | /api/sources, /api/health, /api/openapi.json, /api/stats | Lista de fuentes, tiempo de actividad, especificación |
| Premium (x402) | /api/premium/*, /.well-known/x402 | Paga por llamada con USDC, sin cuenta. Docs de x402 |
| Conformidad x402 | /api/x402/conformance | Audita el contrato de descubrimiento de cualquier API x402 contra los desafíos que realmente devuelve. docs, página |
| Versionado | /api/v1/* | Alias estables para todo lo anterior |
Ejemplos de endpoints de IA
Las rutas de IA tampoco necesitan clave. Se ejecutan en la integración alojada de Groq:
# 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"
Archivo histórico
662,047 artículos (cobertura en inglés de CryptoPanic desde septiembre de 2017 más cobertura en chino de Odaily), enriquecidos con tickers, entidades nombradas, sentimiento y el precio de BTC/ETH y la lectura de Miedo y Codicia en el momento de la captura.
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
Esquema, estructura de directorios y cada parámetro de consulta: docs/reference/archive.md.
🔮 Servidor MCP
Usa toda la API desde Claude Desktop, Claude Code, Cursor o cualquier cliente del Model Context Protocol. Más de 40 herramientas (noticias, búsqueda, archivo, sentimiento, datos de mercado, portafolio); la lista completa de herramientas está en mcp/README.md.
Endpoint alojado, cero instalación. Un servidor Streamable-HTTP se ejecuta en https://cryptocurrency.cv/api/mcp:
{
"mcpServers": {
"crypto-news": {
"url": "https://cryptocurrency.cv/api/mcp"
}
}
}
Claude Code, una línea:
claude mcp add --transport http crypto-news https://cryptocurrency.cv/api/mcp
Servidor stdio local. Las mismas herramientas en tu máquina, publicadas como @nirholas/free-crypto-news-mcp (código fuente en mcp/):
{
"mcpServers": {
"crypto-news": {
"command": "npx",
"args": ["-y", "@nirholas/free-crypto-news-mcp"]
}
}
}
O ejecútalo desde un checkout: git clone https://github.com/nirholas/cryptocurrency.cv.git && cd cryptocurrency.cv/mcp && npm install && node index.js.
Otras superficies de agente: un ChatGPT custom GPT y manifiesto de plugin de OpenAI (/.well-known/ai-plugin.json), tarjeta de agente Google A2A (/.well-known/agent.json), ejemplos de LangChain y CrewAI en examples/agents/, e integraciones de copiar y pegar para Discord, Telegram, Slack y LangChain en docs/reference/integrations.md.
🧩 Widgets
Incorpora un feed de noticias en vivo en cualquier página con una sola etiqueta de script. Fuente y ejemplos en 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 desplaza los titulares, carousel.js renderiza tarjetas, embed.js coloca un feed completo en un contenedor. Los tres leen atributos data-* para límite, categoría, velocidad y tema.
🐳 Autoalojamiento
Todo se ejecuta desde una sola aplicación Next.js. Todas las variables de entorno son opcionales; sin ninguna, obtienes la API de noticias completa. Configura GROQ_API_KEY (gratis en console.groq.com) para activar los endpoints de IA. La lista completa de variables, manifiestos de Kubernetes y stack de observabilidad están en 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
El Dockerfile construye una imagen independiente; docker-compose.yml agrega Redis para caché. Variantes de escalado y observabilidad: docker-compose.scale.yml, docker-compose.observability.yml.
Google Cloud Run
gcloud builds submit --config cloudbuild.yaml
Paso a paso, incluido Artifact Registry, secretos y un dominio personalizado: docs/DEPLOY-GCP.md.
Vercel
Desde el código fuente
pnpm install
pnpm dev # http://localhost:3000
pnpm build && pnpm start
Las plantillas de Railway, Render, DigitalOcean, CasaOS, Unraid y Portainer están en la raíz del repositorio (railway.json, render.yaml, .do/, casaos-app.yaml, unraid-template.xml, portainer-template.json). Notas generales de despliegue: docs/DEPLOYMENT.md.
🏗️ Arquitectura
- Next.js 15 App Router en los runtimes Edge y Node;
src/app/api/contiene todos los manejadores de rutas. - Registro de fuentes en
src/lib/crypto-news.ts(feeds RSS por categoría) ysrc/lib/international-sources.ts; niveles de credibilidad ensrc/lib/source-tiers.ts. - Capa de obtención extrae los feeds en paralelo con tiempos de espera por fuente, deduplica por hash de contenido y normaliza al esquema de artículos anterior.
- Caché en tres niveles: en memoria, Redis (opcional) y cabeceras CDN
s-maxage, de modo que una obtención en frío es poco frecuente. - Capa de IA llama a Groq para resúmenes, sentimiento, verificaciones de datos y resúmenes ejecutivos; RAG indexa el archivo en pgvector (docs/RAG.md).
- Archivo es JSONL de solo añadido por mes, enriquecido con tickers, entidades, sentimiento y contexto de mercado, expuesto a través de
/api/archive. - Tiempo real mediante SSE y un servidor WebSocket (
ws-server.js) alimentado por la misma capa de obtención. - Pagos: las rutas premium están protegidas por x402; el facilitador vive en
x402-facilitator/. El contrato de descubrimiento que publican esas rutas es auditado porsdk/x402-conformance/, que también se distribuye de forma independiente:npx @nirholas/x402-conformance <origin>. - Agentes: los manifiestos MCP (alojado en
/api/mcp, local enmcp/), OpenAPI,llms.txty/.well-known/*se generan a partir de los mismos metadatos de rutas. - Aplicación web: 89 páginas de componentes React de servidor y cliente, instalable como PWA, localizada en 42 idiomas.
Lectura más profunda: docs/ARCHITECTURE.md, docs/reference/architecture.md, docs/SCALABILITY.md.
📚 Documentación
| Documento | Qué cubre |
|---|---|
| Portal para desarrolladores | Explorador interactivo de endpoints |
| docs/API.md | Referencia de API con parámetros y ejemplos |
| docs/QUICKSTART.md | Guía de integración en cinco minutos |
| docs/AI-FEATURES.md | Endpoints de IA y RAG |
| docs/sdks/ | Guías de cliente por idioma |
| docs/reference/ | Todo lo que solía vivir en este README: catálogo completo de endpoints, páginas, fuentes, archivo, PWA, integraciones, despliegue, hoja de ruta |
| docs/USER-GUIDE.md | Funciones de la aplicación web y atajos de teclado |
| AGENTS.md / SKILLS.md | Guía de integración de agentes y catálogo de habilidades |
| CHANGELOG.md | Historial de versiones |
🤝 Contribuciones
Las correcciones de errores, nuevas fuentes, traducciones y documentación son bienvenidas. Lee CONTRIBUTING.md para el flujo de trabajo, SUPPORT.md para saber dónde hacer preguntas y SECURITY.md para reportar una vulnerabilidad. Las contribuciones se aceptan bajo la licencia del repositorio indicada abajo.
- Añadir una fuente de noticias: abre un issue con la plantilla de nueva fuente o edita
src/lib/crypto-news.ts. - Mejorar una traducción: edita el archivo en
locales/.
📄 Licencia
Código disponible, todos los derechos reservados. Consulta LICENSE para los términos del código.
La API alojada en cryptocurrency.cv es de uso gratuito, con o sin atribución. Ejecutar el código tú mismo, redistribuirlo o crear un servicio alojado competidor requiere permiso según los términos de LICENSE.