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 account:<handle> activities:all webhook:<url> in Discord (all three are required). Turn the vectors on and off per-account so each tracker ships only what you want.
> /add @cobie select vectors ☒ tweets ☒ replies ☒ quotes ☐ follows ☒ profile ☒ community saved · 3 / 30 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 / 30 slots used
03 · Start the trial
The first three days are free. No card up front. The bot enables every feature except Bio Watch (paid plans only) the moment you add your first tracker — you see 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 2 or more of your tracked accounts land in the same community within an hour.
flag: communitiesAudio Spaces surfaced from tweets
When a tracked account tweets an audio Space, the alert surfaces the Space title, live state and current listener count, with a link to join. Video broadcasts (x.com/i/broadcasts/...) currently fall under the regular tweet vector — a dedicated broadcast subtype is planned.
Search 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.
Bio Watch — find the account before it tweets
The vectors above watch accounts you already know. Bio Watch finds the ones you don't. Give it a keyword — a chain, a protocol, a ticker — and X-Relay scans X for accounts putting it in their profile bio, not their tweets. Fires when an account newly carries the keyword: a brand-new account (🚨 FRESH) or an existing one that just added/changed its bio (👀 in bio) — with the bio (keyword highlighted), follower count and account age. Filter noise with qualifiers, stop-words or min-followers. Catch a project the day it's born — or the day someone pivots into your niche. How Bio Watch works →
paid · /addbio · /removebio · up to 10 keywordstweets tracker before the split, it was auto-granted quotes + retweets so your stream doesn't silently shrink. Re-add the handle with /add to change which vectors fire. 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.@. On Discord all three options are required: account:, activities:, webhook:.https://x.com/i/lists/<id>) and we watch every member at once — tweets, quotes & retweets, plus members' own thread continuations. Remove it from /list like any tracker. On Discord pass the link as account: with the required activities: and webhook:.query, product, webhook as slash options./mysearches.keyword, webhook, and optional qualifiers / exclude / min_followers. Paid feature, up to 10 keywords./example-trackers on Discord). See Bulk import./menu → Refer & Earn.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.
Filters are attached through the filter column of the Excel sheet you upload with /import — list your keywords comma-separated in that column for any handle. To change a filter later, re-upload the sheet with the new keywords.
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. |
Priced like a tool, not a SaaS.
One plan, every vector. You scale only by how many X accounts you track — a four-tier ladder from Lite ($15/mo · 10 accounts) through Solo ($30/mo · 30), Plus ($49/mo · 50), to Pro ($69/mo · 75). Every feature is in every tier — no gating of CA detection, X-Lists, Search Tracker, or Spaces. Pay monthly or save with the 3-month rate. Discord users additionally get a Free Plan tier with 2 trackers forever for casual use.
| Plan | Accounts | Monthly | 3-month | Trial | Where |
|---|---|---|---|---|---|
| Free Plan | 2 accounts forever | $0 | $0 | n/a — no card needed | Discord only |
| Lite | 10 accounts | $15 | $39 / 3 mo | 3 days free | TG + DC |
| Solo · most popular | 30 accounts | $30 | $77 / 3 mo | 3 days free | TG + DC |
| Plus | 50 accounts | $49 | $129 / 3 mo | 3 days free | TG + DC |
| Pro | 75 accounts | $69 | $179 / 3 mo | 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 (Solo-level, 30 accounts) after joining @x_relayy, then pick a tier from $15/mo Lite up to $69/mo Pro. No free permanent tier on TG.
- Discord side: Free Plan (2 trackers forever) baseline, with optional paid upgrade to any tier — entry is $15/mo Lite. Free Plan stays free as long as you use it.
- Account caps by tier: Lite 10 · Solo 30 · Plus 50 · Pro 75. Every feature ships in every tier — you pay only for the number of trackers.
- Need a big watchlist? Pro alone covers up to 75 accounts. Each platform sub has its own quota, so a TG sub and a DC sub run independently if you want both surfaces.
- No rate limit on alerts. We don't throttle signals to your channel.
Bring a friend. Get paid forever.
Every person you refer earns you 20% of every payment they make — not just their first one, but every renewal, for as long as they stay subscribed. No cap on referrals, no expiry on the commission.
How to refer
- Telegram: run /refer in a DM with the bot. You get a personal invite link (t.me/x_relay_bot?start=r-CODE) plus a live dashboard of who you invited and what you've earned.
- Discord: run /menu → Refer & Earn to get your code (the same code works on Telegram too). The friend's server admin runs /referral <code> once inside their server to lock in the attribution.
What your friend gets
It's two-sided. Anyone who joins on your invite gets 10% off their first purchase. They win, you win.
Getting paid
- Commission accrues automatically the moment a referred payment confirms — /refer shows your running balance (earned · owed to you).
- Payouts are manual and on-demand: DM @sykoco to cash out in USDT. No minimum, no schedule — pull your balance whenever you like.
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) and TON 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 and dropped if it doesn't resolve on DexScreener.
- 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.
Every token alert also carries one-tap buy buttons — Axiom, Trojan, Photon, GMGN and BonkBot on Solana; Maestro and GMGN on EVM chains — so you can act without leaving the alert.
Where operators actually talk now.
Spaces
Fires when a tracked account tweets or shares an audio Space. The alert includes the Space title, live state, listener count, and a link to join live.
Community convergence
X Communities are small, topic-locked rooms. When two 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.
- 24/7 uptime — the bot doesn't sleep, with redundant layers 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?
After a 24-hour grace period your trackers pause and you drop to the Free Plan (2 trackers). Re-subscribe any time with /subscribe to lift the cap again.
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.
What is Bio Watch? (discover accounts by bio)
Bio Watch is the mirror image of the Search Tracker: instead of watching keywords in tweets, it watches keywords in profile bios — so it discovers accounts, not posts. Give it a keyword (a chain, protocol or ticker) and X-Relay scans X for accounts putting it in their bio, even before they tweet.
🚨 FRESH — a freshly-created account, badged with its exact age (the high-signal case: a project that just launched). 👀 Watchlist — an established account carrying the keyword. Each alert shows the bio with the keyword highlighted, follower count and account age.
Cut noise with qualifiers (bio must also contain one of these), exclude stop-words, or min_followers. Bio Watch is a paid feature (not part of the free trial); every paid plan includes it with up to 10 keywords. Create with /addbio, remove with /removebio.
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 Telegram trial?
The channel gate applies to the Telegram trial only. Joining the announcements channel @x_relayy 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 Telegram trial activates instantly (cached for 24h). On Discord there is no channel gate — the 3-day trial starts automatically the moment you add the bot to your server.
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?
We don't sell or share your data, and nothing goes to analytics or ad networks. The one exception: public tweet text is sent to Google Translate to auto-translate non-English tweets. 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.