{
  "openapi": "3.0.1",
  "info": {
    "title": "DexScreener Scraper — DEX Pairs, Prices, Boosts & Trending",
    "description": "Scrape DexScreener DEX token & pair market data across every chain — prices, liquidity, volume, transactions, FDV, market cap, boosts, token profiles and new pairs — with derived trading-signal analytics on every record. 6 modes, no login, no API key.",
    "version": "0.0",
    "x-build-id": "qURLEuE57KXnpIDEh"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/brilliant_gum~dexscreener-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-brilliant_gum-dexscreener-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/brilliant_gum~dexscreener-scraper/runs": {
      "post": {
        "operationId": "runs-sync-brilliant_gum-dexscreener-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/brilliant_gum~dexscreener-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-brilliant_gum-dexscreener-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",
              "pair-details",
              "token-pairs",
              "trending-boosts",
              "latest-token-profiles",
              "new-pairs-by-chain"
            ],
            "type": "string",
            "description": "What to scrape. search = free-text token/pair search; pair-details = exact pair by chain+address; token-pairs = all pools of a token address; trending-boosts = boosted/promoted (paid-trending) tokens; latest-token-profiles = newest profiled tokens; new-pairs-by-chain = freshest profiled/boosted tokens on chosen chains.",
            "default": "search"
          },
          "query": {
            "title": "Search query",
            "type": "string",
            "description": "search mode: a single search term — token symbol, name, contract address or pair address (e.g. SOL, PEPE, or a mint address). Merged into `queries`."
          },
          "queries": {
            "title": "Search queries",
            "type": "array",
            "description": "search mode: one or more search terms. Results from all queries are merged and de-duplicated. If both this and `query` are empty, defaults to \"SOL\".",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "chain": {
            "title": "Chain",
            "type": "string",
            "description": "Single chain id (e.g. solana, ethereum, base, bsc). Used by token-pairs (source chain), new-pairs-by-chain, and pair-details (with bare pair addresses). Merged into `chains`."
          },
          "chains": {
            "title": "Chains",
            "type": "array",
            "description": "One or more chain ids. For new-pairs-by-chain the pairs are limited to these chains; for token-pairs these are the source chains to look up token pools on; for search these filter results by chain.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "tokenAddresses": {
            "title": "Token addresses",
            "type": "array",
            "description": "token-pairs mode: one or more token contract/mint addresses. Returns every liquidity pool/pair the token trades in. Up to 30 per batch.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "pairs": {
            "title": "Pairs (chainId/pairAddress)",
            "type": "array",
            "description": "pair-details mode: pair identifiers as \"chainId/pairAddress\" (or \"chainId:pairAddress\"), e.g. solana/Czfq3xZZDmsdGdUyrNLtRhGc47cXcZtLG4crryfu44zE.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "pairAddresses": {
            "title": "Pair addresses (bare)",
            "type": "array",
            "description": "pair-details mode: bare pair addresses, resolved against `chain`/`chains`. Use this when all pairs share one chain.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "boostType": {
            "title": "Boost list",
            "enum": [
              "top",
              "latest"
            ],
            "type": "string",
            "description": "trending-boosts mode: `top` = tokens with the highest total boost (strongest trending signal); `latest` = most recently boosted tokens.",
            "default": "top"
          },
          "rankBy": {
            "title": "Rank by",
            "enum": [
              "volumeH24",
              "volumeH6",
              "volumeH1",
              "volumeM5",
              "liquidityUsd",
              "marketCap",
              "fdv",
              "priceUsd",
              "txnsH24",
              "txnsH6",
              "txnsH1",
              "txnsM5",
              "buysH24",
              "sellsH24",
              "priceChangeH24",
              "priceChangeH6",
              "priceChangeH1",
              "priceChangeM5",
              "pairAgeHours",
              "boostAmount",
              "buyPressureH24",
              "volumeToLiquidity",
              "trendingScore"
            ],
            "type": "string",
            "description": "Sort key. Applied client-side over the fetched records (then maxItems is applied). `trendingScore` is a transparent composite heat score from public fields (volume x turnover x buy-pressure x recency) — our own derived metric, not any exchange's internal score.",
            "default": "volumeH24"
          },
          "order": {
            "title": "Sort order",
            "enum": [
              "desc",
              "asc"
            ],
            "type": "string",
            "description": "Sort direction for `rankBy`. desc = highest first (default), asc = lowest first.",
            "default": "desc"
          },
          "timeframe": {
            "title": "Timeframe",
            "enum": [
              "m5",
              "h1",
              "h6",
              "h24"
            ],
            "type": "string",
            "description": "Primary timeframe used by the volume/txns/price-change filters and pressure summaries: 5 minutes, 1 hour, 6 hours or 24 hours.",
            "default": "h24"
          },
          "minLiquidityUsd": {
            "title": "Min liquidity (USD)",
            "type": "number",
            "description": "Keep only pairs whose pool liquidity in USD is at least this value."
          },
          "maxLiquidityUsd": {
            "title": "Max liquidity (USD)",
            "type": "number",
            "description": "Keep only pairs whose pool liquidity in USD is at most this value."
          },
          "minVolumeUsd": {
            "title": "Min volume (USD, timeframe)",
            "type": "number",
            "description": "Keep only pairs whose trading volume (in the selected `timeframe`) is at least this value in USD."
          },
          "maxVolumeUsd": {
            "title": "Max volume (USD, timeframe)",
            "type": "number",
            "description": "Keep only pairs whose trading volume (in the selected `timeframe`) is at most this value in USD."
          },
          "minMarketCap": {
            "title": "Min market cap (USD)",
            "type": "number",
            "description": "Keep only pairs whose token market cap is at least this value in USD."
          },
          "maxMarketCap": {
            "title": "Max market cap (USD)",
            "type": "number",
            "description": "Keep only pairs whose token market cap is at most this value in USD."
          },
          "minFdv": {
            "title": "Min FDV (USD)",
            "type": "number",
            "description": "Keep only pairs whose fully-diluted valuation is at least this value in USD."
          },
          "maxFdv": {
            "title": "Max FDV (USD)",
            "type": "number",
            "description": "Keep only pairs whose fully-diluted valuation is at most this value in USD."
          },
          "minPriceChange": {
            "title": "Min price change % (timeframe)",
            "type": "number",
            "description": "Keep only pairs whose price change percentage in the selected `timeframe` is at least this value (use negative numbers for drops)."
          },
          "maxPriceChange": {
            "title": "Max price change % (timeframe)",
            "type": "number",
            "description": "Keep only pairs whose price change percentage in the selected `timeframe` is at most this value."
          },
          "minTxns": {
            "title": "Min transactions (timeframe)",
            "type": "integer",
            "description": "Keep only pairs with at least this many total transactions (buys + sells) in the selected `timeframe`."
          },
          "minBuys": {
            "title": "Min buys (timeframe)",
            "type": "integer",
            "description": "Keep only pairs with at least this many buy transactions in the selected `timeframe`."
          },
          "minSells": {
            "title": "Min sells (timeframe)",
            "type": "integer",
            "description": "Keep only pairs with at least this many sell transactions in the selected `timeframe`."
          },
          "minPairAgeHours": {
            "title": "Min pair age (hours)",
            "type": "number",
            "description": "Keep only pairs at least this many hours old (based on pair creation time)."
          },
          "maxPairAgeHours": {
            "title": "Max pair age (hours)",
            "type": "number",
            "description": "Keep only pairs at most this many hours old — useful in new-pairs-by-chain to surface only very fresh launches."
          },
          "dexIds": {
            "title": "DEX ids",
            "type": "array",
            "description": "Keep only pairs on these DEXes (e.g. raydium, orca, uniswap, pancakeswap, meteora). Empty = all DEXes.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "labels": {
            "title": "Pair labels",
            "type": "array",
            "description": "Keep only pairs carrying these labels (e.g. v2, v3, v4, CLMM, DLMM). Empty = all.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "quoteSymbols": {
            "title": "Quote symbols",
            "type": "array",
            "description": "Keep only pairs quoted in these tokens (e.g. SOL, USDC, WETH, USDT). Empty = all quote tokens.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "requireSocials": {
            "title": "Require socials/website",
            "type": "boolean",
            "description": "Keep only pairs whose token has a website or social links / info block attached.",
            "default": false
          },
          "requireBoosted": {
            "title": "Require boosted",
            "type": "boolean",
            "description": "Keep only tokens that currently have an active boost.",
            "default": false
          },
          "includeOrders": {
            "title": "Include paid-order history",
            "type": "boolean",
            "description": "pair-details / token-pairs / trending-boosts / profiles: attach the token's paid-order history (tokenProfile / tokenAd / boost purchases and their status) from the orders endpoint. Adds one request per token (60 req/min endpoint).",
            "default": false
          },
          "includeAnalytics": {
            "title": "Include derived analytics",
            "type": "boolean",
            "description": "Attach the derived trading-signal analytics block (buy/sell pressure, turnover, momentum/acceleration, FDV/MC ratios, volume-per-txn, trending score) to every record.",
            "default": true
          },
          "flat": {
            "title": "Flat output",
            "type": "boolean",
            "description": "Emit flat, denormalized one-row-per-pair records (analytics and key numerics hoisted to the top level) instead of the nested structure — spreadsheet/CSV friendly.",
            "default": false
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Maximum number of output records to push for the whole run.",
            "default": 100
          },
          "maxItemsPerQuery": {
            "title": "Max items per query/source",
            "type": "integer",
            "description": "Cap results taken from each individual search query / chain / boost list before merging (0 = no per-source cap).",
            "default": 0
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional. The DexScreener public API answers directly without a proxy; enable an Apify proxy only for scale or geo needs. When set, requests route through the chosen 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}