extracted from a production trading system. handles rate limits gracefully.

🛡️ Why this library?

dexscreener's api is free and powerful, but:

• 429s kill your app if you don't handle them
• no python client exists that handles rate limits properly
• concurrent requests for the same token waste your quota

this library solves all three:

from dexscreener import DexScreenerClient

async with DexScreenerClient() as client:
    # get all trading pairs for a token
    pairs = await client.get_token_pairs("solana", "So11111111111111111111111111111111111111112")

    for pair in pairs:
        print(f"{pair.base_token_symbol}: ${pair.price_usd} | liq: ${pair.liquidity_usd}")

429s → automatic exponential backoff (3s → 6s → 12s). duplicate requests → deduplicated into one HTTP call. results → cached with configurable TTL.

📦 Install

pip install dexscreener-python

requires python 3.11+

⚡ Features

🔧 Usage

💰 Token Pairs

pairs = await client.get_token_pairs("solana", token_address)

best_pair = pairs[0]  # sorted by liquidity (highest first)
print(f"Price: ${best_pair.price_usd}")
print(f"Liquidity: ${best_pair.liquidity_usd}")
print(f"24h Volume: ${best_pair.volume_24h}")
print(f"Buy/Sell 5m: {best_pair.buy_sell_ratio_5m:.2f}")
print(f"Age: {best_pair.pair_age_seconds // 3600}h")

💵 Token Price

price = await client.get_token_price("solana", token_address)
print(f"${price}")

📦 Batch Fetch (up to 30 tokens)

data = await client.get_tokens_batch("solana", [addr1, addr2, addr3])
for addr, pair in data.items():
    print(f"{pair.base_token_symbol}: ${pair.price_usd}")

🔍 Search

results = await client.search_pairs("BONK")
for pair in results:
    print(f"{pair.base_token_symbol} on {pair.dex_id}: ${pair.price_usd}")

🚀 Boosted Tokens

boosted = await client.get_boosted_tokens("solana")
# boosted tokens are paid promotions — treat with caution

🎯 Specific Pair

pair = await client.get_pair_by_address("solana", pair_address)
print(f"{pair.dex_id}: ${pair.price_usd}")

📋 DexPairData

all methods return DexPairData objects with these fields:

computed properties:

⚙️ Configuration

client = DexScreenerClient(
    rate_limit=5.0,      # requests/second (default: 5.0, dexscreener limit is ~300/min)
    cache_ttl=8.0,       # default cache TTL in seconds
)

🆚 Comparison

License

MIT

📦 Also by JinUltimate1995

• jupiter-swap-python — Jupiter swap client for Python. Async. Typed.
• pumpfun-python — PumpFun bonding curve + PumpSwap AMM. Direct swaps from Python.
• solana-rpc-resilient — Fault-tolerant Solana RPC with automatic failover.