Skip to main content

Cryptocurrency exchange announcement news crawler for major crypto exchanges

Project description

Crypto Exchange News Crawler 🚀

A powerful and easy-to-use Python package for scraping cryptocurrency exchange announcements from major exchanges.

🎯 Features

  • Multi-Exchange Support: Scrape from 6 major crypto exchanges
  • Multiple Output Formats: JSON, CSV, and XML support
  • Structured Data: Clean, standardized output format
  • Rate Limiting: Built-in delays to respect exchange servers
  • Extensible: Easy to add new exchanges

📦 Installation Options

Option 1: Direct Usage

git clone https://github.com/lowweihong/crypto-exchange-news-crawler.git
cd crypto-exchange-news-crawler
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
playwright install chromium
scrapy crawl bybit -o output.json

Option 2: Install from PyPI

pip install crypto-exchange-news-crawler

## directly use proxy and uncomment DOWNLOADER_MIDDLEWARES
crypto-news crawl binance -o binance.json

crypto-news crawl bybit -s DOWNLOADER_MIDDLEWARES='{"crypto_exchange_news.middlewares.MyProxyMiddleware": 610}' -s PROXY_LIST="http://proxy1:port,http://proxy2:port"

Supported Exchanges

Exchange Status
Bybit
Binance
OKX
Bitget
Bitfinex
XT

📊 Output Format

Each scraped announcement includes:

{
    "news_id": "unique_identifier",
    "title": "Announcement title",
    "desc": "Announcement description",
    "url": "Full URL to announcement",
    "category_str": "Category (e.g., latest_activities, new_crypto)",
    "exchange": "Exchange name",
    "announced_at_timestamp": 1749235200,
    "timestamp": 1749232733
}

⚙️ Configuration

Key settings in settings.py:

  • MAX_PAGE: Maximum number of pages to crawl (default: 2)
  • DOWNLOAD_DELAY: Delay between requests in seconds (default: 3)
  • CONCURRENT_REQUESTS: Number of concurrent requests (default: 8)
  • USER_AGENT: List of user agents for rotation
  • PROXY_LIST: Fill the list with your proxy list and remember also to open uncomment the DOWNLOADER_MIDDLEWARES part to use the proxy middleware
  • PLAYWRIGHT_LAUNCH_OPTIONS: Browser configuration for Playwright spiders

Custom Settings

You can override settings from the command line:

scrapy crawl bitget -s MAX_PAGE=5 -s DOWNLOAD_DELAY=2

🔧 Technical Requirements

  • Python 3.7+
  • Scrapy 2.11.0+
  • Playwright (for Bitget spider)
  • Chromium browser (automatically installed with Playwright)

🌐 Exchange URLs

Direct links to announcement pages:

Exchange Announcement URL
Binance https://www.binance.com/en/support/announcement
OKX https://www.okx.com/help/category/announcements
Bybit https://announcements.bybit.com/en/?category=&page=1
Bitget https://www.bitget.com/support/sections/12508313443483
XT https://xtsupport.zendesk.com/hc/en-us/categories/10304894611993-Important-Announcements
Bitfinex https://www.bitfinex.com/posts/

⚖️ Legal & Ethical Usage

This crawler is designed for educational and research purposes. Please ensure you comply with:

  • Each exchange's Terms of Service
  • Rate limiting and robots.txt policies
  • Applicable data protection laws
  • Fair use guidelines

Always use the crawler responsibly and consider the impact on the target servers.

🤝 Contributing

Contributions welcome! Areas for improvement:

  • Add support for more exchanges (Huobi, KuCoin, Gateio, etc.)
  • Implement real-time WebSocket feeds
  • Add telegram/discord notification integrations
  • Improve data parsing and categorization

Support

For issues, questions, or contributions, please create an issue in the repository.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

crypto_exchange_news_crawler-0.1.2.tar.gz (15.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

crypto_exchange_news_crawler-0.1.2-py3-none-any.whl (18.7 kB view details)

Uploaded Python 3

File details

Details for the file crypto_exchange_news_crawler-0.1.2.tar.gz.

File metadata

File hashes

Hashes for crypto_exchange_news_crawler-0.1.2.tar.gz
Algorithm Hash digest
SHA256 5dc5db20677667bc01fbce0ddaaf1f3a5818b12934486802f03907bf511df6e0
MD5 1285b90db7429f2033252e745362592f
BLAKE2b-256 f8d8626aa5aaef43bf3aa41c5488d98c9997ae625a94111ba50f081a753161b7

See more details on using hashes here.

File details

Details for the file crypto_exchange_news_crawler-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for crypto_exchange_news_crawler-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 367f6f0a1823b00cdbbb6bea1b5abf2695cf5738d4c3d3400b003bfed6021134
MD5 3d2e73187ac643c8679ab9c9e269616c
BLAKE2b-256 a150d99e8b1e9b25c054225b0db6dc6a65345e60e26df8d84b56609773b81729

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page