python

Python SDK

Zero dependencies Python client for Crypto Data Aggregator API.

Free tier available - No API key required for basic endpoints!

Installation

Just copy crypto_news.py to your project - no pip install needed!

Or for convenience:

curl -O https://raw.githubusercontent.com/nirholas/free-crypto-news/main/sdk/python/crypto_news.py

Quick Start

from crypto_news import CryptoNews

# Free usage (no auth required for basic endpoints)
news = CryptoNews()

# Or with API key for premium endpoints
news = CryptoNews(api_key='cda_free_xxxxx')

Free Endpoints

# Get latest news
articles = news.get_latest(limit=10)
for article in articles:
    print(f"{article['title']} - {article['source']}")

# Search for specific topics
eth_news = news.search("ethereum,eth")

# Get DeFi news
defi = news.get_defi(limit=5)

# Get Bitcoin news
btc = news.get_bitcoin(limit=5)

# Get breaking news (last 2 hours)
breaking = news.get_breaking()

# List all sources
sources = news.get_sources()

Premium Endpoints (API Key or x402)

# Set API key
news.set_api_key('cda_free_xxxxx')

# Get premium coin data
coins = news.get_premium_coins(per_page=10)

# Get historical data
history = news.get_historical('bitcoin', days=30)

# Export data
data = news.export_data('bitcoin', format='csv', days=90)

# Check usage
usage = news.get_usage()
print(f"{usage['remaining']}/{usage['limit']} requests remaining")

# Check rate limits after any request
rate_limit = news.get_rate_limit_info()

Error Handling

from crypto_news import CryptoNews, RateLimitError, PaymentRequiredError

try:
    coins = news.get_premium_coins()
except RateLimitError as e:
    print(f'Rate limit exceeded. Retry after: {e.retry_after}')
except PaymentRequiredError as e:
    print(f'Payment required: {e.payment_required}')

Analytics & Trends

# Trending topics with sentiment
trending = news.get_trending(limit=10, hours=24)
for topic in trending['trending']:
    print(f"{topic['topic']}: {topic['sentiment']}")

# API statistics
stats = news.get_stats()

# Sentiment analysis
analysis = news.analyze(limit=20, topic='bitcoin', sentiment='bullish')
print(f"Market: {analysis['summary']['overall_sentiment']}")

Historical & Sources

# Get archived news
archive = news.get_archive(date='2024-01-15', query='SEC', limit=20)

# Find original sources
origins = news.get_origins(query='binance', category='exchange')
for item in origins['items']:
    print(f"{item['title']} - Original: {item['likely_original_source']}")

Available Methods

Method	Description
get_latest(limit, source)	Get latest news
search(keywords, limit)	Search by keywords
get_defi(limit)	DeFi news
get_bitcoin(limit)	Bitcoin news
get_breaking(limit)	Breaking news (last 2 hours)
get_sources()	List all sources
get_trending(limit, hours)	Trending topics
get_stats()	API statistics
get_health()	API health status
analyze(limit, topic, sentiment)	News with sentiment analysis
get_archive(date, query, limit)	Historical archive
get_origins(query, category, limit)	Find original sources

Quick Functions

from crypto_news import get_crypto_news, search_crypto_news, get_trending_topics

# One-liner to get news
articles = get_crypto_news(10)

# One-liner to search
results = search_crypto_news("bitcoin etf")

# One-liner for trending
topics = get_trending_topics(5)

Self-Hosted

news = CryptoNews(base_url="https://your-deployment.vercel.app")

No API Key Required!

This is a 100% free API. No authentication, no rate limits (fair use).