Token Price & Liquidity Alert Monitor - Rug Warning

Token Price & Liquidity Alert Monitor — Rug Warning

Watch any set of tokens and get pinged when something actually happens. Each run reads public DEX market data (keyless) and, because it remembers the last run, alerts on price moves, volume spikes, hard price targets, and — the one most tools miss — a liquidity drop, an early warning that liquidity is being pulled (a rug in progress). Schedule it + set a webhook and it's a standing price/rug alarm. Read-only, keyless, agent-callable.

For traders, token holders watching their bags, and AI agents that need a change-trigger on a token's price or liquidity.

Alerts are factual observations of public market data, not financial advice. A liquidity drop can mean a rug — or just normal LP movement; verify before acting.

What it does

• Tracks each token's primary-pair price, liquidity and 24h volume (keyless DexScreener), by address or symbol.
• Diffs vs the previous run (state in a named KV store) and fires alerts:
  • price-move — moved ≥ your % (up or down)
  • liquidity-drop — liquidity fell ≥ your % → possible rug/liquidity pull
  • volume-spike — 24h volume jumped ≥ your %
  • price-above / price-below — crossed a hard target
• First run = silent baseline; later runs alert only on change, and (with a webhook) push them out.

Field	Meaning
priceUsd, liquidityUsd, volume24hUsd	current market
priceMovePct, liquidityChangePct, volumeChangePct	change since last run
alerts[]	each fired alert with type + detail
signal	baseline-established / no-alert / alert / liquidity-drop-alert

Why not just ask an AI agent?

An agent has no memory between runs and no scheduler — it can't tell you liquidity just fell 60% since an hour ago. This keeps durable per-watch state and fires the moment price or liquidity changes, including the rug-in-progress signal an agent would never catch on its own.

Input

Field	Type	Default	Description
tokens	array	—	Addresses or symbols to watch.
chain	string	any	Restrict to a chain.
priceMovePct	integer	15	Alert on ≥ this % price move.
liquidityDropPct	integer	30	Alert on ≥ this % liquidity drop (rug warning).
volumeSpikePct	integer	0 (off)	Alert on ≥ this % volume jump.
priceAbove / priceBelow	number	—	Hard price targets.
webhookUrl	string	—	POST alerts here when fired.

Example input

{
  "tokens": ["0x6982508145454Ce325dDbE47a25d4ec3d2311933"],
  "priceMovePct": 15,
  "liquidityDropPct": 30
}

Output

One record per watched token. Example (a run that fired, real-shaped):

{
  "tokenSymbol": "PEPE",
  "signal": "liquidity-drop-alert",
  "priceUsd": 4.0e-06,
  "priceMovePct": -50.0,
  "liquidityChangePct": -66.67,
  "alerts": [
    {"type": "price-move", "detail": "Price moved -50.00% since last run."},
    {"type": "liquidity-drop", "severity": "high", "detail": "Liquidity DROPPED -66.67% ($87M -> $29M) - possible liquidity pull / rug."}
  ]
}

The first run returns signal: "baseline-established" and fires nothing.

Alerts / scheduling

1. Set tokens, your thresholds and webhookUrl.
2. Schedule the actor (e.g. every 5–15 min).
3. First run is a silent baseline; after that, every run that detects a change POSTs the alerts to Slack/Discord/email via Make/Zapier.

Ready-made tasks

• Token Price Alert - Move % and Price Targets

For AI agents / MCP

https://mcp.apify.com/?tools=actors,docs,centorprat/token-price-liquidity-alert-monitor

Loads as centorprat--token-price-liquidity-alert-monitor. Claude Code:

claude mcp add apify -- npx -y @apify/actors-mcp-server --actors centorprat/token-price-liquidity-alert-monitor

FAQ

Address or symbol? Either; an address is precise, a symbol tracks the deepest-liquidity match.

What's the liquidity-drop alert for? A sudden liquidity fall is often the first visible sign of a rug/liquidity pull — this flags it so you can react.

Does it need a key? No — keyless public DEX data.

Does first run spam me? No — it's a silent baseline.

Cost? Pay-per-event: a base per run + a small premium per alert fired. Quiet runs cost only the base.

Is this advice? No — factual market-change observations only.

Data & attribution

Public DEX market data via the keyless DexScreener API. No keys, no personal data. Signals, not advice.

Related actors

• New Token Momentum Scanner
• Token Honeypot & Rug Pull Safety Check
• DEX Token Market Snapshot