{ "openapi": "3.0.1", "info": { "title": "DexScreener Token Pair & Boosted Token Scraper", "description": "Look up decentralized exchange trading pairs by token or pair address, search tokens by name or symbol, or pull the latest boosted tokens and token profiles across 20 blockchains. Returns price, liquidity, volume, and transaction counts.", "version": "1.0", "x-build-id": "yo7tmA6LqmLYqmoGa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dataspryva~dexscreener-token-pair-and-boosted-token-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dataspryva-dexscreener-token-pair-and-boosted-token-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/dataspryva~dexscreener-token-pair-and-boosted-token-scraper/runs": { "post": { "operationId": "runs-sync-dataspryva-dexscreener-token-pair-and-boosted-token-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/dataspryva~dexscreener-token-pair-and-boosted-token-scraper/run-sync": { "post": { "operationId": "run-sync-dataspryva-dexscreener-token-pair-and-boosted-token-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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byToken", "byPair", "discovery", "metas", "metaPairs", "orders", "byTokenAddress", "byPairAddress", "trending", "byProfile" ], "type": "string", "description": "What to collect. Each mode uses its own fields below.", "default": "search" }, "queries": { "title": "Search queries", "type": "array", "description": "Token names, symbols, pair text such as SOL/USDC, token addresses, or DexScreener URLs. Multiple queries fan out. (mode=search)", "items": { "type": "string" } }, "tokenAddresses": { "title": "Token addresses", "type": "string", "description": "One or more token contract addresses or DexScreener token URLs, separated by commas or new lines. (mode=byToken, orders)" }, "pairAddresses": { "title": "Pair addresses or URLs", "type": "array", "description": "Pair URLs, chain:pairAddress, or bare pair addresses. Bare addresses need a specific chain. (mode=byPair)", "items": { "type": "string" } }, "chainId": { "title": "Chain", "enum": [ "all", "abstract", "algorand", "aptos", "arbitrum", "arc", "avalanche", "base", "beam", "berachain", "blast", "bsc", "celo", "conflux", "cronos", "ethereum", "fantom", "fuse", "flare", "flowevm", "harmony", "heco", "hedera", "hyperevm", "hyperliquid", "ink", "injective", "kava", "klaytn", "linea", "manta", "mantle", "metis", "monad", "moonbeam", "moonriver", "gnosis", "movement", "multiversx", "near", "okex", "optimism", "cro", "plasma", "polygon", "pulsechain", "robinhood", "scroll", "seiv2", "solana", "soneium", "sonic", "stacks", "starknet", "sui", "telos", "ton", "tron", "unichain", "worldchain", "xrpl", "zksync" ], "type": "string", "description": "Blockchain to read. Required for byToken when not 'all', for bare pair addresses, and for orders. Also filters search and promotion feeds locally.", "default": "all" }, "customChainId": { "title": "Custom chain id", "type": "string", "description": "Optional override for a chain added after this release, e.g. 'newchain'. When set it replaces Chain." }, "feed": { "title": "Promotion feed", "enum": [ "boostedTop", "boostedLatest", "profilesLatest", "profilesUpdated", "takeovers", "ads" ], "type": "string", "description": "Which live promotion feed to read. (mode=discovery)", "default": "boostedTop" }, "metaSlugs": { "title": "Narrative slugs", "type": "array", "description": "Narrative slugs such as ai, dog, cat, or x402. Run mode=metas to discover live slugs. (mode=metaPairs)", "items": { "type": "string" } }, "allPools": { "title": "All pools per token", "type": "boolean", "description": "When on, byToken returns every pool of each token on the chain. When off, it returns the best pair per token.", "default": false }, "minLiquidityUsd": { "title": "Min liquidity (USD)", "minimum": 0, "maximum": 1000000000000, "type": "number", "description": "Skip pairs with liquidity below this USD value." }, "maxLiquidityUsd": { "title": "Max liquidity (USD)", "minimum": 0, "maximum": 1000000000000, "type": "number", "description": "Skip pairs with liquidity above this USD value." }, "minVolume24hUsd": { "title": "Min 24h volume (USD)", "minimum": 0, "maximum": 1000000000000, "type": "number", "description": "Skip pairs with 24-hour volume below this USD value." }, "maxVolume24hUsd": { "title": "Max 24h volume (USD)", "minimum": 0, "maximum": 1000000000000, "type": "number", "description": "Skip pairs with 24-hour volume above this USD value." }, "minMarketCapUsd": { "title": "Min market cap (USD)", "minimum": 0, "maximum": 1000000000000000, "type": "number", "description": "Skip pairs below this market cap. Uses FDV when market cap is missing." }, "maxMarketCapUsd": { "title": "Max market cap (USD)", "minimum": 0, "maximum": 1000000000000000, "type": "number", "description": "Skip pairs above this market cap. Uses FDV when market cap is missing." }, "minFdvUsd": { "title": "Min FDV (USD)", "minimum": 0, "maximum": 1000000000000000, "type": "number", "description": "Skip pairs with a fully diluted valuation below this USD value." }, "maxFdvUsd": { "title": "Max FDV (USD)", "minimum": 0, "maximum": 1000000000000000, "type": "number", "description": "Skip pairs with a fully diluted valuation above this USD value." }, "minTxns24h": { "title": "Min 24h transactions", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Skip pairs with fewer buys plus sells in the last 24 hours." }, "maxTxns24h": { "title": "Max 24h transactions", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Skip pairs with more buys plus sells in the last 24 hours." }, "minPriceChange24h": { "title": "Min 24h change (%)", "minimum": -100, "maximum": 100000, "type": "number", "description": "Skip pairs whose 24-hour price change is below this percent. Negative values allowed." }, "maxPriceChange24h": { "title": "Max 24h change (%)", "minimum": -100, "maximum": 100000, "type": "number", "description": "Skip pairs whose 24-hour price change is above this percent. Negative values allowed." }, "minAgeHours": { "title": "Min pair age (hours)", "minimum": 0, "maximum": 1000000, "type": "number", "description": "Skip pairs younger than this many hours." }, "maxAgeHours": { "title": "Max pair age (hours)", "minimum": 0, "maximum": 1000000, "type": "number", "description": "Skip pairs older than this many hours. Use 24 to keep pairs launched today." }, "dexIds": { "title": "DEX filter", "type": "array", "description": "Keep only these DEX protocols, e.g. uniswap, raydium, aerodrome. Empty means all.", "items": { "type": "string" } }, "quoteSymbols": { "title": "Quote symbols", "type": "array", "description": "Keep only pairs quoted in these assets, e.g. USDC, SOL, WETH. Empty means all.", "items": { "type": "string" } }, "sortBy": { "title": "Sort by", "enum": [ "none", "liquidity", "volume24h", "volume1h", "volume6h", "marketCap", "fdv", "priceChange5m", "priceChange1h", "priceChange6h", "priceChange24h", "txns24h", "buys24h", "sells24h", "buySellRatio24h", "pairAge", "boosts" ], "type": "string", "description": "Sort results within each query, token, or feed. Missing values are always last.", "default": "none" }, "sortOrder": { "title": "Sort order", "enum": [ "desc", "asc" ], "type": "string", "description": "Largest/oldest first or smallest/newest first. Pair age ascending means newest first.", "default": "desc" }, "onePairPerToken": { "title": "One pair per token", "type": "boolean", "description": "Keep only the most liquid pair for each token.", "default": false }, "includeInfo": { "title": "Include token info", "type": "boolean", "description": "Add logo, header image, website and social links when DexScreener has them.", "default": true }, "includeMarketData": { "title": "Include market data", "type": "boolean", "description": "For promotion feeds, attach price, liquidity, volume, market cap and age of each token's best pair.", "default": true }, "expandChainSearch": { "title": "Widen search by chain", "type": "boolean", "description": "When a chain is selected, also search quote variants and pull the token pools to get past the 30-pair search cap.", "default": true }, "chainSearchTokens": { "title": "Tokens to widen", "minimum": 0, "maximum": 30, "type": "integer", "description": "How many matching tokens get their pools fetched when widening a chain search. 0 = quote variants only.", "default": 10 }, "includeFlags": { "title": "Include risk flags", "type": "boolean", "description": "Add heuristic flags such as low liquidity, new pair, sell pressure, or no socials.", "default": true }, "newPairHours": { "title": "New pair threshold", "minimum": 1, "maximum": 720, "type": "integer", "description": "Pairs younger than this many hours get a new_pair flag.", "default": 24 }, "maxItemsPerQuery": { "title": "Max per query", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum records from each query, token, or feed. DexScreener caps search at 30.", "default": 30 }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on records for the whole run.", "default": 100 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }