# DexScreener Search Scraper — Bulk DEX Pair Search by Symbol (`logiover/dexscreener-search-pairs-scraper`) Actor Search DexScreener by free-text query (symbol, token name, partial address) and export every matching DEX pair across all chains. Price USD, liquidity, 24h volume, market cap, FDV, transactions. Bulk multi-query with deduplication. No API key. - **URL**: https://apify.com/logiover/dexscreener-search-pairs-scraper.md - **Developed by:** [Logiover](https://apify.com/logiover) (community) - **Categories:** Business, Automation, Developer tools - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## DexScreener Search Scraper — Bulk DEX Pair Search by Symbol, Name or Address ![DexScreener Search Scraper — Bulk DEX Pair Search by Symbol](https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/GjS6nQ8qauOdq9KGy-actor-7uLZpojgYffqYCsKP-FpLzczMraC-unnamed.png) **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:** ```json { "queries": ["SOL", "PEPE", "WIF", "BONK"] } ```` **High-liquidity Ethereum-only:** ```json { "queries": ["PEPE", "SHIB", "FLOKI"], "onlyChains": ["ethereum"], "minLiquidityUsd": 1000000 } ``` **Exact symbol match to filter out impostors:** ```json { "queries": ["PEPE"], "exactSymbol": "PEPE" } ``` **Bulk discovery for memecoin narrative:** ```json { "queries": ["pepe", "wojak", "chad", "doge", "shib", "floki", "bonk"], "minLiquidityUsd": 10000, "maxPairsPerQuery": 10 } ``` *** ### 📤 Output (per matched pair) ```json { "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. # Actor input Schema ## `queries` (type: `array`): List of free-text search queries to run against DexScreener's search index. Each query is matched against token symbols, token names and contract address prefixes. Examples: 'SOL', 'PEPE', 'BONK', 'WIF', 'AI16Z', 'dogwifhat', 'USDC', '0xC02aaA39' (partial address). Queries can combine pair (e.g. 'PEPE/WETH') or chain hints. Each query returns up to 30 pairs, sorted by relevance + liquidity. Provide one query or hundreds — they are deduplicated across queries by pair address. ## `minLiquidityUsd` (type: `integer`): Exclude pairs with USD liquidity below this threshold. Useful to filter out illiquid/abandoned pairs. Set 0 to include all. ## `minVolume24hUsd` (type: `integer`): Exclude pairs with 24-hour USD volume below this threshold. Set 0 to include all. ## `onlyChains` (type: `array`): Whitelist of chain IDs. Only pairs on these chains are saved. Examples: 'solana', 'ethereum', 'base', 'bsc', 'polygon', 'arbitrum', 'avalanche', 'sui', 'ton'. Leave empty for all chains. ## `onlyDexes` (type: `array`): Whitelist of DEX IDs. Examples: 'uniswap', 'raydium', 'pancakeswap', 'meteora', 'orca', 'aerodrome', 'pumpswap', 'quickswap', 'sushiswap', 'curve'. ## `matchSymbol` (type: `string`): Optional post-filter: only keep pairs whose base token symbol contains this substring (case-insensitive). For example, query 'PEPE' returns PEPE, BABYPEPE, PEPECOIN — set matchSymbol='PEPE' to keep all of those, or matchSymbol='BABY' to keep only BABYPEPE. ## `exactSymbol` (type: `string`): Optional post-filter: only keep pairs whose base token symbol exactly equals this value (case-insensitive). Stricter than matchSymbol. Useful to disambiguate tokens that share a partial name. ## `maxPairsPerQuery` (type: `integer`): Cap pairs returned per query (after filtering, sorted by liquidity desc). DexScreener returns max 30 per query natively. Set 0 for no cap. ## `maxConcurrency` (type: `integer`): Parallel search requests. The search endpoint allows ~300 req/min. Recommended 5–15. ## Actor input object example ```json { "queries": [ "SOL", "PEPE", "WIF" ], "minLiquidityUsd": 0, "minVolume24hUsd": 0, "onlyChains": [], "onlyDexes": [], "matchSymbol": "", "exactSymbol": "", "maxPairsPerQuery": 0, "maxConcurrency": 8 } ``` # Actor output Schema ## `query` (type: `string`): Originating search query ## `chainId` (type: `string`): Chain ID ## `dexId` (type: `string`): DEX identifier ## `baseTokenSymbol` (type: `string`): Base token symbol ## `quoteTokenSymbol` (type: `string`): Quote token symbol ## `priceUsd` (type: `string`): Current USD price ## `liquidityUsd` (type: `string`): Pool liquidity USD ## `volumeH24` (type: `string`): 24h USD volume ## `priceChangeH24` (type: `string`): 24h price change % ## `url` (type: `string`): DexScreener page URL ## `scrapedAt` (type: `string`): ISO 8601 scrape timestamp # 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", "PEPE", "WIF" ] }; // Run the Actor and wait for it to finish const run = await client.actor("logiover/dexscreener-search-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", "PEPE", "WIF", ] } # Run the Actor and wait for it to finish run = client.actor("logiover/dexscreener-search-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", "PEPE", "WIF" ] }' | apify call logiover/dexscreener-search-pairs-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=logiover/dexscreener-search-pairs-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "DexScreener Search Scraper — Bulk DEX Pair Search by Symbol", "description": "Search DexScreener by free-text query (symbol, token name, partial address) and export every matching DEX pair across all chains. Price USD, liquidity, 24h volume, market cap, FDV, transactions. Bulk multi-query with deduplication. No API key.", "version": "1.0", "x-build-id": "nMJ0pFoQ1m5Q5G2Vm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~dexscreener-search-pairs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-dexscreener-search-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/logiover~dexscreener-search-pairs-scraper/runs": { "post": { "operationId": "runs-sync-logiover-dexscreener-search-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/logiover~dexscreener-search-pairs-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-dexscreener-search-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": "Search Queries", "type": "array", "description": "List of free-text search queries to run against DexScreener's search index. Each query is matched against token symbols, token names and contract address prefixes. Examples: 'SOL', 'PEPE', 'BONK', 'WIF', 'AI16Z', 'dogwifhat', 'USDC', '0xC02aaA39' (partial address). Queries can combine pair (e.g. 'PEPE/WETH') or chain hints. Each query returns up to 30 pairs, sorted by relevance + liquidity. Provide one query or hundreds — they are deduplicated across queries by pair address.", "default": [], "items": { "type": "string" } }, "minLiquidityUsd": { "title": "Minimum Liquidity (USD)", "minimum": 0, "type": "integer", "description": "Exclude pairs with USD liquidity below this threshold. Useful to filter out illiquid/abandoned pairs. Set 0 to include all.", "default": 0 }, "minVolume24hUsd": { "title": "Minimum 24h Volume (USD)", "minimum": 0, "type": "integer", "description": "Exclude pairs with 24-hour USD volume below this threshold. Set 0 to include all.", "default": 0 }, "onlyChains": { "title": "Only Include These Chains", "type": "array", "description": "Whitelist of chain IDs. Only pairs on these chains are saved. Examples: 'solana', 'ethereum', 'base', 'bsc', 'polygon', 'arbitrum', 'avalanche', 'sui', 'ton'. Leave empty for all chains.", "default": [], "items": { "type": "string" } }, "onlyDexes": { "title": "Only Include These DEXes", "type": "array", "description": "Whitelist of DEX IDs. Examples: 'uniswap', 'raydium', 'pancakeswap', 'meteora', 'orca', 'aerodrome', 'pumpswap', 'quickswap', 'sushiswap', 'curve'.", "default": [], "items": { "type": "string" } }, "matchSymbol": { "title": "Symbol Substring Match", "type": "string", "description": "Optional post-filter: only keep pairs whose base token symbol contains this substring (case-insensitive). For example, query 'PEPE' returns PEPE, BABYPEPE, PEPECOIN — set matchSymbol='PEPE' to keep all of those, or matchSymbol='BABY' to keep only BABYPEPE.", "default": "" }, "exactSymbol": { "title": "Exact Symbol Match", "type": "string", "description": "Optional post-filter: only keep pairs whose base token symbol exactly equals this value (case-insensitive). Stricter than matchSymbol. Useful to disambiguate tokens that share a partial name.", "default": "" }, "maxPairsPerQuery": { "title": "Max Pairs Per Query", "minimum": 0, "type": "integer", "description": "Cap pairs returned per query (after filtering, sorted by liquidity desc). DexScreener returns max 30 per query natively. Set 0 for no cap.", "default": 0 }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 30, "type": "integer", "description": "Parallel search requests. The search endpoint allows ~300 req/min. Recommended 5–15.", "default": 8 } } }, "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 } } } } } } } } } } ```