{
  "openapi": "3.0.1",
  "info": {
    "title": "Dexscreener Realtime Monitor",
    "description": "Monitor live Dexscreener DEX pairs — price, 5m/1h/6h/24h change, volume, liquidity, FDV, market cap across Solana, Ethereum, Base, BSC and 100+ chains. Watchlist alerts, new-pair & trending discovery. HTTP-only, MCP-ready.",
    "version": "1.1",
    "x-build-id": "AePdbkKpd5RUFXOQO"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~dexscreener-realtime-monitor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-dexscreener-realtime-monitor",
        "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/khadinakbar~dexscreener-realtime-monitor/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-dexscreener-realtime-monitor",
        "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/khadinakbar~dexscreener-realtime-monitor/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-dexscreener-realtime-monitor",
        "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": "Mode",
            "enum": [
              "auto",
              "search",
              "tokens",
              "pairs",
              "discover"
            ],
            "type": "string",
            "description": "How to select pairs. Use 'auto' (default) to let the actor infer the mode from which fields you fill: a 'search' keyword, 'tokenAddresses', or 'pairChainId'+'pairAddresses'. Use 'discover' to pull trending/new tokens instead of a specific target. NOT a chain selector — set chains via 'chainIds'.",
            "default": "auto"
          },
          "search": {
            "title": "Search keyword",
            "type": "string",
            "description": "Free-text query run against Dexscreener search — a token symbol, name, or address (e.g. 'WIF', 'PEPE', or a contract address). Returns matching pairs across all chains ranked by relevance. Used only in 'search' mode (or 'auto' when this is the only field set). NOT a chain name — use 'chainIds' to filter chains."
          },
          "tokenAddresses": {
            "title": "Token addresses",
            "type": "array",
            "description": "Token contract addresses to monitor (up to 30 per run). Every DEX pair holding each token is returned (e.g. Solana mint 'EPjFWdd5...' or ERC-20 '0x...'). Accepts an array or a comma/newline-separated string. Used in 'tokens' mode. NOT pair addresses — for a specific pool use 'pairAddresses'.",
            "items": {
              "type": "string"
            }
          },
          "pairChainId": {
            "title": "Pair chain ID",
            "type": "string",
            "description": "Chain slug for 'pairs' mode, lowercase (e.g. 'solana', 'ethereum', 'base', 'bsc', 'ton', 'arbitrum'). Required together with 'pairAddresses' to fetch exact pools. Ignored in other modes. NOT a display name — use the Dexscreener chain slug exactly."
          },
          "pairAddresses": {
            "title": "Pair addresses",
            "type": "array",
            "description": "Exact DEX pair (pool) addresses to fetch, paired with 'pairChainId' (up to 30 per run). Returns just those pools, not every pool of a token. Accepts an array or a comma/newline-separated string. Used in 'pairs' mode. NOT token contract addresses — for those use 'tokenAddresses'.",
            "items": {
              "type": "string"
            }
          },
          "discover": {
            "title": "Discovery feed",
            "enum": [
              "top-boosts",
              "latest-boosts",
              "new-profiles"
            ],
            "type": "string",
            "description": "Which discovery feed to pull when mode is 'discover'. 'top-boosts' = most-boosted (promoted) tokens right now, 'latest-boosts' = newly boosted, 'new-profiles' = tokens that just added a Dexscreener profile. Each discovered token is enriched with live pair data. Ignored unless mode='discover'.",
            "default": "top-boosts"
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum number of pairs to return and charge for. The run stops once this many pairs are pushed. Range 1–1000, default 100. Note: the search endpoint returns at most ~30 pairs per query regardless of this cap.",
            "default": 100
          },
          "onePairPerToken": {
            "title": "One pair per token",
            "type": "boolean",
            "description": "When true (default), collapse a token's many pools to its single deepest-liquidity pair — the usual choice for watchlist monitoring. Set false to return every pool of every token. Always ignored in 'pairs' mode (which returns the exact pools you asked for).",
            "default": true
          },
          "chainIds": {
            "title": "Alert filter — chains",
            "type": "array",
            "description": "Restrict output to these chain slugs (lowercase, e.g. 'solana', 'base'). Leave empty to allow all chains. Accepts an array or comma/newline string. A pair on any other chain is dropped.",
            "items": {
              "type": "string"
            }
          },
          "minLiquidityUsd": {
            "title": "Alert filter — min liquidity (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Drop pairs whose pooled liquidity is below this many US dollars (e.g. 25000). Higher values filter out illiquid/rug-risk pools. Leave empty to disable. Whole dollars."
          },
          "minVolumeH24Usd": {
            "title": "Alert filter — min 24h volume (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Drop pairs whose trailing 24-hour traded volume is below this many US dollars (e.g. 50000). Filters out inactive pairs. Leave empty to disable. Whole dollars."
          },
          "minMarketCapUsd": {
            "title": "Alert filter — min market cap (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Drop pairs whose token market cap is below this many US dollars (e.g. 1000000). Leave empty to disable. Whole dollars."
          },
          "maxPairAgeHours": {
            "title": "Alert filter — max pair age (hours)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only pairs created within the last N hours (e.g. 24) — the core 'new pair' alert. A pair older than this is dropped. Leave empty to disable. Whole hours."
          },
          "minPriceChangeH1Pct": {
            "title": "Alert filter — min 1h price change (%)",
            "type": "integer",
            "description": "Keep only pairs whose 1-hour price change is at least this percent (e.g. 20 for pumps of +20% or more). Signed whole percent; negatives are allowed but this is a minimum, so it best captures upward moves. Leave empty to disable."
          },
          "minPriceChangeH24Pct": {
            "title": "Alert filter — min 24h price change (%)",
            "type": "integer",
            "description": "Keep only pairs whose 24-hour price change is at least this percent (e.g. 50). Signed whole percent; this is a minimum threshold. Leave empty to disable."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}