## Dexscreener Token & Pair Data Scraper
**π° $4.20 / 1 000 rows** Β Β·Β pay only for results Β Β·Β no credit card to try
*We do the dirty work so your dataset stays clean.* π
Bulk-resolve on-chain trading-pair data β price, liquidity, volume, FDV, market cap, buy/sell counts β from Dexscreener's public keyless JSON API. Batch-lookup by search query, token address, or exact chain+pair address.
***
### π― What this scrapes
Dexscreener exposes live trading-pair data β price, liquidity, volume, FDV, market cap, and buy/sell transaction counts β through three public JSON endpoints, but each one only answers a single search query, address, or pair at a time. This Actor batches all three: free-text search queries, token contract addresses (chunked internally), and exact chain + pair-address lookups. Every trading pair Dexscreener returns becomes one dataset row β a search can surface many pairs, a token address returns every pair it trades in, and a pair lookup returns at most one. Nothing found for a given query, address, or pair is simply reported as zero rows, never a placeholder or a failed run.
### π₯ What we handle for you
- π **Retries with exponential backoff** on 408 / 429 / 5xx and honours `Retry-After` β up to 5 attempts per call, with rotated browser impersonation on every retry.
- 𧩠**Three batch lookups in one run** β free-text search, token-address (auto-chunked), and exact pair lookups, no manual endpoint-juggling.
- π« **One bad query never fails the run** β a failed or empty lookup is logged and skipped; the rest of your batch still ships.
- π§ **Clean, typed dataset rows** β Pydantic-validated, raw `price_usd` string preserved (no float precision loss), JSON / CSV / Excel export straight from the Apify Console.
- π° **Pay-Per-Event pricing** β you only pay for trading pairs actually returned. Empty search results and no-match lookups are free.
### π‘ Use cases
- Feed a trading bot or alert system with live price, liquidity, and volume for a watchlist of token addresses.
- Screen new or trending memecoins by batch-searching project names and comparing liquidity and FDV across results.
- Track a specific liquidity pool's price and transaction activity over time by pinning its chain and pair address.
- Build an on-chain analytics dashboard that ingests price/volume/market-cap snapshots across many tokens in one run.
### βοΈ How to use it
1. Click **Try for free** at the top of the page.
2. Fill in the input form β most fields have sensible defaults.
3. Click **Start**. Output streams into the run's dataset.
4. Export from **Storage β Dataset** as JSON, CSV, or Excel β or fetch via the API.
### π₯ Input
| Field | Type | Required | Default | Notes |
|---|---|:--:|---|---|
| `search_queries` | `array` | no | \['pepe', 'doge'] | Free-text queries to Dexscreener's /search endpoint (token name, symbol, or pair). Each query returns up to ~30β¦ |
| `token_addresses` | `array` | no | \['0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2', '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'] | On-chain token contract addresses to look up via Dexscreener's /tokens endpoint. Chunked internally (β€30 addresses perβ¦ |
| `pairs` | `array` | no | \[{'chain\_id': 'ethereum', 'pair\_address': '0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640'}, {'chain\_id': 'ethereum', 'pair\_address': '0x0000000000000000000000000000000000dead'}] | Exact { chain\_id, pair\_address } lookups via Dexscreener's /pairs/{chainId}/{pairAddress} endpoint β one API call perβ¦ |
| `proxyConfiguration` | `object` | no | {'useApifyProxy': False} | Dexscreener's public JSON API is keyless with no anti-bot surface observed. Leave this off unless your account requires⦠|
#### Example input
```json
{
"search_queries": [
"pepe",
"doge"
],
"token_addresses": [
"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
],
"pairs": [
{
"chain_id": "ethereum",
"pair_address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640"
},
{
"chain_id": "ethereum",
"pair_address": "0x0000000000000000000000000000000000dead"
}
],
"proxyConfiguration": {
"useApifyProxy": false
}
}
```
### π€ Output
Every row is one dataset item.
| Field | Type | Notes |
|---|---|---|
| `source_type` | `string` | Which input list produced this row (search / token\_address / pair). |
| `source_query` | `string` | Originating search string, token address, or "{chain\_id}/{pair\_address}". |
| `chain_id` | `string` | Dexscreener chain id (e.g. 'ethereum', 'solana'). |
| `pair_address` | `string` | On-chain trading-pair (pool) address. |
| `base_token_address` | `string` | Base token contract address. |
| `base_token_symbol` | `string` | Base token symbol. |
| `quote_token_symbol` | `string` | Quote token symbol. |
| `price_usd` | `string` | Current price in USD, kept as Dexscreener's raw string (no float precision loss). |
| `volume_h24` | `number` | 24-hour trading volume in USD. |
| `liquidity_usd` | `number` | Current pool liquidity in USD. |
| `fdv` | `number` | Fully diluted valuation in USD. |
| `market_cap` | `number` | Market capitalization in USD. |
| `price_change_h24` | `number` | 24-hour price change, percent. |
| `txns_buys_h24` | `integer` | Number of buy transactions in the last 24 hours. |
| `txns_sells_h24` | `integer` | Number of sell transactions in the last 24 hours. |
| `fetched_at` | `string` | ISO-8601 timestamp of this fetch. |
#### Example output
```json
{
"source_type": "search",
"source_query": "pepe",
"chain_id": "solana",
"pair_address": "FCEnSxyJfRSKsz6tASUENCsfGwKgkH6YuRn1AMmyHhZn",
"base_token_address": "B5WTLaRwaUQpKk7ir1wniNB6m5o8GgMrimhKMYan2R6B",
"base_token_symbol": "Pepe",
"quote_token_symbol": "SOL",
"price_usd": "0.001566",
"volume_h24": 2889642.68,
"liquidity_usd": 393803.33,
"fdv": 658000000.0,
"market_cap": 658000000.0,
"price_change_h24": 4.2,
"txns_buys_h24": 5210,
"txns_sells_h24": 4830,
"fetched_at": "2026-09-20T00:00:00Z"
}
```
### π° Pricing
Pay-Per-Event β you pay only when these events fire:
| Event | USD | What it is |
|---|---:|---|
| `actor-start` | $0.2 | One-off warm-up charge per run |
| `result-row` | $0.004 | Per unique dataset item |
Example: 1 000 rows at the rates above β **$4.20**. No subscription, no minimum, no card to start β Apify gives every new account $5 of free credit.
### π§ Limitations
- Search queries return Dexscreener's own top matches (~30 per query) β this is a lookup, not a deep paginated crawl. Use token\_addresses or pairs for depth.
- Only chains and DEXs indexed by Dexscreener itself are covered.
- No historical/candlestick data, no wallet-level or top-trader data β only current pair snapshots.
- Discovering addresses you don't already have is limited to search\_queries' ~30-result cap per query.
### β FAQ
**Do I need an API key or wallet connection?**
No. This Actor uses only Dexscreener's public, keyless JSON API β no auth, no login, no wallet connection.
**What happens if my search query, address, or pair has no matches?**
It comes back as zero rows for that item and is counted in the run's status message β the run still succeeds. No placeholder rows, no failure.
**How many token addresses or pairs can I look up in one run?**
Up to 50 search queries, 300 token addresses (chunked internally, β€30 per API call), and 200 exact pairs per run.
**Does this return historical price charts or OHLCV data?**
No. The endpoints used here return current snapshot data only β price, 24h volume, liquidity, FDV, market cap, and 24h transaction counts. No candlestick or historical data is exposed by these endpoints.
### π¬ Your feedback
Spotted a bug, hit a weird edge case, or need a new field? Open an
issue on the Actor's **Issues** tab on Apify Console β we ship
fixes weekly and we read every report.
***
Built by **[Devil Scrapes](https://apify.com/DevilScrapes)** π β a small fleet of
opinionated public-data Actors. Honest pricing, real engineering, zero fine print.
# Changelog
This Actor's version history is a separate document: https://apify.com/devilscrapes/dexscreener-scraper/changelog.md
# Actor input Schema
## `search_queries` (type: `array`):
Free-text queries to Dexscreener's /search endpoint (token name, symbol, or pair). Each query returns up to ~30 matching trading pairs, one row per pair. Up to 50 queries per run.
## `token_addresses` (type: `array`):
On-chain token contract addresses to look up via Dexscreener's /tokens endpoint. Chunked internally (β€30 addresses per API call). Every pair involving any of these tokens is returned, one row per pair. Up to 300 addresses per run.
## `pairs` (type: `array`):
Exact { chain\_id, pair\_address } lookups via Dexscreener's /pairs/{chainId}/{pairAddress} endpoint β one API call per pair, zero or one row each. Up to 200 pairs per run.
## `proxyConfiguration` (type: `object`):
Dexscreener's public JSON API is keyless with no anti-bot surface observed. Leave this off unless your account requires egress through Apify Proxy.
## Actor input object example
```json
{
"search_queries": [
"pepe",
"doge"
],
"token_addresses": [
"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
],
"pairs": [
{
"chain_id": "ethereum",
"pair_address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640"
},
{
"chain_id": "ethereum",
"pair_address": "0x0000000000000000000000000000000000dead"
}
],
"proxyConfiguration": {
"useApifyProxy": false
}
}
```
# Actor output Schema
## `datasetItems` (type: `string`):
All dataset items as JSON.
## `datasetItemsCsv` (type: `string`):
Same data exported to CSV.
## `datasetView` (type: `string`):
Open the run dataset in the Console.
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '