The X-Relay manual.
Everything you need to install the bot, pick your watchlist, tune your filters, and read the alerts. Written like a reference manual, not a brochure. If you already paid, skip to commands. If you haven't, start with quick start.
Three moves.
You open Telegram or Discord, add the bot, and paste a handle. That's the whole ritual. Below, each step expanded.
01 · Add the bot
Click one of the install links. The bot joins your DM (Telegram) or your server (Discord). No browser, no extension, no separate account.
> /start X-Relay online. ✓ permissions verified ✓ ready for watchlist
02 · Pick handles — or a whole X List
Use /add <handle> in Telegram or /add username:<handle> in Discord. Turn the vectors on and off per-account so each tracker ships only what you want.
> /add @cobie select vectors ☒ tweets ☒ profile ☒ CA ☐ follows ☒ spaces ☒ community saved · 3 / 20 slots used
Track an entire X List — paste the list link straight into /add and we watch every member at once (tweets, quotes & retweets). One tracker, the whole room.
> /add https://x.com/i/lists/2054202536857641372 📋 CN Alpha · 39 members tracking every member's posts saved · 4 / 20 slots used
03 · Start the trial
The first three days are free. No card up front. The bot enables every feature the moment you add your first tracker — you see exactly what the paid experience looks like.
What gets detected, what doesn't.
Every alert ships from one of twelve event types — eleven per-account vectors plus a global Search Tracker that watches any keyword across the whole of X. The four tweet sub-types (tweets, replies, quotes, retweets) let you fine-tune which posts trigger — opt out of re-posted content without losing first-party posts, or surface only replies if you're tracking how a KOL responds to others.
Original tweets
First-party posts from the account — no retweets, no quote tweets. Scored for breaking / alpha / normal before dispatch. CA addresses inside original tweets are auto-enriched via DexScreener.
flag: tweetsQuote tweets
When the account quote-tweets someone else. Shipped with the quoted tweet's context so you don't need to open X. Toggle off if you only care about first-party signal.
flag: quotesRetweets
Standard retweets (RT @…). Separated from originals so you can suppress them per-tracker for accounts that retweet heavily. Off means zero retweet alerts for that tracker.
Profile edits
Avatar, banner, display name, bio, location, URL, pinned tweet, affiliation badge. Changes diff'd down to the character. Useful for catching rebrands seconds before they're announced.
flag: profileReply alerts with parent context
Fires when a tracked account replies to someone else. Alert renders the original tweet they replied to inside an expandable blockquote — context isn't lost even when you weren't following the conversation. Self-replies (own threads) render as 🧵 Thread by @author with the body suppressed.
Contract address detection
When a CA shows up in a tweet — detected, validated, enriched with chain, market cap, liquidity, 24h volume, and DexScreener link in the same push. Automatic on every tweet vector.
flag: auto-enrichedFollows
Discrete event when the account starts following someone. Includes the followed handle, display name, verified status, and bio snippet.
flag: followsUnfollows
Discrete event when the account drops someone from its following list. Trailing signal — useful for catching falling-out or de-alignment early.
flag: unfollowsX Community activity
Community joins and leaves, plus a convergence alert when 3+ of your tracked accounts land in the same community within an hour.
flag: communitiesAudio Spaces hosted & joined
Live notification when the account goes live in an audio Space (host or participant), with current listener count and Space title. Video broadcasts (x.com/i/broadcasts/...) currently fall under the regular tweet vector — a dedicated broadcast subtype is planned.
AI daily digest
Plain-prose summary of the accounts you watch — what they said, what they did, what changed. One message, once a day, factual. Self-hosted LLM (no 3rd-party AI).
flag: digest · per-subscription, not per-trackerSearch Tracker — global keyword watch
Monitor any keyword, cashtag, phrase, or full X search operator across all of X — not just accounts you track. Pick ⚡ Latest for the raw firehose or 🔥 Top for viral-only. Layer min-follower / min-likes / language / whale-only filters. Auto-badges: 🔥 Surge when volume spikes vs baseline, 🚨 First-wave for tweets #1–#5 on a new narrative.
flag: /addsearch · /mysearches · /removesearchX List Tracker — a whole list in one tracker
Paste any public X List link into /add and we track every member at once — tweets, quotes & retweets, the moment they post, with CA detection. No more adding 40 handles by hand; each alert names the list and the member who fired it. Counts as one tracker slot.
tweets tracker before the split, it was auto-granted quotes + retweets so your stream doesn't silently shrink. Use /edit <handle> to turn off what you don't want. Replies ship now — the alert renders the original tweet you replied to inside an expandable blockquote so context isn't lost. Enable with the replies activity vector.One syntax, two platforms.
Commands are identical in Telegram and Discord. On Telegram most have a button as well — you rarely need to type. On Discord, slash-commands with autocomplete.
/menu via taps.@.https://x.com/i/lists/<id>) and we watch every member at once — tweets, quotes & retweets. Remove it from /list like any tracker./add, pre-filled.query, product, webhook as slash options./mysearches./example-trackers on Discord). See Bulk import.Filter at the tracker level.
Every tracker can carry a comma-separated list of keywords. Tweets that don't match any keyword are silently dropped — other vectors (profile, CA, spaces…) still fire normally. Matching is case-insensitive and works on substrings.
> /filter @cobie current: (empty) enter keywords, comma-separated: > eth, solana, airdrop, listing ✓ filter saved · 4 keywords effect: only tweets containing any of these go through
When to use a filter
- High-volume accounts that post 50+ times/day but only occasionally drop alpha — filter on
listing, announce, ca, airdrop. - Narrative-specific watchlists — filter a crypto journalist on just
binanceorsec. - Personal interests — filter a VC on the tickers you actually hold.
tweets vector. Profile edits, CA drops, and Spaces alerts are never silenced by a keyword filter — the filter is noise-reduction, not gating.Move your whole watchlist in one shot.
Run /import. The bot replies with an Excel template. Open it, fill the rows, upload the file back to the chat. Within seconds your watchlist is live.
| Column | Required | Example | Notes |
|---|---|---|---|
| handle | yes | @cobie | With or without the @. |
| activities | yes | tweets, replies, quotes, retweets, profile | Comma-separated. Valid names: tweets, replies, quotes, retweets, follows, unfollows, profile, communities, all. See §02. |
| filter | no | eth, sol, listing | Optional keyword filter, applies to the tweets vector only. |
| destination | no | -1001234567890 | Chat/channel ID for Telegram; leave blank to deliver in your DM. |
One message a day. All signal.
Every 24 hours the bot condenses everything your watchlist did into one plain-prose summary. It's run through a self-hosted LLM — no OpenAI, no third-party, no data leaves our servers.
Cobie continued the replies-are-alpha thesis, dismissing screenshots of top-signals in DMs.
Ansem shipped two CA mentions on Solana; both crossed 300K MC within the hour.
Tier10k flagged three Binance listings — all with deposits opening inside 24h.
CZ started following @new_ops_protocol; first follow in that vertical in 8 weeks.
Opting in / out
Off by default — opt in with /digest on the menu or via the toggle in /status. Fires at 09:00 UTC daily once enabled. The digest ignores tracker-level keyword filters — you see the full day in one place.
Priced like a tool, not a SaaS.
Two paid plans — $30/mo for 20 trackers + every vector, or $77 quarterly (saves 14%). All paid features are flat — no tier-gating of CA detection, Spaces, or AI digest. Discord users additionally get a Free Plan tier with 2 trackers forever for casual use.
| Plan | Price | Effective / month | Slots | Trial | Where |
|---|---|---|---|---|---|
| Free Plan | $0 | $0.00 | 2 accounts forever | n/a — no card needed | Discord only |
| Monthly | $30 | $30.00 | 20 accounts | 3 days free | TG + DC |
| Quarterly · recommended | $77 / 3 mo | $25.67 | 20 accounts | 3 days free | TG + DC |
Payments
Pay in crypto: BTC, ETH, USDT (ERC-20, TRC-20, BEP-20), SOL, TON, LTC, plus 20+ other networks via Plisio. No credit cards, no KYC for sub.
The bot opens an invoice, you pay from any wallet, the subscription activates the moment the tx confirms.
Limits
- Telegram side: 3-day free trial after joining @x_relayy, then $30/mo for 20 trackers (or quarterly). No free permanent tier on TG.
- Discord side: Free Plan (2 trackers forever) baseline, with optional paid upgrade to 20 trackers for $30/mo. Free Plan stays free as long as you use it.
- Paid (Monthly / Quarterly): 20 accounts per subscription on both paid plans.
- Two subscriptions per person. Want more than 20 accounts? Buy a Telegram sub and a Discord sub in parallel — independent quotas.
- No rate limit on alerts. We don't throttle signals to your channel.
Tweet in, token context out.
The moment a tweet lands on a tracked account, the CA detector runs. It looks for Solana, EVM (Ethereum / Base / Arbitrum / Optimism / BNB / Polygon), Tron, TON, Sui addresses. Validated addresses are enriched via DexScreener and pushed in the same alert.
"new address on sol: So1abcDEF…K9LqMNo"
◆ token context
chain · solana
mc · $412,500 · 24h · +84.2%
liq · $68K · vol 24h · $1.3M
- Address validation — every candidate is regex-matched, checksum-verified (for EVM), and dropped if it doesn't resolve on-chain.
- Duplicate suppression — if the same CA is posted twice within 10 minutes, the second hit is silenced.
- Chain tagging — automatic chain detection; no configuration needed.
Where operators actually talk now.
Spaces
Fires when a tracked account starts hosting, or when they join someone else's Space as a speaker. Alert includes title, listener count, and a link to join live.
Community convergence
X Communities are small, topic-locked rooms. When three or more tracked accounts join the same community within a rolling 60-minute window, a convergence alert fires — often the earliest signal of a forming narrative.
4 tracked accounts joined "post-TGE ops":
· @ansem (12m ago)
· @cobie (34m ago)
· @loopify (41m ago)
· @gcrclassic (50m ago)
What we promise.
- Instant alerts — the moment a tweet goes live, it's already on your phone. No refresh, no delay.
- 99.97% uptime over the last 90 days — the bot doesn't sleep, so you don't miss alpha.
- Always running — multiple redundant layers under the hood. If one piece slows down, the alert finds another path and reaches you anyway.
Live uptime chart: landing page → service health. Announcements of every incident go to the public TG channel @x_relayy.
Is this an official X / Twitter product?
No. X-Relay is an independent, third-party monitoring tool. It runs on publicly available endpoints and respects X's terms. Not affiliated with X Corp.
How is detection so fast?
We run a pool of scrapers against the GraphQL endpoints X itself uses for the timeline. Each account is polled on a rotating schedule tuned per-account (activity-weighted). Alerts hit your chat in real-time — typically under a second from the moment a tweet goes live.
Does the bot work in group chats / servers?
Yes. Telegram: add the bot to a group and point a tracker's destination at the group ID. Discord: invite the bot, grant Send Messages + Embed Links, use /add in the channel you want alerts in.
Can I send different trackers to different channels?
Yes. On Telegram each tracker can specify its own destination (DM, group, or channel). On Discord each tracker lives in the channel it was added in.
What happens when my trial or subscription expires?
Trackers pause but your watchlist is saved for 30 days. Re-subscribe with /subscribe and everything resumes instantly — handles, filters, destinations all preserved.
What is the Search Tracker?
Search Tracker monitors any keyword, phrase or full X search operator across the whole of X.com — not just accounts you follow. Pick Top (viral, ranked) or Latest (raw, real-time), set a minimum follower threshold, and we'll fire an alert each time a matching tweet lands. Two badges fly with the alert when relevant:
🌊 Surge — the current hour beat the 24h median for this query by 3× or more.
🎯 Alpha Radar — one of the first 5 tweets of a fresh surge wave. Catch narratives before the crowd.
Create with /addsearch on Telegram or Discord. List yours with /mysearches, delete with /removesearch.
Can I track an entire X List?
Yes. Paste a public X List link (https://x.com/i/lists/<id>) straight into /add — on Telegram paste it when the bot asks who to track; on Discord put it in the account field. We resolve the list, then stream every member's tweets, quotes and retweets the moment they post, with contract-address detection. Each alert names the list and the member who fired it.
One X List counts as a single tracker slot no matter how many members it has — the most efficient way to watch a whole room (a KOL bucket, an "alpha CN" list, a team). Remove it from /list like any other tracker.
Why do I have to join @x_relayy to start a trial?
Our free trial is gated behind membership of the announcements channel @x_relayy. This keeps bots and throwaway accounts out of the free tier, and means we can reach you if service status changes or a new vector ships. Once you're in the channel, tap Verify in the bot and the trial activates instantly. Cached for 24h — we re-check on the next create to keep the gate honest.
What does "Whale × Keyword" do?
Toggle whale_only on a search tracker to only fire when a tier-1 crypto account posts a match. Default list ships with the most-followed KOLs in the space. In the future this will also cross-reference with the accounts you already track — so you get a personalised whale filter with no extra config.
How does X-Relay avoid spamming me with popular search queries?
Three passes: (1) a shared query bucket dedups identical searches across users so we poll X once even if 50 people track "solana listing", (2) a since_id cursor skips anything we've seen in the last hour, (3) adaptive polling slows us down when nothing interesting fires and speeds up when it does. Net effect: fresh signal, no duplicate pings.
Is my data shared anywhere?
No. The AI digest runs on a self-hosted LLM. No user data is sent to OpenAI, Anthropic, or any third-party AI service. Alerts go only to the Telegram / Discord destinations you configured.
I have a feature request.
DM @sykocoBOT on X or leave it in the announcements channel. We ship weekly.