dexscreener-api Checked

{
  "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 claimed
• fdv/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
    # Sort by liquidity (highest first)
    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 schemas
• references/error_handling.md — Rate limits, error codes, best practices

### Scripts

• scripts/token_lookup.py — Look up any token across all chains with liquidity analysis
• scripts/boost_monitor.py — Monitor newly boosted/promoted tokens