| name | dexscreener-api |
| description | Free, no-auth multi-chain DEX pair data — prices, volume, liquidity, transactions, and token profiles |
DexScreener API — Free Multi-Chain DEX Data
DexScreener provides DEX pair data across 80+ chains with no API key required. Prices, volume, liquidity, transaction counts, and token profiles — all free. Best for quick lookups, cross-chain comparison, and lightweight monitoring.
Quick Start
No authentication needed. Just make requests:
import httpx
resp = httpx.get("https://api.dexscreener.com/latest/dex/search", params={"q": "BONK"})
pairs = resp.json()["pairs"]
for p in pairs[:3]:
print(f"{p['baseToken']['symbol']}/{p['quoteToken']['symbol']} on {p['chainId']}: ${p['priceUsd']}")
curl "https://api.dexscreener.com/latest/dex/search?q=BONK"
Base URL
https://api.dexscreener.com
No API key, no headers required. Rate limits: ~300 req/min for DEX data endpoints, 60 req/min for profile/boost endpoints.
Core Endpoints
Search Pairs
GET /latest/dex/search?q=BONK
GET /latest/dex/search?q=So11111111111111111111111111111111111111112
Get Pairs by Chain + Pair Address
GET /latest/dex/pairs/solana/PAIR_ADDRESS
GET /latest/dex/pairs/solana/PAIR1,PAIR2,PAIR3
Get Pairs by Token Address
GET /latest/dex/tokens/TOKEN_MINT_ADDRESS
GET /token-pairs/v1/solana/TOKEN_MINT
GET /tokens/v1/solana/TOKEN1,TOKEN2,TOKEN3
Token Profiles & Boosts
GET /token-profiles/latest/v1
GET /token-boosts/latest/v1
GET /token-boosts/top/v1
GET /orders/v1/solana/TOKEN_ADDRESS
GET /community-takeovers/latest/v1
Pair Response Schema
{
"chainId": "solana",
"dexId": "raydium",
"url": "https://dexscreener.com/solana/PAIR_ADDR",
"pairAddress": "3nMFwZX...",
"labels": ["CLMM"],
"baseToken": { "address": "So11...", "name": "Wrapped SOL", "symbol": "SOL" },
"quoteToken": { "address": "EPjF...", "name": "USD Coin", "symbol": "USDC" },
"priceNative": "86.08",
"priceUsd": "86.08",
"txns": {
"m5": { "buys": 25, "sells": 18 },
"h1": { "buys": 916, "sells": 1282 },
"h6": { "buys": 11309, "sells": 12661 },
"h24": { "buys": 27974, "sells": 31475 }
},
"volume": { "m5": 41680, "h1": 6773038, "h6": 71628073, "h24": 167164493 },
"priceChange": { "m5": -0.01, "h1": -0.36, "h6": 0.82, "h24": 0.25 },
"liquidity": { "usd": 28168478, "base": 232348, "quote": 8167805 },
"fdv": 8171740,
"marketCap": 8171740,
"pairCreatedAt": 1688106058000,
"info": {
"imageUrl": "https://cdn.dexscreener.com/...",
"websites": [{ "url": "https://...", "label": "Website" }],
"socials": [{ "url": "https://x.com/...", "type": "twitter" }]
}
}
Key notes:
priceNative and priceUsd are strings (preserves precision)pairCreatedAt is milliseconds (divide by 1000 for unix timestamp)labels: "CLMM" (concentrated), "DLMM" (dynamic), "wp" (whirlpool)info is optional — only present if the token profile has been claimedfdv/marketCap may be absent for tokens without supply data
Common Patterns
Quick Token Lookup
def lookup_token(address: str) -> dict | None:
"""Get the best pair for a token by liquidity."""
resp = httpx.get(f"https://api.dexscreener.com/latest/dex/tokens/{address}")
pairs = resp.json().get("pairs", [])
if not pairs:
return None
pairs.sort(key=lambda p: p.get("liquidity", {}).get("usd", 0), reverse=True)
return pairs[0]
Cross-Chain Price Check
def find_best_price(symbol: str) -> list[dict]:
"""Find a token across all chains and compare prices."""
resp = httpx.get("https://api.dexscreener.com/latest/dex/search", params={"q": symbol})
pairs = resp.json().get("pairs", [])
results = []
for p in pairs:
if p["baseToken"]["symbol"].upper() == symbol.upper():
results.append({
"chain": p["chainId"],
"dex": p["dexId"],
"price": float(p.get("priceUsd", 0)),
"liquidity": p.get("liquidity", {}).get("usd", 0),
"volume_24h": p.get("volume", {}).get("h24", 0),
})
return sorted(results, key=lambda x: x["liquidity"], reverse=True)
Monitor New Tokens via Boosts
def get_newly_boosted() -> list[dict]:
"""Get tokens that were recently boosted (paid promotion)."""
resp = httpx.get("https://api.dexscreener.com/token-boosts/latest/v1")
return [
{
"chain": t["chainId"],
"address": t["tokenAddress"],
"boost_amount": t.get("amount", 0),
"total_boost": t.get("totalAmount", 0),
"description": t.get("description", ""),
}
for t in resp.json()
]
Buy/Sell Ratio Analysis
def analyze_pressure(pair: dict) -> dict:
"""Analyze buy/sell pressure from transaction counts."""
txns = pair.get("txns", {})
result = {}
for tf in ["m5", "h1", "h6", "h24"]:
data = txns.get(tf, {})
buys = data.get("buys", 0)
sells = data.get("sells", 0)
total = buys + sells
result[tf] = {
"buys": buys, "sells": sells, "total": total,
"buy_ratio": buys / total if total > 0 else 0.5,
}
return result
Supported Chains
Major chains: solana, ethereum, base, arbitrum, bsc, polygon, avalanche, optimism, zksync, scroll, linea, tron, near, aptos, ton, sui, hyperliquid
80+ chains total. The chainId matches the URL path on dexscreener.com.
Limitations
- No OHLCV/candle data — Use Birdeye or SolanaTracker for historical candles
- No pagination — Search returns ~30 results max
- No wallet/trader data — Use Birdeye or Helius for wallet analysis
- No token security data — Use Birdeye
token_security endpoint
- Snapshot data only — Current state, not historical time series
- No WebSocket — Polling only
When to Use DexScreener vs Alternatives
| Need | Use |
|---|
| Quick free token lookup | DexScreener |
| Cross-chain comparison | DexScreener |
| Historical OHLCV for backtesting | Birdeye or SolanaTracker |
| Wallet/trader analysis | Helius or SolanaTracker |
| Real-time streaming | Yellowstone gRPC or Birdeye WebSocket |
| Token security check | Birdeye or SolanaTracker risk score |
Files
References
references/endpoints.md — Complete endpoint listing with response schemasreferences/error_handling.md — Rate limits, error codes, best practices
Scripts
scripts/token_lookup.py — Look up any token across all chains with liquidity analysisscripts/boost_monitor.py — Monitor newly boosted/promoted tokens
