{ "openapi": "3.0.1", "info": { "title": "DexScreener Pair Price & Liquidity Scraper", "description": "One row per DEX trading pair: price in USD and in the quote token, pool liquidity, 24h volume, price change and trade counts. Every row carries the timestamp the source itself put on the figures.", "version": "0.1", "x-build-id": "muJolqTkzfVDPcGtY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~dexscreener-pairs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-dexscreener-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/dami_studio~dexscreener-pairs-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-dexscreener-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/dami_studio~dexscreener-pairs-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-dexscreener-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", "properties": { "searchTerms": { "title": "Search terms", "minItems": 0, "maxItems": 100, "type": "array", "description": "Free-text search: a token symbol, a token name, a pair like SOL/USDC, or a contract address. Each term returns at most 30 pairs and there is no page two, so a broad symbol gives you the top of the list rather than every pair. Up to 100 terms per run.", "items": { "type": "string" } }, "tokenAddresses": { "title": "Token addresses", "minItems": 0, "maxItems": 100, "type": "array", "description": "Token contract addresses, written as chain:address - for example solana:So11111111111111111111111111111111111111112 or ethereum:0x6982508145454ce325ddbe47a25d4ec3d2311933. A dexscreener.com URL pasted straight from the browser works too. By default you get the deepest pool for each token, one row each. Up to 100 per run.", "items": { "type": "string" } }, "pairAddresses": { "title": "Pair addresses", "minItems": 0, "maxItems": 100, "type": "array", "description": "Exact pool addresses, written as chain:address, or a pasted dexscreener.com pair URL. One row each. The address that comes back is checked against the one you asked for, so you never get billed for somebody else's pool. Up to 100 per run.", "items": { "type": "string" } }, "chainId": { "title": "Chain for bare addresses", "type": "string", "description": "Only needed if you paste addresses without a chain prefix. Set it to the chain they belong to - solana, ethereum, base, bsc, arbitrum, polygon and so on. An address written as chain:address ignores this." }, "allPoolsPerToken": { "title": "Every pool for each token, not just the deepest", "type": "boolean", "description": "Off by default, which gives you one row per token - the pool with the most liquidity. Turn it on to get every pool the API lists for that token, up to 30 each. Useful for spotting price gaps between venues, and it multiplies what you pay by the number of pools." }, "minLiquidityUsd": { "title": "Skip pools below this liquidity (USD)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Leave at 0 to keep everything. Set it to, say, 10000 and pools holding less than that are dropped before they are written, so you are not billed for dust. A popular symbol returns a lot of near-empty pools." }, "maxItems": { "title": "Maximum rows", "minimum": 1, "maximum": 3000, "type": "integer", "description": "Total rows across everything you asked for. Keep it low while you are testing - you pay per row. Hard ceiling 3000." }, "proxyUrls": { "title": "Your own proxy servers (optional)", "minItems": 0, "maxItems": 50, "type": "array", "description": "Leave this empty for a normal run. Fill it in only if you want the traffic to leave through proxy servers you already pay for, one URL per line, in the form http://user:pass@host:port.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }