{
  "openapi": "3.0.1",
  "info": {
    "title": "DexScreener Pairs Scraper",
    "description": "Collect public DexScreener trading pairs and return one dataset item per distinct pool. Records include chain, exchange, token addresses, prices, liquidity, volume, price changes and pair URLs. Search across chains, look up known tokens or pairs, or use public discovery lists without an API key.",
    "version": "0.1",
    "x-build-id": "7Kfn5ZNhXzAlj3Emf"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/axiomworks~dexscreener-pairs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-axiomworks-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/axiomworks~dexscreener-pairs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-axiomworks-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/axiomworks~dexscreener-pairs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-axiomworks-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": {
          "searchQueries": {
            "title": "Token symbols, names, pairs or addresses",
            "type": "array",
            "description": "Search strings, e.g. [\"WETH\"] or [\"SOL/USDC\"]. Each query returns up to 30 pairs across chains. Empty target lists with discover=\"none\" fall back to WETH.",
            "items": {
              "type": "string"
            }
          },
          "tokenAddresses": {
            "title": "Token addresses with optional chain",
            "type": "array",
            "description": "Token contracts, e.g. [\"ethereum:0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2\"]. Accept chainId:address, chainId/address, DexScreener URLs or bare addresses. Bare addresses use defaultChainId, or exact address search when it is empty.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "pairUrls": {
            "title": "Pair URLs or chain and pair addresses",
            "type": "array",
            "description": "Pair locators, e.g. [\"ethereum/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640\"], full https://dexscreener.com/{chain}/{address} URLs, or {\"url\":\"...\"} objects. Token addresses in this field fall back to token pool lookup.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "startUrls": {
            "title": "Legacy pair or search URLs",
            "type": "array",
            "description": "Legacy alias for pairUrls; accepts strings or {\"url\":\"https://dexscreener.com/?q=WETH\"} objects. Pair URLs look up pools; /?q= and /search?q= URLs run text searches. Default [].",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "title": "URL",
                  "description": "DexScreener pair or search URL, e.g. https://dexscreener.com/?q=WETH.",
                  "type": "string"
                }
              },
              "required": [
                "url"
              ]
            },
            "default": []
          },
          "defaultChainId": {
            "title": "Chain ID for bare token addresses",
            "type": "string",
            "description": "Chain ID for bare token addresses, e.g. \"ethereum\", \"solana\", \"base\" or \"bsc\". Default \"\" uses exact address search; qualified addresses keep their own chain.",
            "default": ""
          },
          "discover": {
            "title": "Token discovery list",
            "enum": [
              "none",
              "latestProfiles",
              "latestBoosts",
              "topBoosts",
              "communityTakeovers"
            ],
            "type": "string",
            "description": "Discovery mode: \"none\", \"latestProfiles\", \"latestBoosts\", \"topBoosts\" or \"communityTakeovers\". Example: \"topBoosts\" looks up pools for currently boosted tokens. Default \"none\".",
            "default": "none"
          },
          "chainIds": {
            "title": "Chain IDs to retain",
            "type": "array",
            "description": "Chain IDs to retain, e.g. [\"solana\",\"ethereum\"]. Case-insensitive; default [] keeps every chain.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "dexIds": {
            "title": "DEX IDs to retain",
            "type": "array",
            "description": "Exchange IDs to retain, e.g. [\"uniswap\",\"raydium\"]. Case-insensitive; default [] keeps every exchange.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "minLiquidityUsd": {
            "title": "Minimum liquidity (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Minimum inclusive liquidity in USD, e.g. 10000. Nonnegative number; default 0 disables this bound. A positive bound excludes pairs missing this metric.",
            "default": 0
          },
          "maxLiquidityUsd": {
            "title": "Maximum liquidity (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Maximum inclusive liquidity in USD, e.g. 1000000. Nonnegative number; default 0 disables this bound. A positive bound excludes pairs missing this metric.",
            "default": 0
          },
          "minVolume24hUsd": {
            "title": "Minimum 24-hour trading volume (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Minimum inclusive 24-hour trading volume in USD, e.g. 10000. Nonnegative number; default 0 disables this bound. A positive bound excludes pairs missing this metric.",
            "default": 0
          },
          "minMarketCapUsd": {
            "title": "Minimum reported market capitalization (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Minimum inclusive reported market capitalization in USD, e.g. 1000000. Nonnegative number; default 0 disables this bound. A positive bound excludes pairs missing this metric.",
            "default": 0
          },
          "maxMarketCapUsd": {
            "title": "Maximum reported market capitalization (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Maximum inclusive reported market capitalization in USD, e.g. 100000000. Nonnegative number; default 0 disables this bound. A positive bound excludes pairs missing this metric.",
            "default": 0
          },
          "minPairAgeHours": {
            "title": "Minimum pair age (hours)",
            "minimum": 0,
            "type": "number",
            "description": "Minimum inclusive pair age in hours, e.g. 24. Nonnegative number; default 0 disables this bound. A positive bound excludes pairs missing this metric.",
            "default": 0
          },
          "maxPairAgeHours": {
            "title": "Maximum pair age (hours)",
            "minimum": 0,
            "type": "number",
            "description": "Maximum inclusive pair age in hours, e.g. 168. Nonnegative number; default 0 disables this bound. A positive bound excludes pairs missing this metric.",
            "default": 0
          },
          "maxPairsPerToken": {
            "title": "Maximum pools per base token",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum pools per base token on each chain, e.g. 1 keeps the most liquid pool. Nonnegative integer; default 0 keeps all returned pools. Applied before maxItems.",
            "default": 0
          },
          "sortBy": {
            "title": "Descending result sort field",
            "enum": [
              "none",
              "liquidityUsd",
              "volume24h",
              "priceChange24h",
              "pairCreatedAt",
              "fdv",
              "marketCap",
              "boostsActive"
            ],
            "type": "string",
            "description": "Descending sort by none (API order), liquidityUsd, volume24h, priceChange24h, pairCreatedAt, fdv, marketCap or boostsActive. Default none. Sorting applies to collected pairs before the shared maxItems limit; missing values sort last.",
            "default": "none"
          },
          "maxItems": {
            "title": "Maximum unique pairs to return",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Maximum unique trading pairs to return, integer 1-5000, default 50. Example: 10 returns at most ten pairs after filters and deduplication; fewer when fewer match. One query returns at most 30 API pairs.",
            "default": 50
          },
          "proxyConfiguration": {
            "title": "Optional Apify Proxy settings",
            "type": "object",
            "description": "Proxy settings, e.g. {\"useApifyProxy\":false} (default). Set {\"useApifyProxy\":true} to use Apify Proxy when your IP is blocked or rate-limited; retries use fresh sessions.",
            "default": {
              "useApifyProxy": false
            }
          },
          "minFdvUsd": {
            "title": "Minimum fully diluted valuation (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Minimum inclusive FDV in USD, e.g. 1000000. Default 0 disables this bound; positive bounds exclude pairs without fdv. Applies to returned API pairs, not a sitewide search.",
            "default": 0
          },
          "maxFdvUsd": {
            "title": "Maximum fully diluted valuation (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Maximum inclusive FDV in USD, e.g. 1000000. Default 0 disables this bound; positive bounds exclude pairs without fdv. Applies to returned API pairs, not a sitewide search.",
            "default": 0
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}