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

GitHub Stars License: source-available Issues

Last Commit Contributors npm MCP Server OpenAPI

Início Rápido • O Que Você Obtém • Endpoints • MCP • Auto-Hospedagem • Docs

Free Crypto News API Demo

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

RecursoDetalhes
FontesMais 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
EndpointsMais 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órico662.047 artigos desde setembro de 2017, pesquisáveis por data, ticker, sentimento e texto completo. Arquivo
Endpoints de IAResumos, sentimento, verificação de fatos, narrativas, modo de pesquisa, RAG sobre o arquivo, resumos diários. Gratuitos, com tecnologia Groq. Docs de IA
Servidor MCPEndpoint hospedado Streamable-HTTP, além de um servidor stdio local, com mais de 40 ferramentas. Abaixo
Feeds e streamingRSS 2.0, Atom, OPML, Server-Sent Events, WebSocket. Tempo real
WidgetsTicker de notícias e carrossel em HTML/JS prontos para incorporar. widget/
Aplicativo web89 páginas: painéis, portfólio, listas de observação, alertas, gráficos, PWA instalável. Páginas
Exemplos de SDKClientes em sdk/, exemplos em examples/, guias em docs/sdks/
Pronto para agentesllms.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 NewsCryptoPanicOutros
Preço🆓 Gratuito$29-299/mêsPago
Chave de API❌ Nenhuma necessáriaObrigatóriaObrigatória
Limite de requisiçõesIlimitado*100-1000/diaLimitado
FontesMais de 300 em inglês + 77 internacionais1Varia
Histórico📚 Mais de 662.000 artigos (2017-2026)LimitadoNenhum
Internacional🌏 KO, ZH, JA, ES + traduçãoNãoNão
Auto-hospedagem✅ Docker / Cloud Run / VercelNãoNão
PWA✅ InstalávelNãoNão
MCP✅ Hospedado + localNãoNão
Exemplos de SDK12 idiomas01-2
Recursos de IAMais de 30 endpoints de IA (gratuitos)NãoNã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.

ÁreaEndpointsObservaçõ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=institutional21 categorias, veja o catálogo
Internacional/api/news/international?lang=ko, /api/news?translate=es77 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/predictionsGratuitos via Groq
Sentimento e redes sociais/api/sentiment, /api/fear-greed, /api/trending, /api/socialInclui sentimento de X/Twitter sem chave
Dados de mercado/api/market, /api/prices, /api/defi, /api/gas, /api/yields, /api/hyperliquidPreços, DeFi, gas, derivativos
On-chain/api/whales, /api/whale-alerts, /api/flows, /api/liquidations, /api/unlocksAlertas de baleias, fluxos de exchanges, calendário de desbloqueios
Portfólio e sinais/api/portfolio, /api/signals, /api/alertsNotícias conscientes do portfólio, sinais de negociação
Arquivo/api/archive?date=2024-01, ?ticker=BTC, ?q=, ?stats=true662 mil artigos, veja arquivo
Feeds/api/rss, /api/atom, /api/opml, /api/sse, WebSocketStreaming e sindicação
Meta/api/sources, /api/health, /api/openapi.json, /api/statsLista de fontes, tempo de atividade, especificação
Premium (x402)/api/premium/*, /.well-known/x402Pague por chamada com USDC, sem conta. Docs x402
Conformidade x402/api/x402/conformanceAudite 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

Deploy with 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

  1. Next.js 15 App Router nos runtimes Edge e Node; src/app/api/ contém todos os manipuladores de rotas.
  2. Registro de fontes em src/lib/crypto-news.ts (feeds RSS por categoria) e src/lib/international-sources.ts; níveis de credibilidade em src/lib/source-tiers.ts.
  3. 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.
  4. 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.
  5. Camada de IA chama Groq para resumos, sentimento, verificações de fatos e briefings; RAG indexa o arquivo em pgvector (docs/RAG.md).
  6. Arquivo é JSONL somente de acréscimo por mês, enriquecido com tickers, entidades, sentimento e contexto de mercado, exposto por meio de /api/archive.
  7. Tempo real via SSE e um servidor WebSocket (ws-server.js) alimentado pela mesma camada de busca.
  8. Pagamentos: rotas premium são protegidas por x402; o facilitador vive em x402-facilitator/. O contrato de descoberta que essas rotas publicam é auditado por sdk/x402-conformance/, que também é distribuído de forma independente: npx @nirholas/x402-conformance <origin>.
  9. Agentes: manifestos MCP (hospedado em /api/mcp, local em mcp/), OpenAPI, llms.txt e /.well-known/* são gerados a partir dos mesmos metadados de rota.
  10. 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

DocumentoO que cobre
Portal do desenvolvedorExplorador interativo de endpoints
docs/API.mdReferência da API com parâmetros e exemplos
docs/QUICKSTART.mdGuia de integração de cinco minutos
docs/AI-FEATURES.mdEndpoints 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.mdRecursos do aplicativo web e atalhos de teclado
AGENTS.md / SKILLS.mdGuia de integração de agentes e catálogo de habilidades
CHANGELOG.mdHistó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.


⭐ Histórico de Estrelas

Star History Chart