# DEX Screener Token Pairs Scraper (`fetch_cat/dexscreener-token-pairs-scraper`) Actor Export DEX Screener token pair snapshots for symbols, addresses, chains, prices, liquidity, volume, websites, and socials. - **URL**: https://apify.com/fetch\_cat/dexscreener-token-pairs-scraper.md - **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community) - **Categories:** Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.06 / 1,000 result extracteds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## DEX Screener Token Pairs Scraper DEX Screener Token Pairs Scraper exports DEX Screener crypto token pair data for symbols, addresses, chains, prices, liquidity, volume, websites, and socials. ### What data it exports DEX Screener Token Pairs Scraper exports structured DEX Screener crypto token pair data by token symbol, pair name, token address, or pair address. It turns DEX Screener search results into clean CSV, JSON, Excel, and API-ready token pair datasets for crypto watchlists, market research, token discovery, and liquidity monitoring. Key fields include `query`, `chainId`, `dexId`, `pairUrl`, `pairAddress`, `baseToken`, `quoteToken`, `priceUsd`, `liquidityUsd`, `volume`, and `fetchedAt`. ### Use cases - Crypto analysts comparing liquidity and volume across DEX pairs. - Trading and alerting teams monitoring token watchlists. - Web3 researchers enriching token databases with websites and socials. - Growth and BD teams finding active projects and markets. - Developers building dashboards, bots, and automated market data workflows. ### Example input ```json { "queries": ["SOL/USDC", "WETH"], "chainIds": ["solana", "ethereum"], "maxResultsPerQuery": 10, "includeWebsitesAndSocials": true, "requestDelayMs": 250 } ```` ### Example output ```json { "query": "SOL/USDC", "chainId": "solana", "dexId": "raydium", "pairUrl": "https://dexscreener.com/solana/...", "pairAddress": "...", "baseToken": { "address": "...", "name": "Solana", "symbol": "SOL" }, "quoteToken": { "address": "...", "name": "USD Coin", "symbol": "USDC" }, "priceNative": "1.0", "priceUsd": "150.12", "txns": { "h24": { "buys": 120, "sells": 98 } }, "volume": { "h24": 123456.78 }, "priceChange": { "h24": 2.4 }, "liquidityUsd": 987654.32, "fdv": 1000000000, "marketCap": 1000000000, "pairCreatedAt": "2024-01-01T00:00:00.000Z", "websites": [{ "label": "Website", "url": "https://example.org" }], "socials": [{ "type": "twitter", "url": "https://x.com/example" }], "fetchedAt": "2026-07-10T08:00:00.000Z" } ``` ### Input settings | Field | Type | Required | Description | | --- | --- | --- | --- | | `queries` | array of strings | Yes | Token symbols, names, pairs, token contract addresses, or pair addresses. | | `chainIds` | array of strings | No | Keep selected DEX Screener chains such as `solana`, `ethereum`, `base`, `bsc`, `polygon`, or `arbitrum`. | | `maxResultsPerQuery` | integer | No | Maximum saved token pairs per query. Default 30, maximum 100. | | `includeWebsitesAndSocials` | boolean | No | Include token website and social profile URLs when available. | | `requestDelayMs` | integer | No | Delay between queries for large watchlists. | | `proxyConfiguration` | object | No | Optional proxy settings. The public DEX Screener API usually works without a proxy. | ### Output fields - `query`, `chainId`, `dexId`, `pairUrl`, `pairAddress` - `baseToken`, `quoteToken` - `priceNative`, `priceUsd` - `txns`, `volume`, `priceChange` - `liquidityUsd`, `liquidityBase`, `liquidityQuote` - `fdv`, `marketCap` - `pairCreatedAt`, `pairCreatedAtTimestamp` - `labels`, `websites`, `socials`, `fetchedAt` ### Input recipes Start from a verified public Example task when you want a ready-made configuration: - [Find SOL/USDC token pairs on Solana](https://apify.com/fetch_cat/dexscreener-token-pairs-scraper/examples/sol-usdc-pairs-solana) - [Research WETH token pairs across DEX Screener](https://apify.com/fetch_cat/dexscreener-token-pairs-scraper/examples/weth-pairs-ethereum) - [Compare USDC pairs across blockchain networks](https://apify.com/fetch_cat/dexscreener-token-pairs-scraper/examples/usdc-pairs-cross-chain) - [Monitor AERO token pairs on Base](https://apify.com/fetch_cat/dexscreener-token-pairs-scraper/examples/base-token-pair-watchlist) ### Pricing This actor uses pay-per-event pricing: | Event | Price | | --- | --- | | Start | `$0.005` per run | | Pair result, FREE tier | `$0.000115` per saved pair | | Pair result, BRONZE tier | `$0.0001` per saved pair | | Pair result, SILVER tier | `$0.000078` per saved pair | | Pair result, GOLD tier | `$0.00006` per saved pair | | Pair result, PLATINUM tier | `$0.00004` per saved pair | | Pair result, DIAMOND tier | `$0.000028` per saved pair | ### Tips and limits - Use exact pair names such as `SOL/USDC` when you want tighter results. - Add `chainIds` to reduce noise for multi-chain token symbols. - Increase `requestDelayMs` for large query lists if the API returns rate-limit warnings. - DEX Screener can change or omit fields for some pairs; missing values are returned as `null` or empty arrays. ### API usage #### Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('fetch_cat/dexscreener-token-pairs-scraper').call({ queries: ['SOL/USDC'], chainIds: ['solana'], maxResultsPerQuery: 10 }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_APIFY_TOKEN') run = client.actor('fetch_cat/dexscreener-token-pairs-scraper').call(run_input={ 'queries': ['SOL/USDC'], 'chainIds': ['solana'], 'maxResultsPerQuery': 10, }) items = client.dataset(run['defaultDatasetId']).list_items().items print(items) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~dexscreener-token-pairs-scraper/runs?token=YOUR_APIFY_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"queries":["SOL/USDC"],"chainIds":["solana"],"maxResultsPerQuery":10}' ``` ### MCP and agent usage Use this actor from Apify MCP tools with: ```text https://mcp.apify.com/?tools=fetch_cat/dexscreener-token-pairs-scraper ``` Claude CLI add command: ```bash claude mcp add apify-dexscreener-token-pairs --transport http "https://mcp.apify.com/?tools=fetch_cat/dexscreener-token-pairs-scraper" ``` JSON config block: ```json { "mcpServers": { "apify-dexscreener-token-pairs": { "url": "https://mcp.apify.com/?tools=fetch_cat/dexscreener-token-pairs-scraper" } } } ``` Example prompts showing MCP usage: - "Run DEX Screener Token Pairs Scraper for SOL/USDC and WETH, filter to solana and ethereum, then summarize the highest-liquidity pairs." - "Use the Apify DEX Screener tool to export BONK pairs, then list the top 10 by 24h volume." - "Fetch token pair data for these contract addresses and return pairs with websites or Twitter links." ### Related actors - [Google Search Results Scraper](https://apify.com/fetch_cat/google-search-results-scraper) - [Google Maps Lead Finder](https://apify.com/fetch_cat/google-maps-lead-finder) ### FAQ **Does this need a DEX Screener API key?** No. It uses publicly reachable DEX Screener data. **Can I search contract addresses?** Yes. Add token or pair addresses to `queries`. **Why do I see multiple chains for one token symbol?** DEX Screener search is cross-chain. Use `chainIds` to keep only the chains you need. **Is this financial advice?** No. The actor exports public market data snapshots for research and monitoring. Always verify data before making decisions. ### Support Open an issue from the Apify actor page if you need help. Please include: - Your input JSON. - Expected output. - Actual output or error message. - The run ID or run URL. - A reproducible public URL for the run, if available. # Actor input Schema ## `queries` (type: `array`): Token symbols, names, pair names, token contract addresses, or pair addresses to search on DEX Screener. ## `chainIds` (type: `array`): Optional DEX Screener chain IDs to keep, for example solana, ethereum, base, bsc, polygon, arbitrum. Leave empty to include all chains returned by the search. ## `maxResultsPerQuery` (type: `integer`): Maximum number of token pair records to save for each query after chain filtering and duplicate removal. ## `includeWebsitesAndSocials` (type: `boolean`): When enabled, include token website links and social profile URLs when DEX Screener returns them. ## `requestDelayMs` (type: `integer`): Optional delay between DEX Screener API requests. Increase this for large query lists if you see rate limit warnings. ## `proxyConfiguration` (type: `object`): Optional proxy settings. The public DEX Screener API normally works without a proxy. ## Actor input object example ```json { "queries": [ "SOL/USDC", "WETH" ], "chainIds": [ "solana", "ethereum" ], "maxResultsPerQuery": 10, "includeWebsitesAndSocials": true, "requestDelayMs": 250, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "queries": [ "SOL/USDC", "WETH" ], "chainIds": [ "solana", "ethereum" ], "maxResultsPerQuery": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("fetch_cat/dexscreener-token-pairs-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "queries": [ "SOL/USDC", "WETH", ], "chainIds": [ "solana", "ethereum", ], "maxResultsPerQuery": 10, } # Run the Actor and wait for it to finish run = client.actor("fetch_cat/dexscreener-token-pairs-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "queries": [ "SOL/USDC", "WETH" ], "chainIds": [ "solana", "ethereum" ], "maxResultsPerQuery": 10 }' | apify call fetch_cat/dexscreener-token-pairs-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetch_cat/dexscreener-token-pairs-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "DEX Screener Token Pairs Scraper", "description": "Export DEX Screener token pair snapshots for symbols, addresses, chains, prices, liquidity, volume, websites, and socials.", "version": "0.1", "x-build-id": "wZB9JbRHBAtFT7q55" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~dexscreener-token-pairs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-dexscreener-token-pairs-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/fetch_cat~dexscreener-token-pairs-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-dexscreener-token-pairs-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/fetch_cat~dexscreener-token-pairs-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-dexscreener-token-pairs-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "queries" ], "properties": { "queries": { "title": "Token queries", "minItems": 1, "type": "array", "description": "Token symbols, names, pair names, token contract addresses, or pair addresses to search on DEX Screener.", "items": { "type": "string" } }, "chainIds": { "title": "Filter by chain IDs", "type": "array", "description": "Optional DEX Screener chain IDs to keep, for example solana, ethereum, base, bsc, polygon, arbitrum. Leave empty to include all chains returned by the search.", "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Maximum pairs per query", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of token pair records to save for each query after chain filtering and duplicate removal.", "default": 30 }, "includeWebsitesAndSocials": { "title": "Include websites and socials", "type": "boolean", "description": "When enabled, include token website links and social profile URLs when DEX Screener returns them.", "default": true }, "requestDelayMs": { "title": "Delay between queries (milliseconds)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Optional delay between DEX Screener API requests. Increase this for large query lists if you see rate limit warnings.", "default": 250 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy settings. The public DEX Screener API normally works without a proxy.", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```