📖 Help Center

Quick start

myeventwatch watches things for you around the clock and pings you the moment something happens — a stock hits your price, someone posts on X, a product page changes, a deal appears.

myeventwatch homepage
  1. Create an account — sign up with email, Google, or GitHub. Verify your email with the 6-digit code we send you.
Log in or sign up
  1. Set up a notification channel — go to Settings and connect at least one channel. Telegram is the fastest; email works out of the box.
  2. Add your first monitor — click New monitor, pick a type (website, stock, X account…), fill in the details, and choose which channels should fire.
  3. Get alerted — when something changes, you get a push within seconds. Check the Events tab for full history.

Tip: new monitors default to email-only alerts. Tick extra channels on the monitor form if you want Telegram / push as well.

🌐 Website updates

Watch any web page for changes — prices, news lists, announcements, restocks, anything visible in a browser.

How it works

myeventwatch fetches the page on your schedule and compares it to the last snapshot. Three detection modes:

  • Smart detection (default) — automatically ignores timestamps, ads, and counters; alerts on real content changes.
  • CSS selector — point at a specific part of the page (e.g. .price, #stock-status). Use your browser's Inspect tool to find it. The form has a live preview.
  • RSS / JSON feed — if the site offers RSS, paste the feed URL for instant, precise article-level alerts. JSON API endpoints are auto-detected too.

Step by step

  1. Click New monitor → Website.
  2. Paste the page URL (must start with http:// or https://).
  3. Pick a detection mode. Start with Smart; switch to CSS selector if you only care about one region.
  4. Set the check interval (how often we fetch).
  5. Tick your notification channels, then Save.
Add monitor form

Examples

  • Price drop: monitor a product page with a CSS selector on the price element.
  • News: paste a site's RSS feed URL (e.g. a blog's /feed) — every new article triggers an alert with title + link.
  • Restock: monitor a "notify me" or "out of stock" badge with Smart detection.

Tip: for deal hunting, https://linuxdorss.longpink.com/welfare.xml (linux.do 福利区 mirror, updates every 10 min) is more reliable than the raw RSS behind Cloudflare.

📈 Stock price

Get alerted when a stock crosses a price or moves sharply — fast enough to glance at a chart and decide.

Step by step

  1. Click New monitor → Stock price.
  2. Type the company name or ticker — the symbol search box autocompletes (Chinese, Korean, and English all work; e.g. type 英伟达 → NVDA).
  3. Choose alert type: target price (above / below a level) or swing % (intraday move).
  4. Set the check interval and channels, then Save.

Symbol rules

  • US stocks: plain ticker — AAPL, TSLA, NVDA.
  • Chinese A-shares: add the exchange suffix — 600519.SS (Shanghai), 000001.SZ (Shenzhen).
  • Hong Kong: numeric code + .HK — 0700.HK.
  • ETFs work too — SPY, QQQ.

Tip: quotes come from Yahoo Finance (free tier, near real-time for US stocks). For true tick-level data you'll need a paid data source later.

🐦 X (Twitter)

Get every new post from an X account pushed to you — land early comments, catch breaking news first-hand.

Step by step

  1. Click New monitor → X / Twitter.
  2. Enter the handle — just the username, e.g. elonmusk (the @ is optional).
  3. Set the check interval — minimum is 10 minutes (X API cost floor; 1-minute X polling would cost ~$216/mo in API fees alone).
  4. Tick channels, Save.

Cost & quota

X API reads cost about $0.005 each and come out of your plan's monthly X quota (X Only 750, Starter 1,300, Pro 2,390, Max 3,910; Free has none). When the quota is exhausted, X monitors pause until the 1st of next month.

Tip: the People on X presets (Trump, Musk, Jensen Huang) are pre-verified handles — one click to add.

🪙 Crypto

Same alert logic as stocks, tuned for crypto's 24/7 market — target prices and swing % on any coin.

Step by step

  1. Click New monitor → Crypto.
  2. Type the coin name or symbol — BTC, bitcoin, 以太坊 all resolve. The search appends -USD automatically when needed.
  3. Pick target price or swing %, set interval and channels, Save.

Tip: crypto never sleeps — a swing-% alert catches overnight moves while you sleep.

📊 Markets

Track commodities, metals, forex, and indices through Yahoo Finance — gold, oil, S&P 500, 10-year yield, USD/CNY and more.

Step by step

  1. Click New monitor → Market.
  2. Type what you want in plain words — gold, 上证指数, 10年期美债, EURUSD. Common names map automatically (gold → GC=F, S&P500 → ^GSPC).
  3. Set target / swing alerts like a stock monitor, then Save.

📺 YouTube channels

Get notified the moment a YouTube channel uploads — first-hand news for your 公众号, or never miss a creator again.

Step by step

  1. Click New monitor → YouTube.
  2. Paste any channel URL — youtube.com/@SomeChannel, /c/Name, or /channel/UC… all work. We resolve the channel ID automatically (official RSS preferred, page parsing as fallback).
  3. Set interval and channels, Save. Each new video alerts with title + link.

Tip: YouTube rate-limits by IP — if checks start failing, lengthen the interval.

Reminders

One-off or recurring reminders delivered through your notification channels — a monitor slot that pings you on schedule.

Step by step

  1. Click New monitor → Reminder.
  2. Enter a title and optional description.
  3. Pick the time (converted from your browser timezone to UTC automatically) and repeat: once, daily, weekly, or yearly.
  4. Choose channels, Save. One-off reminders auto-disable after firing; recurring ones schedule the next run.

Tip: a reminder occupies one monitor slot on your plan.

External webhook

Let other systems alert you through myeventwatch. Instead of wiring Telegram, email, Slack, DingTalk and the rest into every tool you run, point them all at one myeventwatch webhook URL — we forward each alert through the channels you already configured for that monitor.

Step by step

  1. Click New monitor → External webhook, give it a name (e.g. “Grafana production”), pick your channels, Save.
  2. On the monitor page, copy the webhook URL — it ends in a 64-character token. Keep it secret: anyone with the URL can trigger alerts. Regenerate it any time from the same page.
  3. In the other system, set its webhook / notification URL to yours. Grafana: Alerting → Contact points → Webhook. UptimeRobot: Alert Contacts → WebHook. PagerDuty / Zabbix / your own scripts: POST JSON to the URL.
  4. Send a test alert from that system, or click Send test alert on the monitor page.

Payload format

POST JSON (max 64 KB). We understand title, message, severity (critical / warning / info / ok), source, url and dedup_key. Grafana payloads (status: firing/resolved + alerts[]) are understood natively; anything else with a title/message works too. A severity of ok / resolved sends a recovery notice. The same dedup_key within your dedup window only alerts once; maintenance windows suppress as usual.

curl -X POST https://myeventwatch.com/api/webhook/<token> \
  -H 'Content-Type: application/json' \
  -d '{"title": "DB is down", "message": "primary db unreachable", "severity": "critical"}'

Tip: rate limit is 60 requests/minute per webhook URL. Each alert fires once — no acknowledgement or escalation chain.

🔔 Notification channels

Every monitor can alert through any channel you've configured. Pick channels per-monitor on the monitor form — new monitors default to email-only, tick more as needed.

All webhook URLs, tokens, and secrets are encrypted at rest. Channels marked 推荐 (recommended) in Settings are sorted by region.

Setup guides

Telegram recommended, instant

  1. Message @BotFather on Telegram, send /newbot, follow the prompts. Copy the bot token.
  2. Message @userinfobot to get your numeric chat ID (or message your new bot first, then open https://api.telegram.org/bot<TOKEN>/getUpdates).
  3. In myeventwatch Settings → Telegram, tick Enable, paste token + chat ID, Save.
  4. Click Send test message — you should get it in seconds.
Telegram settings

Tip: every user runs their own bot — no shared bot, no rate-limit surprises.

Email works out of the box

  1. In Settings → Email, tick Enable.
  2. Enter the address(es) to notify — comma-separated for multiple.
  3. Save, then Send test email.

Web Push browser notifications

  1. In Settings → Web Push, tick Enable.
  2. Your browser will ask for notification permission — click Allow.
  3. Save, then send a test.

Note: push is tied to this browser/device. Repeat on each device you use.

Region note: Web Push relies on Google's push infrastructure (FCM). It does not work reliably in regions where Google services are blocked (e.g. mainland China) unless the device has Google Play Services and can reach Google servers.

Slack via webhook

  1. In Slack, go to Apps → Add → Incoming Webhooks, pick a channel, copy the webhook URL.
  2. In Settings → Slack, paste the URL, Save, send a test.

Discord via webhook

  1. In your Discord server: Channel settings → Integrations → Webhooks → New Webhook, copy the URL.
  2. In Settings → Discord, paste the URL, Save, send a test.

Microsoft Teams via Power Automate

  1. In Power Automate, create an Instant → "When a HTTP request is received" flow, add a "Post message in a chat or channel" step, and copy the generated HTTP URL.
  2. In Settings → Teams, paste the URL, Save, send a test.

Generic Webhook any URL

  1. In Settings → Webhook, paste your endpoint URL (must be https://).
  2. Optional: add a secret — we send it as X-myeventwatch-Signature (HMAC-SHA256) so you can verify authenticity.
  3. Save, send a test. Payload is JSON: {event, monitor, time, …}.

PagerDuty on-call

  1. In PagerDuty: Services → Integrations → Add → Events API v2, copy the integration key.
  2. In Settings → PagerDuty, paste the key, Save, send a test incident.

钉钉群机器人 中国

  1. 钉钉群 → 群设置 → 智能群助手 → 添加机器人 → 自定义,复制 Webhook。
  2. 如需加签:复制 加签 secret(以 SEC 开头)。
  3. 设置 → 钉钉 粘贴 Webhook 与加签 secret,保存并测试。

飞书群机器人 中国

  1. 飞书群 → 群设置 → 群机器人 → 添加机器人 → 自定义机器人,复制 Webhook。
  2. 如需签名:开启签名校验并复制 secret。
  3. 设置 → 飞书 粘贴,保存并测试。

企业微信群机器人 中国

  1. 企业微信群 → 右键 添加群机器人,复制 Webhook。
  2. 设置 → 企业微信 粘贴,保存并测试。

Server酱 微信推送

  1. 访问 sct.ftqq.com 登录并绑定微信,复制你的 SendKey。
  2. 设置 → Server酱 粘贴 SendKey,保存并测试。

Bark iOS 推送

  1. iPhone 安装 Bark App,复制你的 server URL + key(形如 https://api.day.app/xxxx)。
  2. 设置 → Bark 粘贴,保存并测试。

PushPlus 微信/短信

  1. 访问 pushplus.plus 登录,复制你的 token。
  2. 设置 → PushPlus 粘贴 token,保存并测试。

KakaoTalk 한국

  1. Install KakaoTalk on your phone and register with your mobile number.
  2. Go to developers.kakao.com, create an app, and copy the REST API Key.
  3. Ask the site admin to configure the REST API Key, then in myeventwatch Settings → KakaoTalk click Connect KakaoTalk and authorize.
  4. Alerts will be sent to your own KakaoTalk inbox (나에게 보내기). Click Send test message to verify.

Tip: personal use only needs the "send to self" scope — no business registration required.

WxPusher 微信推送

  1. 访问 wxpusher.zjiecode.com 创建应用,复制 appToken;关注公众号后在 用户管理 复制你的 UID。
  2. 设置 → WxPusher 填写 appToken + UID,保存并测试。

💳 Plans & subscriptions

  • Checks are free — scheduled and manual checks cost nothing.
  • Alerts are free — Telegram, email and push notifications are included.
  • Plans gate access — Free: 3 monitors / 1h checks; X Only: 5 / 10min (X only); Web+Market: 15 / 1h; Starter: 10 / 1h; Pro: 25 / 10min; Max: 60 / 1min priority.
  • X monitoring — paid plans only, with a monthly API read quota (X Only 750, Starter 1,300, Pro 2,390, Max 3,910).
  • Invite — share your link: your friend gets Starter for 7 days on signup, and you get Starter for 7 days too. If you already have a paid plan, the reward queues up and activates when it expires.
  • Redeem code — got a code (e.g. from an invite reward)? Enter it on the Billing page; it adds subscription time, queuing behind any active plan.

❓ FAQ

  • Why didn't I get an alert? — check: is the monitor enabled? Is the channel selected on the monitor and configured in Settings? Any events on the monitor's detail page?
  • Symbol not recognized? — type the Yahoo code directly (AAPL, 600519.SS, BTC-USD).
  • Website monitor never fires? — the page may be JavaScript-rendered: try its JSON API endpoint, or set a CSS selector on the region you care about and confirm with Preview.
  • X monitor says "not configured"? — the administrator hasn't set up the X API key yet.
  • SMS never arrives? — make sure the number includes the country code and try the test button; some carriers filter international SMS.
  • Can I edit a monitor? — yes, click Edit on its card or detail page. Changing the target (URL, symbol, handle, channel, reminder time) resets its baseline; changing thresholds, name, interval or alert channels keeps the existing state.

🐦 X API: quotas & best practices

X (Twitter) monitoring uses the official X API, which costs us $0.005 per read. Each plan includes a monthly quota:

  • X Only: 750 reads/month
  • Starter: 1,300 reads/month
  • Pro: 2,390 reads/month
  • Max: 3,910 reads/month
  • Free: no X monitoring

What counts as a read? Each scheduled check of an X monitor = 1 read. A monitor checking every 10 minutes uses ~4,320 reads/month.

Minimum interval: X monitors cannot check more often than every 10 minutes.

When quota runs out: X monitors pause until the 1st of next month. Other monitor types keep working.

Tips: use longer intervals for low-priority accounts; delete unused monitors; one monitor per account.

🔌 REST API

Automate myeventwatch from code or AI agents. Paid plans include API access (Free: 1,000 calls/mo read-only).

Quickstart: Generate a key in Settings → API Keys (starts with ew_, shown once), then:

curl -H "Authorization: Bearer ew_your_key"   https://myeventwatch.com/api/v1/monitors

Full docs (quotas, 6 endpoints, Python/JS/Claude Code examples, rate limits & errors): API Documentation →

1. Get a key: Settings → API Keys → Generate. Key starts with ew_, shown only once.

2. Authenticate:

curl -H "Authorization: Bearer ew_your_key" \n  https://myeventwatch.com/api/v1/monitors

3. Endpoints:

  • GET /api/v1/monitors — list
  • POST /api/v1/monitors — create (type, name, params, interval)
  • GET /api/v1/monitors/<id> — get one
  • DELETE /api/v1/monitors/<id> — delete
  • GET /api/v1/monitors/<id>/events — recent events

Types: website, stock_price, crypto, market, twitter, youtube, rss, reminder.

Limits: 60 req/min per key. Free: 1,000 calls/mo read-only. X Only / Web+Market: 5K · Starter: 10K · Pro: 50K · Max: 200K.

Errors: 401 bad key, 429 rate limited, 402 plan limit, 404 not found.

🤖 Connectors for AI agents

Let your AI agent watch things via Model Context Protocol.

1. Get an API key in Settings → API Keys.

2. pip install mcp, download myeventwatch_mcp.py (direct link).

3. Claude Desktop — edit claude_desktop_config.json:

{"mcpServers":{"myeventwatch":{
  "command":"python",
  "args":["/path/to/myeventwatch_mcp.py"],
  "env":{"MYEVENTWATCH_API_KEY":"ew_your_key"}}}}

Cursor: Settings → MCP → Add, same config. Restart.

Tools: create_monitor, list_monitors, get_events, delete_monitor.

Try: "Watch @elonmusk on X, alert me to new posts."

↑ Contents