👻 Dexscraper

Real-time DexScreener market data in one CLI/SDK.

[!IMPORTANT] This project is independent and not affiliated with DexScreener.
Use at your own risk for research purposes only and comply with DexScreener terms.

[!WARNING] The unofficial DexScreener screener WebSocket endpoints under wss://io.dexscreener.com/dex/screener/... now return 404 and are treated as dead. Prefer the official DexScreener API (https://api.dexscreener.com/...) for supported market data access. Streaming via this package's historical io.dexscreener.com WebSocket path is not currently available.

Install Dexscraper

# pip install
pip install dexscraper

# or uv install
uv pip install dexscraper

# add the Rich terminal UI used by --format rich
pip install "dexscraper[rich]"

# download and install from main branch
git clone https://github.com/vincentkoc/dexscraper.git
cd dexscraper
pip install -e .[dev]

# Recommended when using --cloudflare-bypass in interactive or --once modes
pip install "cloudscraper @ git+https://github.com/VeNoMouS/[email protected]"

Why Dexscraper?

DexScreener data is useful, but scraping it consistently is painful: protocol changes, Cloudflare behavior, reconnect logic, and export formatting. Dexscraper gives you one stable interface for real-time extraction, filtering, and export, both from CLI and Python code.

What You Get

• Real-time streaming of webSocket extraction
• Multi-chain and multi-DEX filtering
• Trending/top/gainers/new presets
• Structured token profiles and OHLC/OHLCVT output for tools like Metatrader
• Optional Cloudflare bypass flow (with runtime v3 feature detection)
• Typed Python SDK + CLI

Commands

dexscraper                                                                    # streaming json
dexscraper interactive                                                        # gui mode
dexscraper trending --chain solana --limit 10 --once                          # trending
dexscraper top --chain ethereum --min-liquidity 50000 --once                  # top
dexscraper trending --chain solana --format json --output pairs.json --once   # trending to file
dexscraper --mode trending --chain solana --format rich                       # gui mode

Options

Run dexscraper --help for the full list. Grouped summary:

Chains: solana, ethereum, base, bsc, polygon, arbitrum, optimism, avalanche. DEXs: raydium, pumpfun, pumpswap, orca, jupiter, meteora, uniswap, uniswapv3, sushiswap, pancakeswap, aerodrome, baseswap.

Python SDK

import asyncio
from dexscraper import DexScraper, ScrapingConfig, Filters, Chain, RankBy, Timeframe

config = ScrapingConfig(
    timeframe=Timeframe.H1,
    rank_by=RankBy.VOLUME,
    filters=Filters(chain_ids=[Chain.SOLANA], liquidity_min=50_000),
)

async def main():
    scraper = DexScraper(config=config, use_cloudflare_bypass=True)
    batch = await scraper.extract_token_data()
    for token in batch.get_top_tokens(10):
        if token.price is not None:
            print(token.get_display_name(), token.price)

asyncio.run(main())

Contributing

Contributions are welcome. See CONTRIBUTING.md.

Open an issue for bugs, start a discussion for questions, and star the repo if it helps.

Made with 💙 by Vincent Koc · GPL-3.0