free-crypto-news-guide git:20260501.87cefc9A

Immutable. This exact content is served forever at /api/v1/blob/cf00b4004bf24a49.

---
name: free-crypto-news-guide
description: Guide to free-crypto-news — a free, no-API-key-required crypto news aggregator. Fetches headlines from 15+ sources including CoinDesk, The Block, Decrypt, CoinTelegraph, and more. Features RSS parsing, keyword filtering, sentiment scoring, and webhook notifications.
license: MIT
metadata:
  category: news
  difficulty: beginner
  author: nich
  tags: [news, free-crypto-news-guide]
---

# Free Crypto News Aggregator Guide

A free, no-API-key-required crypto news aggregator that scrapes 15+ sources. Headlines, keyword search, sentiment scoring, and webhook notifications — all without rate limits or API keys.

## Sources

| Source | Type | Update Frequency |
|--------|------|-----------------|
| CoinDesk | News | Every 15 min |
| The Block | News + Research | Every 30 min |
| Decrypt | News | Every 15 min |
| CoinTelegraph | News | Every 15 min |
| DeFi Pulse | DeFi News | Hourly |
| Blockworks | Institutional | Every 30 min |
| The Defiant | DeFi Focus | Hourly |
| Messari | Research | Daily |
| Rekt News | Security/Hacks | As events occur |
| CryptoSlate | News | Every 15 min |
| Bitcoin Magazine | Bitcoin Focus | Hourly |
| Delphi Digital | Research | Daily |
| And 5+ more... | Various | Various |

## Quick Start

### Python
```bash
pip install free-crypto-news
```

```python
from free_crypto_news import NewsFeed

feed = NewsFeed()

# Get latest headlines
headlines = feed.get_latest(limit=20)
for article in headlines:
    print(f"[{article.source}] {article.title}")
    print(f"  {article.url}")
    print(f"  {article.published_at}")
```

### Node.js
```bash
npm install free-crypto-news
```

```typescript
import { NewsFeed } from 'free-crypto-news';

const feed = new NewsFeed();
const headlines = await feed.getLatest({ limit: 20 });
```

## Features

### Keyword Search
```python
# Search for Sperax news
sperax_news = feed.search('sperax OR USDs OR SPA token', limit=10)

# Search for DeFi exploits
exploits = feed.search('exploit OR hack OR vulnerability', limit=10)

# Search for regulation news
regulation = feed.search('SEC OR regulation OR compliance', limit=10)
```

### Category Filtering
```python
# Filter by category
defi_news = feed.get_latest(category='defi', limit=20)
bitcoin_news = feed.get_latest(category='bitcoin', limit=20)
nft_news = feed.get_latest(category='nft', limit=20)
regulation_news = feed.get_latest(category='regulation', limit=20)
```

### Sentiment Scoring
```python
# Get headlines with sentiment
headlines = feed.get_latest(include_sentiment=True)
for article in headlines:
    print(f"{article.sentiment_score:.2f} | {article.title}")
    # 0.8 | "Ethereum breaks all-time high"
    # -0.6 | "Major DeFi protocol exploited for $50M"
```

### Webhook Notifications
```python
# Set up keyword alerts
feed.add_webhook(
    url='https://hooks.slack.com/services/xxx',
    keywords=['sperax', 'USDs', 'SPA'],
    min_sentiment=-1.0,  # All sentiment levels
    format='slack'
)

# Start monitoring
feed.start_monitoring(interval=300)  # Check every 5 minutes
```

### RSS Feed Generation
```python
# Generate RSS feed from aggregated news
rss = feed.to_rss(
    title='My Crypto News Feed',
    description='Aggregated crypto news',
    categories=['defi', 'bitcoin'],
    limit=50
)

# Save as XML
with open('feed.xml', 'w') as f:
    f.write(rss)
```

## MCP Server

```json
{
  "mcpServers": {
    "crypto-news": {
      "command": "npx",
      "args": ["free-crypto-news", "--mcp"]
    }
  }
}
```

Tools:
- `getLatestNews` — Latest headlines across all sources
- `searchNews` — Keyword search
- `getByCategory` — Filter by category
- `getSentiment` — News with sentiment scores
- `getTrending` — Trending topics

## SperaxOS Integration

Powers the crypto news tool in SperaxOS:
- Daily briefing generation
- News-based sentiment analysis
- Sperax ecosystem news monitoring
- Alert triggers for keywords

## Links

- GitHub: https://github.com/nirholas/free-crypto-news
- PyPI: https://pypi.org/project/free-crypto-news/
- npm: https://www.npmjs.com/package/free-crypto-news
- Sperax: https://app.sperax.io