Free Crypto News
API de notícias cripto gratuita + MCP - agregador em tempo real para Bitcoin, Ethereum, DeFi, Solana e altcoins. Nenhuma chave de API necessária. Feeds RSS/Atom, API REST JSON, arquivo histórico com contexto de mercado, widgets incorporáveis, plugin ChatGPT, servidor Claude MCP, SDKs (Python, TypeScript, Go, React, PHP). Pronto para IA/LLM. Amigável para vibe coding. Código aberto.
Documentação
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 (hospedado) ou npx -y @nirholas/free-crypto-news-mcp (local) license: código-fonte disponível (todos os direitos reservados), API hospedada gratuita para uso
🌐 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 as traduções
🆓 Free Crypto News API
Início Rápido • O Que Você Obtém • Endpoints • MCP • Auto-Hospedagem • Docs
Notícias de criptomoedas em tempo real de mais de 300 fontes com uma única chamada HTTP. Sem chave de API, sem cadastro, sem burocracia de limite de requisições. Disponível em 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
⭐ Se isso economizar seu tempo, dê uma estrela no repositório. Isso ajuda outras pessoas a encontrá-lo.
⚡ Início Rápido
Trinta segundos, sem chave necessária. cURL funciona como está:
# 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"
Todo endpoint retorna JSON, é habilitado para CORS e funciona a partir de um navegador, um script ou uma chamada de ferramenta de agente. Formato da resposta:
{
"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"
}
A partir do código, npm install @nirholas/crypto-news:
import { CryptoNews } from '@nirholas/crypto-news';
const news = await new CryptoNews().getLatest(10);
Clientes em Python, Go, PHP, Rust, Ruby, Swift, Kotlin, Java, C# e R estão em sdk/ como código-fonte copiável; exemplos executáveis para bots, agentes e 12 idiomas estão em examples/.
🎁 O Que Você Obtém
| Recurso | Detalhes |
|---|---|
| Fontes | Mais de 300 feeds RSS em 21 categorias, além de 77 veículos internacionais (KO, ZH, JA, ES e outros) com tradução em tempo real. Classificadas por credibilidade. Detalhes |
| Endpoints | Mais de 450 rotas: notícias, busca, categorias, dados de mercado, DeFi, baleias, regulatório, portfólio, sinais de negociação, feeds. Catálogo |
| Arquivo histórico | 662.047 artigos desde setembro de 2017, pesquisáveis por data, ticker, sentimento e texto completo. Arquivo |
| Endpoints de IA | Resumos, sentimento, verificação de fatos, narrativas, modo de pesquisa, RAG sobre o arquivo, resumos diários. Gratuitos, com tecnologia Groq. Docs de IA |
| Servidor MCP | Endpoint hospedado Streamable-HTTP, além de um servidor stdio local, com mais de 40 ferramentas. Abaixo |
| Feeds e streaming | RSS 2.0, Atom, OPML, Server-Sent Events, WebSocket. Tempo real |
| Widgets | Ticker de notícias e carrossel em HTML/JS prontos para incorporar. widget/ |
| Aplicativo web | 89 páginas: painéis, portfólio, listas de observação, alertas, gráficos, PWA instalável. Páginas |
| Exemplos de SDK | Clientes em sdk/, exemplos em examples/, guias em docs/sdks/ |
| Pronto para agentes | llms.txt, OpenAPI 3.1, /.well-known/agent.json, /.well-known/ai-plugin.json, micropagamentos x402 para rotas premium. AGENTS.md |
Como se compara
| Free Crypto News | CryptoPanic | Outros | |
|---|---|---|---|
| Preço | 🆓 Gratuito | $29-299/mês | Pago |
| Chave de API | ❌ Nenhuma necessária | Obrigatória | Obrigatória |
| Limite de requisições | Ilimitado* | 100-1000/dia | Limitado |
| Fontes | Mais de 300 em inglês + 77 internacionais | 1 | Varia |
| Histórico | 📚 Mais de 662.000 artigos (2017-2026) | Limitado | Nenhum |
| Internacional | 🌏 KO, ZH, JA, ES + tradução | Não | Não |
| Auto-hospedagem | ✅ Docker / Cloud Run / Vercel | Não | Não |
| PWA | ✅ Instalável | Não | Não |
| MCP | ✅ Hospedado + local | Não | Não |
| Exemplos de SDK | 12 idiomas | 0 | 1-2 |
| Recursos de IA | Mais de 30 endpoints de IA (gratuitos) | Não | Não |
* Uso justo. Faça cache no seu lado e identifique seu cliente com um User-Agent; tráfego abusivo é limitado.
🔌 Endpoints
Um mapa compacto da API, agrupado por área. O explorador interativo está em cryptocurrency.cv/developers, a referência narrativa está em docs/API.md, e o catálogo completo com mais de 450 rotas está em docs/reference/endpoints.md.
| Área | Endpoints | Observações |
|---|---|---|
| Notícias | /api/news, /api/breaking, /api/search?q=, /api/news?category= | Parâmetros limit, source, page, category |
| Categorias | /api/bitcoin, /api/defi, /api/news?category=institutional | 21 categorias, veja o catálogo |
| Internacional | /api/news/international?lang=ko, /api/news?translate=es | 77 veículos, 18 idiomas de tradução |
| IA | /api/ask, /api/ai (resumir, sentimento, verificação de fatos), /api/ai/summarize, /api/ai/narratives, /api/ai/research, /api/ai/brief, /api/rag, /api/predictions | Gratuitos via Groq |
| Sentimento e redes sociais | /api/sentiment, /api/fear-greed, /api/trending, /api/social | Inclui sentimento de X/Twitter sem chave |
| Dados de mercado | /api/market, /api/prices, /api/defi, /api/gas, /api/yields, /api/hyperliquid | Preços, DeFi, gas, derivativos |
| On-chain | /api/whales, /api/whale-alerts, /api/flows, /api/liquidations, /api/unlocks | Alertas de baleias, fluxos de exchanges, calendário de desbloqueios |
| Portfólio e sinais | /api/portfolio, /api/signals, /api/alerts | Notícias conscientes do portfólio, sinais de negociação |
| Arquivo | /api/archive?date=2024-01, ?ticker=BTC, ?q=, ?stats=true | 662 mil artigos, veja arquivo |
| Feeds | /api/rss, /api/atom, /api/opml, /api/sse, WebSocket | Streaming e sindicação |
| Meta | /api/sources, /api/health, /api/openapi.json, /api/stats | Lista de fontes, tempo de atividade, especificação |
| Premium (x402) | /api/premium/*, /.well-known/x402 | Pague por chamada com USDC, sem conta. Docs x402 |
| Conformidade x402 | /api/x402/conformance | Audite o contrato de descoberta de qualquer API x402 em relação aos desafios que ela realmente retorna. docs, página |
| Versionado | /api/v1/* | Aliases estáveis para tudo acima |
Exemplos de endpoints de IA
As rotas de IA também não precisam de chave. Elas rodam na integração hospedada do 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"
Arquivo histórico
662.047 artigos (cobertura em inglês do CryptoPanic desde setembro de 2017, além da cobertura em chinês do Odaily), enriquecidos com tickers, entidades nomeadas, sentimento e o preço de BTC/ETH e a leitura de Medo e Ganância no momento da 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, layout de diretórios e todos os parâmetros de consulta: docs/reference/archive.md.
🔮 Servidor MCP
Use toda a API a partir do Claude Desktop, Claude Code, Cursor ou qualquer cliente do Model Context Protocol. Mais de 40 ferramentas (notícias, busca, arquivo, sentimento, dados de mercado, portfólio); a lista completa de ferramentas está em mcp/README.md.
Endpoint hospedado, zero instalação. Um servidor Streamable-HTTP roda em https://cryptocurrency.cv/api/mcp:
{
"mcpServers": {
"crypto-news": {
"url": "https://cryptocurrency.cv/api/mcp"
}
}
}
Claude Code, uma linha:
claude mcp add --transport http crypto-news https://cryptocurrency.cv/api/mcp
Servidor stdio local. As mesmas ferramentas na sua máquina, publicadas como @nirholas/free-crypto-news-mcp (código-fonte em mcp/):
{
"mcpServers": {
"crypto-news": {
"command": "npx",
"args": ["-y", "@nirholas/free-crypto-news-mcp"]
}
}
}
Ou execute a partir de um checkout: git clone https://github.com/nirholas/cryptocurrency.cv.git && cd cryptocurrency.cv/mcp && npm install && node index.js.
Outras superfícies de agente: um GPT personalizado do ChatGPT e manifesto de plugin OpenAI (/.well-known/ai-plugin.json), cartão de agente Google A2A (/.well-known/agent.json), exemplos LangChain e CrewAI em examples/agents/, e integrações copiar-e-colar para Discord, Telegram, Slack e LangChain em docs/reference/integrations.md.
🧩 Widgets
Incorpore um feed de notícias ao vivo em qualquer página com uma única tag de script. Código-fonte e exemplos em 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 rola manchetes, carousel.js renderiza cartões, embed.js insere um feed completo em um contêiner. Todos os três leem atributos data-* para limite, categoria, velocidade e tema.
🐳 Auto-Hospedagem
Tudo roda a partir de um único aplicativo Next.js. Todas as variáveis de ambiente são opcionais; sem nenhuma, você obtém a API de notícias completa. Defina GROQ_API_KEY (gratuito em console.groq.com) para ativar os endpoints de IA. A lista completa de variáveis, manifestos Kubernetes e stack de observabilidade estão em 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
O Dockerfile cria uma imagem independente; docker-compose.yml adiciona Redis para cache. Variantes de escala e observabilidade: docker-compose.scale.yml, docker-compose.observability.yml.
Google Cloud Run
gcloud builds submit --config cloudbuild.yaml
Passo a passo, incluindo Artifact Registry, segredos e um domínio personalizado: docs/DEPLOY-GCP.md.
Vercel
A partir do código-fonte
pnpm install
pnpm dev # http://localhost:3000
pnpm build && pnpm start
Modelos para Railway, Render, DigitalOcean, CasaOS, Unraid e Portainer estão na raiz do repositório (railway.json, render.yaml, .do/, casaos-app.yaml, unraid-template.xml, portainer-template.json). Observações gerais de implantação: docs/DEPLOYMENT.md.
🏗️ Arquitetura
- Next.js 15 App Router nos runtimes Edge e Node;
src/app/api/contém todos os manipuladores de rotas. - Registro de fontes em
src/lib/crypto-news.ts(feeds RSS por categoria) esrc/lib/international-sources.ts; níveis de credibilidade emsrc/lib/source-tiers.ts. - Camada de busca puxa feeds em paralelo com timeouts por fonte, remove duplicatas por hash de conteúdo e normaliza para o esquema de artigo acima.
- Cache em três níveis: em memória, Redis (opcional) e cabeçalhos CDN
s-maxage, para que uma busca a frio seja rara. - Camada de IA chama Groq para resumos, sentimento, verificações de fatos e briefings; RAG indexa o arquivo em pgvector (docs/RAG.md).
- Arquivo é JSONL somente de acréscimo por mês, enriquecido com tickers, entidades, sentimento e contexto de mercado, exposto por meio de
/api/archive. - Tempo real via SSE e um servidor WebSocket (
ws-server.js) alimentado pela mesma camada de busca. - Pagamentos: rotas premium são protegidas por x402; o facilitador vive em
x402-facilitator/. O contrato de descoberta que essas rotas publicam é auditado porsdk/x402-conformance/, que também é distribuído de forma independente:npx @nirholas/x402-conformance <origin>. - Agentes: manifestos MCP (hospedado em
/api/mcp, local emmcp/), OpenAPI,llms.txte/.well-known/*são gerados a partir dos mesmos metadados de rota. - Aplicativo web: 89 páginas de componentes React de servidor e cliente, instalável como PWA, localizado em 42 idiomas.
Leitura aprofundada: docs/ARCHITECTURE.md, docs/reference/architecture.md, docs/SCALABILITY.md.
📚 Documentação
| Documento | O que cobre |
|---|---|
| Portal do desenvolvedor | Explorador interativo de endpoints |
| docs/API.md | Referência da API com parâmetros e exemplos |
| docs/QUICKSTART.md | Guia de integração de cinco minutos |
| docs/AI-FEATURES.md | Endpoints de IA e RAG |
| docs/sdks/ | Guias de clientes por idioma |
| docs/reference/ | Tudo o que costumava viver neste README: catálogo completo de endpoints, páginas, fontes, arquivo, PWA, integrações, implantação, roadmap |
| docs/USER-GUIDE.md | Recursos do aplicativo web e atalhos de teclado |
| AGENTS.md / SKILLS.md | Guia de integração de agentes e catálogo de habilidades |
| CHANGELOG.md | Histórico de versões |
🤝 Contribuindo
Correções de bugs, novas fontes, traduções e documentação são bem-vindas. Leia CONTRIBUTING.md para o fluxo de trabalho, SUPPORT.md para saber onde fazer perguntas e SECURITY.md para relatar uma vulnerabilidade. As contribuições são aceitas sob a licença do repositório abaixo.
- Adicionar uma fonte de notícias: abra uma issue com o modelo de nova fonte ou edite
src/lib/crypto-news.ts. - Melhorar uma tradução: edite o arquivo em
locales/.
📄 Licença
Código-fonte disponível, todos os direitos reservados. Veja LICENSE para os termos do código.
A API hospedada em cryptocurrency.cv é gratuita para uso, com ou sem atribuição. Executar o código você mesmo, redistribuí-lo ou construir um serviço hospedado concorrente requer permissão sob os termos da LICENSE.