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
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
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 eleven event types. You can enable any subset per-tracker. The three tweet sub-types (tweets, quotes, retweets) let you opt out of re-posted content without losing first-party posts — useful for accounts that retweet heavily.
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. Changes diff'd down to the character. Useful for catching rebrands before they're announced.
flag: profilePinned-tweet rotations
Separate alert when the pinned tweet changes. Pinned tweets are billboards — when one moves, someone wants attention on the new one. Ships as a profile sub-event today.
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: communitiesSpaces hosted & joined
Live notification when the account goes live in a Space (as host or participant), with current listener count and Space title.
flag: spacesAI 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-trackertweets 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 stay off by default and are reserved for a future rollout.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.
@./add, pre-filled.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, quotes, retweets, profile | Comma-separated. Valid names: tweets, 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
Enabled by default. Disable with /digest off or the toggle in /settings. The digest ignores tracker-level keyword filters — you see the full day in one place.
Priced like a tool, not a SaaS.
There are two plans. Both unlock every vector, every feature, every integration. The difference is commitment and a 14% discount for quarterly.
| Plan | Price | Effective / month | Slots | Trial |
|---|---|---|---|---|
| Monthly | $30 | $30.00 | 20 accounts | 3 days free |
| Quarterly · recommended | $77 / 3 mo | $25.67 | 20 accounts | 3 days free |
Payments
Pay in crypto: BTC, ETH, USDT (ERC-20, TRC-20, BEP-20), SOL, TON, LTC, plus 20+ other networks via our payment processor. 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
- 20 accounts per subscription. Watchlist size cap is the same across both plans.
- Two subscriptions per person. If you want more than 20 accounts, buy a Telegram sub and a Discord sub in parallel — they're independent.
- 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.
- Real-time detection — tweets are pushed to your feed the instant they hit X. Measured live.
- 99.97% service uptime on the 90-day rolling window.
- Redundant scraper pool — dozens of auth tokens rotate; if one goes rate-limited, traffic reroutes automatically.
- Auto-restart on crash. Systemd policy is
Restart=always.
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.
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.