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
scrapy 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.1.tar.gz (12.5 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.1-py3-none-any.whl (15.1 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for crypto_exchange_news_crawler-0.1.1.tar.gz
Algorithm Hash digest
SHA256 4b6139ede0d85e0ec08f7372aaa7e445be298ac9b38c109ad0ef14ca73f7562b
MD5 64b4cd3971f1f284cd08786da2d90068
BLAKE2b-256 3d85c9541305a6eaff42184af098426f146dfe483c7c34080d6157e530a0478e

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for crypto_exchange_news_crawler-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 586bd3a1f4b91c8424ae5b4ddbecb0b6217da485ea1d505dab29eb477a78176f
MD5 22a86242936f73570f0264cbc9339d4b
BLAKE2b-256 d88d2aee83b664523f44db0dbf27be42fe8547784f212da0b1eb17f3c7c92d1d

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