DexScreener Search Scraper — Bulk DEX Pair Search by Symbol, Name or Address

Search DexScreener by free-text query — symbol (SOL, PEPE, WIF), full token name (dogwifhat), partial contract address (0xC02aaA39) or pair syntax (PEPE/WETH) — and export every matching DEX trading pair across every chain DexScreener indexes. Price USD, liquidity USD, 24-hour / 6-hour / 1-hour / 5-minute volume, FDV, market cap, transaction counts and price changes for each match. Bulk multi-query mode with automatic deduplication across queries.

Built for bulk symbol-to-contract resolution, memecoin discovery, market screening, watchlist enrichment, indexer pipelines, token research workflows and content/data products that need DexScreener's search index at scale.

🟢 No API key. No proxy. No login. Pure public REST API.

---

🚀 Why this scraper

DexScreener's search endpoint is the fastest way to translate human-friendly inputs (symbols, project names, partial addresses) into machine-friendly contract addresses and full pair data. But running 200 queries by hand to enrich a watchlist or 1000 queries to seed an indexer is impractical. This scraper handles:

• Bulk query execution with concurrency
• Automatic deduplication across queries (same pair won't appear twice)
• Filtering noise (low-liquidity, dead pools)
• Re-sorting per-query results by liquidity (DexScreener returns relevance-sorted; this scraper re-sorts so the most-liquid match surfaces first)
• Rate-limit-safe throttling and HTTP 429 backoff
• Flat row output ready for spreadsheets, BI tools, databases

---

✨ Key features

Feature	What it gives you
🔍 Bulk query mode	Run 1 query or 1000 queries in one run
🌐 Multi-chain & multi-DEX	Search index spans all 30+ chains and 100+ DEXes
✂️ Smart deduplication	If "SOL" and "Solana" both match the same pair, it's saved once
🎯 Rich filtering	Min liquidity, min volume, chain whitelist, DEX whitelist
🔬 Symbol post-filters	matchSymbol (substring) and exactSymbol (exact) for precise targeting
📊 Liquidity-sorted results	DexScreener returns relevance order; this scraper re-sorts by USD liquidity desc
🗃️ Flat ready-to-use rows	30+ columns, no nested JSON to wrangle
💾 JSON, CSV, Excel exports	Direct from Apify Dataset
🔓 Public API only	No auth, no proxy, no scraping

---

🎯 Built for these use cases

1. Bulk symbol → contract address resolution

You have a list of 200 ticker symbols (from a Google Sheet, CoinGecko export, news headlines, Twitter mentions). You need their actual contract addresses and DEX listings to actually do something with them. One run does the job.

2. Watchlist enrichment

Convert "I want to track PEPE, BONK, WIF, FLOKI" into "here's their contract address, top pair, price, liquidity and volume right now."

3. DEX market screening

Find every PEPE-named token across every chain. Discover impostors, forks, multi-chain bridges. Sort by liquidity to find which version is dominant.

4. Memecoin & narrative discovery

Search for trending narrative keywords (AI16Z, WIF, dogwifhat, Trump, cat, dog, pepe) and surface every related token across DEXes. Pair with our boosted-tokens scraper for paid promotion intel.

5. Content & newsletter data

Daily "top movers in X narrative" reports. Pull all pepe-family tokens, sort by 24-hour volume, write up the top 10. Repeat for any narrative.

6. Indexer & data product pipelines

Seed your token database by sweeping queries like 0x, pump, sol, eth to surface live pairs. Feed normalized output into your own crypto data API.

7. Token research workflows

For each project under research, run a search to discover ALL DEX listings (not just the one mentioned on their official website). Often reveals hidden listings or stale ones.

8. Anti-impersonator monitoring

Search your project's name regularly to catch scam tokens using the same symbol on other chains.

---

📥 Inputs

Field	Type	Required	Description
queries	string[]	✅ Yes	Free-text search terms. Symbols (SOL), full names (dogwifhat), partial contract addresses (0xC02aaA39), pair syntax (PEPE/WETH). Each query returns up to 30 matching pairs.
minLiquidityUsd	int	No	Skip pairs below this USD liquidity.
minVolume24hUsd	int	No	Skip pairs below this 24h USD volume.
onlyChains	string[]	No	Whitelist chains: solana, ethereum, base, bsc, polygon, arbitrum, avalanche, sui, ton, etc.
onlyDexes	string[]	No	Whitelist DEXes: uniswap, raydium, pancakeswap, meteora, aerodrome, orca, pumpswap, quickswap, etc.
matchSymbol	string	No	Post-filter: keep only pairs whose base symbol contains this substring (case-insensitive).
exactSymbol	string	No	Post-filter: keep only pairs whose base symbol exactly equals this value.
maxPairsPerQuery	int	No	Cap pairs per query (sorted by liquidity desc). Native max from API is 30.
maxConcurrency	int	No	Parallel queries (1–30). Default 8.

Example inputs

Simple symbol search:

{
  "queries": ["SOL", "PEPE", "WIF", "BONK"]
}

High-liquidity Ethereum-only:

{
  "queries": ["PEPE", "SHIB", "FLOKI"],
  "onlyChains": ["ethereum"],
  "minLiquidityUsd": 1000000
}

Exact symbol match to filter out impostors:

{
  "queries": ["PEPE"],
  "exactSymbol": "PEPE"
}

Bulk discovery for memecoin narrative:

{
  "queries": ["pepe", "wojak", "chad", "doge", "shib", "floki", "bonk"],
  "minLiquidityUsd": 10000,
  "maxPairsPerQuery": 10
}

---

📤 Output (per matched pair)

{
  "query": "PEPE",
  "chainId": "ethereum",
  "dexId": "uniswap",
  "pairAddress": "0x11950d141ecb863f01007add7d1a342041227b58",
  "url": "https://dexscreener.com/ethereum/0x1195...",
  "baseTokenAddress": "0x6982508145454Ce325dDbE47a25d4ec3d2311933",
  "baseTokenName": "Pepe",
  "baseTokenSymbol": "PEPE",
  "quoteTokenAddress": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
  "quoteTokenName": "Wrapped Ether",
  "quoteTokenSymbol": "WETH",
  "priceUsd": 0.00001234,
  "priceNative": 0.000000004,
  "liquidityUsd": 12450000,
  "fdv": 5200000000,
  "marketCap": 5200000000,
  "volumeH24": 45000000,
  "volumeH6": 9800000,
  "volumeH1": 1200000,
  "volumeM5": 65000,
  "priceChangeH24": -3.2,
  "priceChangeH6": 0.8,
  "priceChangeH1": -0.2,
  "priceChangeM5": 0.0,
  "txnsH24Buys": 8421,
  "txnsH24Sells": 9105,
  "pairCreatedAt": "2023-04-14T00:00:00.000Z",
  "imageUrl": "https://cdn.dexscreener.com/...",
  "websites": [{"label": "Website", "url": "https://pepe.vip/"}],
  "socials":  [{"type": "twitter", "url": "https://twitter.com/pepecoineth"}],
  "labels":   ["v2"],
  "scrapedAt": "2026-05-16T08:42:00.000Z"
}

---

⚙️ How it works

1. Reads queries + optional filters
2. Issues one HTTP GET per query to api.dexscreener.com/latest/dex/search?q={query}
3. Receives up to 30 pairs per query from DexScreener's search index
4. Applies filters: chain whitelist, DEX whitelist, min liquidity, min volume, symbol substring, exact symbol
5. Re-sorts each query's results by USD liquidity descending (so the most-liquid match comes first)
6. Caps at maxPairsPerQuery if set
7. Deduplicates across queries by chainId:pairAddress — the same pair matched by two different queries is saved once
8. Streams flat rows directly into the Apify Dataset

Public API only — no auth, no proxy, no scraping. Built-in HTTP 429 backoff.

---

⚡ Performance

Workload	Time	API calls
10 queries, concurrency 8	~2 seconds	10
100 queries	~15 seconds	100
500 queries	~70 seconds	500
1000 queries	~2.5 minutes	1000

DexScreener's search endpoint allows ~300 requests/minute. The scraper stays within budget with concurrency 8.

---

💰 Cost model

This actor uses Pay-Per-Result pricing — you pay only for actual matched pair rows saved (after dedup + filters). A query that returns no matches costs nothing.

---

🔄 Schedule for continuous monitoring

• Hourly — refresh symbol watchlist with current prices/liquidity
• Daily — discover newly listed pairs matching narrative keywords
• Weekly — anti-impersonator sweep for your project's symbol

---

🛠️ FAQ

What can I search for? Anything you can type into DexScreener's search bar:

• Token symbols: SOL, PEPE, WIF, BONK, AI16Z
• Token names: dogwifhat, Solana, Bitcoin
• Partial contract addresses: 0xC02aaA39, So111
• Pair syntax: PEPE/WETH, SOL/USDC
• Project tickers: JUP, JTO, ORCA

How many results per query? Up to 30 (DexScreener's hard limit on the search endpoint). For exhaustive token-level discovery, use the token-pairs scraper with an exact contract address.

Are results sorted by relevance or liquidity? DexScreener returns relevance-sorted (using their internal ranking signal). This scraper re-sorts each query's results by USD liquidity descending. Combine with maxPairsPerQuery=N to keep only the top-N most-liquid matches per query.

Why is the search returning impostor tokens? DexScreener's search matches across all tokens that contain your query string. A query for PEPE will return PEPE, BABYPEPE, PEPECOIN, etc. To filter out impostors, use:

• exactSymbol: keeps only pairs whose base symbol EXACTLY matches (case-insensitive)
• minLiquidityUsd: impostor tokens usually have low liquidity
• onlyChains: limit to the chain where the canonical token lives

How is dedup applied? By chainId:pairAddress. If queries "SOL" and "Solana" both match the same Solana/USDC pair on Raydium, it's saved once with query: "SOL" (whichever query encountered it first).

Does this respect DexScreener's rate limits? Yes — concurrency cap (default 8) and exponential backoff on HTTP 429.

How is this different from the token-pairs scraper?

• Search = free-text, you don't know exact addresses, fast discovery, up to 30 results per query
• Token-pairs = exact contract address, comprehensive enumeration, returns ALL pairs

Use search to discover. Use token-pairs to enumerate.

How is this different from the pair-watchlist scraper?

• Pair-watchlist = specific LP/pool address → 1 row
• Search = symbolic query → up to 30 matching pairs

Does it work for new tokens just launched? Yes, as soon as DexScreener indexes the pair (usually within minutes of pool creation), the search endpoint returns it.

Can I export to CSV / Excel? Yes — Apify Dataset supports JSON, CSV, Excel, HTML and JSONL.

---

📚 Related scrapers in the DexScreener suite

Scraper	Purpose
dexscreener-token-pairs-scraper	Token address → ALL pair listings (multi-chain).
dexscreener-search-pairs-scraper	You are here. Free-text query → matching pairs.
dexscreener-pair-watchlist-scraper	Pair address → current data for that specific listing.
dexscreener-boosted-tokens-scraper	Currently boosted/promoted tokens + marketing spend.
dexscreener-pair-security-scraper	Deep security audit, holders, locks, CG/CMC metadata.

---

🔑 Keyword cloud

Core: dexscreener search api, dex symbol resolver, bulk crypto search, dex token finder, symbol to contract address, memecoin scanner, dex listings discovery, crypto symbol search.

Per chain: solana symbol lookup, solana memecoin discovery, raydium symbol search, ethereum token finder, eth pair search, uniswap symbol search, base chain token search, bsc symbol search, pancakeswap finder.

Per use case: crypto watchlist enrichment, token discovery api, memecoin alpha tool, defi market screener, anti impersonator monitoring, crypto research tool, defi indexer, on-chain token search, narrative tracking.

Per audience: symbol resolver for traders, search api for analysts, dex search for developers, crypto data discovery, web3 token lookup.