{
  "openapi": "3.0.1",
  "info": {
    "title": "DexScreener Scraper - Boosted & Trending Tokens API",
    "description": "DexScreener API alternative, no key: boosted tokens, pair search, honeypot security audit. Export DexScreener data to CSV/JSON across every chain.",
    "version": "1.0",
    "x-build-id": "ElaJxsm37NFjSkjcf"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/logiover~dexscreener-boosted-tokens-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-logiover-dexscreener-boosted-tokens-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-boosted-tokens-scraper/runs": {
      "post": {
        "operationId": "runs-sync-logiover-dexscreener-boosted-tokens-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-boosted-tokens-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-logiover-dexscreener-boosted-tokens-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": {
          "mode": {
            "title": "Data mode",
            "enum": [
              "boostedTokens",
              "searchPairs",
              "tokenPairs",
              "pairWatchlist",
              "pairSecurity"
            ],
            "type": "string",
            "description": "Which DexScreener dataset to pull. Each mode uses its own fields (grouped below). 'boostedTokens' is the flagship promoted-token + marketing-spend scanner.",
            "default": "boostedTokens"
          },
          "sources": {
            "title": "Boost sources",
            "uniqueItems": true,
            "type": "array",
            "description": "[boostedTokens] Which discovery feeds to pull.",
            "items": {
              "type": "string",
              "enum": [
                "top-boosted",
                "latest-boosted",
                "latest-profiles"
              ],
              "enumTitles": [
                "Top boosted",
                "Latest boosted",
                "Latest profiles"
              ]
            },
            "default": [
              "top-boosted",
              "latest-boosted",
              "latest-profiles"
            ]
          },
          "minBoostAmount": {
            "title": "Min boost amount",
            "minimum": 0,
            "type": "integer",
            "description": "[boostedTokens] Drop tokens below this total boost amount. 0 = no filter.",
            "default": 0
          },
          "includeOrders": {
            "title": "Include marketing orders",
            "type": "boolean",
            "description": "[boostedTokens] Enrich each token with its DexScreener marketing-order/boost history.",
            "default": true
          },
          "enrichWithPairData": {
            "title": "Enrich with pair data",
            "type": "boolean",
            "description": "[boostedTokens] Attach the token's top liquidity pair (price, volume, liquidity, market cap).",
            "default": true
          },
          "queries": {
            "title": "Search queries",
            "type": "array",
            "description": "[searchPairs] Terms to search — token symbol, name, partial contract, or pair label.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "matchSymbol": {
            "title": "Symbol contains",
            "type": "string",
            "description": "[searchPairs] Keep only pairs whose base symbol contains this substring. Empty = no filter.",
            "default": ""
          },
          "exactSymbol": {
            "title": "Symbol equals",
            "type": "string",
            "description": "[searchPairs] Keep only pairs whose base symbol exactly matches. Empty = no filter.",
            "default": ""
          },
          "maxPairsPerQuery": {
            "title": "Max pairs per query",
            "minimum": 0,
            "type": "integer",
            "description": "[searchPairs] Cap results per query (after ranking by liquidity). 0 = no cap.",
            "default": 0
          },
          "tokenAddresses": {
            "title": "Token addresses",
            "type": "array",
            "description": "[tokenPairs] Token contract addresses to look up all pairs for.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "chainId": {
            "title": "Chain (optional, enables batching)",
            "enum": [
              "",
              "solana",
              "ethereum",
              "bsc",
              "base",
              "arbitrum",
              "polygon",
              "avalanche",
              "optimism",
              "sui",
              "tron",
              "ton",
              "blast",
              "pulsechain",
              "cronos",
              "fantom",
              "linea",
              "scroll",
              "zksync",
              "mantle",
              "celo",
              "gnosis",
              "moonbeam",
              "aptos",
              "hyperliquid",
              "sei",
              "berachain",
              "abstract",
              "unichain",
              "worldchain",
              "hedera",
              "osmosis"
            ],
            "type": "string",
            "description": "[tokenPairs] If set and multiple addresses are given, uses the fast batched endpoint. Leave as \"Auto (all chains)\" for multi-chain lookup per address.",
            "default": ""
          },
          "maxPairsPerToken": {
            "title": "Max pairs per token",
            "minimum": 0,
            "type": "integer",
            "description": "[tokenPairs] Cap pairs per token (after ranking by liquidity). 0 = no cap.",
            "default": 0
          },
          "pairs": {
            "title": "Pairs (chain:pairAddress)",
            "type": "array",
            "description": "[pairWatchlist · pairSecurity] Pairs as 'chain:pairAddress' strings, e.g. 'solana:HXk...'. Used by both the watchlist and security modes.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "useBatch": {
            "title": "[pairWatchlist] Batch requests",
            "type": "boolean",
            "description": "[pairWatchlist] Batch up to 30 addresses per request (faster). Off = one request per pair.",
            "default": true
          },
          "skipHolders": {
            "title": "[pairSecurity] Skip holder lists",
            "type": "boolean",
            "description": "[pairSecurity] Omit the (large) top-holder arrays from output; keep counts.",
            "default": false
          },
          "useProxy": {
            "title": "[pairSecurity] Use Apify Proxy",
            "type": "boolean",
            "description": "[pairSecurity] The pair-details endpoint is Cloudflare-protected; residential proxy strongly recommended. (Other modes use the open API and ignore this.)",
            "default": true
          },
          "proxyGroups": {
            "title": "[pairSecurity] Proxy groups",
            "type": "array",
            "description": "[pairSecurity] Apify proxy groups. RESIDENTIAL is the most reliable against Cloudflare.",
            "default": [
              "RESIDENTIAL"
            ],
            "items": {
              "type": "string"
            }
          },
          "onlyChains": {
            "title": "Only these chains",
            "uniqueItems": true,
            "type": "array",
            "description": "[boostedTokens · searchPairs · tokenPairs] Keep only rows on these chains. Leave empty for all chains.",
            "items": {
              "type": "string",
              "enum": [
                "solana",
                "ethereum",
                "bsc",
                "base",
                "arbitrum",
                "polygon",
                "avalanche",
                "optimism",
                "sui",
                "tron",
                "ton",
                "blast",
                "pulsechain",
                "cronos",
                "fantom",
                "linea",
                "scroll",
                "zksync",
                "mantle",
                "celo",
                "gnosis",
                "moonbeam",
                "aptos",
                "hyperliquid",
                "sei",
                "berachain",
                "abstract",
                "unichain",
                "worldchain",
                "hedera",
                "osmosis"
              ],
              "enumTitles": [
                "Solana",
                "Ethereum",
                "BNB Chain (BSC)",
                "Base",
                "Arbitrum",
                "Polygon",
                "Avalanche",
                "Optimism",
                "Sui",
                "Tron",
                "TON",
                "Blast",
                "PulseChain",
                "Cronos",
                "Fantom",
                "Linea",
                "Scroll",
                "zkSync Era",
                "Mantle",
                "Celo",
                "Gnosis",
                "Moonbeam",
                "Aptos",
                "Hyperliquid",
                "Sei",
                "Berachain",
                "Abstract",
                "Unichain",
                "World Chain",
                "Hedera",
                "Osmosis"
              ]
            },
            "default": []
          },
          "onlyDexes": {
            "title": "Only these DEXes",
            "type": "array",
            "description": "[searchPairs · tokenPairs] Keep only rows on these DEXes (e.g. raydium, uniswap). Empty = all.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "minLiquidityUsd": {
            "title": "Min liquidity (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "[searchPairs · tokenPairs · pairWatchlist] Drop pairs below this liquidity. 0 = no filter.",
            "default": 0
          },
          "minVolume24hUsd": {
            "title": "Min 24h volume (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "[searchPairs · tokenPairs · pairWatchlist] Drop pairs below this 24h volume. 0 = no filter.",
            "default": 0
          },
          "maxConcurrency": {
            "title": "Max concurrent requests",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "[all modes] Parallel API requests. The public API allows ~300/min; the security mode is auto-clamped lower.",
            "default": 6
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}