Xanguard Documentation

Build on top of the fastest Twitter monitoring engine available. Detect tweets in real-time with sub-second latency and deliver them to your app, bot, or trading system through the channel that fits your stack.

What is Xanguard?

Xanguard is a real-time Twitter monitoring platform. It uses a proprietary detection engine to discover new tweets the moment they appear, delivering alerts in typically 250–500ms. Latency varies based on account follower count and tweet complexity.

Whether you are a crypto trader watching influencer wallets, a DeFi protocol monitoring your team accounts, or an AI agent consuming social signals, Xanguard gives you the infrastructure to react before anyone else.

Four Delivery Channels

Quick Start

Telegram Bot

The Telegram bot is the easiest way to use Xanguard. It works in private chats and in groups. In groups with forum topics enabled, the bot automatically creates a dedicated topic thread for each tracked handle, keeping your notifications organized.

Commands

Features

Forum Topics

When you add the bot to a Telegram group with forum topics enabled, it automatically creates a dedicated topic thread for each tracked Twitter handle. All tweets from that handle are routed to their respective topic, keeping your group organized and easy to follow.

Contract Detection

Xanguard automatically detects Solana and Ethereum contract addresses embedded in tweets. When a tweet contains a contract address, it is flagged in the notification. You can enable contracts only mode in settings to receive only tweets that contain contract addresses.

Keyword Filtering

Set per-handle keyword filters so that only tweets matching at least one of your keywords trigger an alert. This is useful for high-volume accounts where you only care about specific topics. Manage keywords through the per-account detail screen in /monitor or via the REST API.

Mute / Unmute

Temporarily mute individual accounts without removing them from your list. Muted accounts retain their keywords and configuration but will not trigger any notifications until you unmute them.

REST API

The REST API exposes 14 endpoints for managing your Xanguard account programmatically. All endpoints live under a single base URL and return consistent JSON responses.

https://api.xanguard.tech/v1

Authentication

All API requests require a Bearer token in the Authorization header. Generate your API key by sending /apikey to the Telegram bot.

Authorization: Bearer xg_your_api_key_here

The server hashes your key with SHA-256 and looks it up in the api_keys table, joining on your subscription tier to determine rate limits and permissions.

Response Envelope

Every response is wrapped in a standard envelope. On success, the ok field is true and the payload is in data. On error, ok is false and the error message is in error.

{
  "ok": true,
  "data": { ... }
}

{
  "ok": false,
  "error": "Invalid API key"
}

Rate Limiting

Requests are rate-limited using a per-key sliding window. The limit is determined by your subscription tier (the ws_rate_limit_rps field on your tier). When you exceed the limit, the API returns 429 Too Many Requests.

Accounts

Manage your tracked Twitter accounts. Add, remove, configure keywords, and mute/unmute handles.

{
  "ok": true,
  "data": {
    "accounts": [
      {
        "handle": "elonmusk",
        "keywords": [],
        "muted": false,
        "added_at": 1234567890
      }
    ],
    "count": 1,
    "limit": 10
  }
}

{
  "handles": ["elonmusk", "VitalikButerin"]
}

{
  "ok": true,
  "data": {
    "added": ["elonmusk"],
    "already_exists": ["vitalikbuterin"],
    "total": 5,
    "limit": 10
  }
}

{
  "ok": true,
  "data": {
    "handle": "elonmusk",
    "keywords": ["bitcoin", "doge"],
    "muted": false,
    "added_at": 1234567890,
    "profile": {
      "display_name": "Elon Musk",
      "followers": 180000000,
      "is_verified": true,
      "profile_pic": "https://pbs.twimg.com/..."
    }
  }
}

{
  "ok": true,
  "data": {
    "removed": "elonmusk",
    "total": 4,
    "limit": 10
  }
}

{
  "keywords": ["bitcoin", "solana", "launch"]
}

{
  "ok": true,
  "data": {
    "handle": "elonmusk",
    "keywords": ["bitcoin", "solana", "launch"]
  }
}

{
  "ok": true,
  "data": {
    "handle": "elonmusk",
    "keywords": []
  }
}

{
  "muted": true
}

{
  "ok": true,
  "data": {
    "handle": "elonmusk",
    "muted": true
  }
}

Settings

Manage your global notification preferences. These settings apply to all delivery channels.

Settings Fields

All fields are booleans. The PATCH endpoint accepts partial updates — only include the fields you want to change.

{
  "ok": true,
  "data": {
    "exclude_replies": false,
    "contracts_only": false,
    "notifications_paused": false,
    "exclude_reposts": false,
    "auto_topics": true,
    "contract_topic": false
  }
}

{
  "exclude_replies": true,
  "contracts_only": true
}

{
  "ok": true,
  "data": {
    "exclude_replies": true,
    "contracts_only": true,
    "notifications_paused": false,
    "exclude_reposts": false,
    "auto_topics": true,
    "contract_topic": false
  }
}

Subscription

View your current subscription tier and browse available plans.

{
  "ok": true,
  "data": {
    "tier": "starter",
    "account_limit": 10,
    "expires_at": "2026-03-21T00:00:00Z"
  }
}

{
  "ok": true,
  "data": {
    "plans": [
      {
        "name": "Free",
        "price_usd": 0,
        "account_limit": 2,
        "max_webhooks": 0
      },
      {
        "name": "Starter",
        "price_usd": 19,
        "account_limit": 10,
        "max_webhooks": 1
      }
    ]
  }
}

Webhooks

Register HTTPS endpoints to receive tweet notifications via signed POST requests. The number of webhooks you can register depends on your subscription tier.

{
  "url": "https://your-server.com/webhook",
  "events": ["tweet"],
  "filter_handles": [],
  "filter_keywords": []
}

{
  "ok": true,
  "data": {
    "id": "wh_a1b2c3d4",
    "url": "https://your-server.com/webhook",
    "events": ["tweet"],
    "secret": "whsec_k9x8m7...",
    "active": true
  }
}

{
  "ok": true,
  "data": {
    "webhooks": [
      {
        "id": "wh_a1b2c3d4",
        "url": "https://your-server.com/webhook",
        "events": ["tweet"],
        "active": true
      }
    ],
    "count": 1,
    "limit": 5
  }
}

{
  "ok": true,
  "data": {
    "id": "wh_a1b2c3d4",
    "deactivated": true
  }
}

Webhook Delivery

When a tweet matches your filters, Xanguard sends a POST request to your registered URL with a JSON body containing the tweet data.

Signature Verification

Every delivery includes an X-Xanguard-Signature header containing an HMAC-SHA256 hex digest of the request body, computed using your webhook secret. Always verify this signature before processing the payload.

const crypto = require('crypto');

function verifySignature(body, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(body)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(signature)
  );
}

import hmac, hashlib

def verify_signature(body: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(
        secret.encode(), body, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature)

Retry Policy

If your endpoint returns a non-2xx status code or the request times out, Xanguard retries up to 3 times with exponential backoff: 1 second, 2 seconds, then 4 seconds. After 10 consecutive failures across any deliveries, the webhook is automatically disabled. You can re-register it via the API once your endpoint is healthy again.

WebSocket

The WebSocket endpoint provides a persistent, real-time stream of tweet alerts. Connect once, subscribe to handles on the fly, and receive structured JSON messages as tweets happen. This is ideal for trading bots, dashboards, and any application that needs the lowest possible latency.

Connection

Connect with your API key as a query parameter:

wss://api.xanguard.tech/v1/ws?api_key=xg_your_key

Client to Server Messages

After connecting, send JSON messages to subscribe or unsubscribe from handles:

{
  "type": "subscribe",
  "handles": ["elonmusk", "VitalikButerin"]
}

{
  "type": "unsubscribe",
  "handles": ["elonmusk"]
}

Server to Client Messages

Tweet Alert

Received when a tracked account posts a tweet:

{
  "type": "alert",
  "handle": "elonmusk",
  "text": "Just bought more $BTC",
  "url": "https://twitter.com/elonmusk/status/123",
  "tweet_id": "123",
  "timestamp": 1234567890
}

Acknowledgement

Sent after a successful subscribe or unsubscribe action:

{
  "type": "ack",
  "action": "subscribe",
  "handles": ["elonmusk"],
  "active": 1,
  "max": 25
}

Error

Sent when a request cannot be fulfilled:

{
  "type": "error",
  "message": "Max handles exceeded"
}

Keepalive

The server sends a WebSocket ping frame every 30 seconds and expects a pong response within 10 seconds. Most WebSocket libraries handle this automatically. If the pong is not received, the server closes the connection. Your client should implement automatic reconnection with backoff.

Example: JavaScript Client

const ws = new WebSocket(
  'wss://api.xanguard.tech/v1/ws?api_key=xg_your_key'
);

ws.onopen = () => {
  // Subscribe to handles once connected
  ws.send(JSON.stringify({
    type: 'subscribe',
    handles: ['elonmusk', 'VitalikButerin']
  }));
};

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);

  if (msg.type === 'alert') {
    console.log(`Tweet from @${msg.handle}: ${msg.text}`);
    console.log(`Link: ${msg.url}`);
  }

  if (msg.type === 'ack') {
    console.log(`Watching ${msg.active}/${msg.max} handles`);
  }

  if (msg.type === 'error') {
    console.error(`Error: ${msg.message}`);
  }
};

ws.onclose = () => {
  // Implement reconnection with backoff
  console.log('Disconnected, reconnecting...');
};

Example: Python Client

import asyncio, json, websockets

async def main():
    uri = "wss://api.xanguard.tech/v1/ws?api_key=xg_your_key"

    async with websockets.connect(uri) as ws:
        # Subscribe to handles
        await ws.send(json.dumps({
            "type": "subscribe",
            "handles": ["elonmusk", "VitalikButerin"]
        }))

        async for message in ws:
            msg = json.loads(message)

            if msg["type"] == "alert":
                print(f"@{msg['handle']}: {msg['text']}")
                print(f"Link: {msg['url']}")

asyncio.run(main())

Community Watch

Community Watch (CW) is a separate Xanguard product that monitors Twitter community gate activity in real time. It detects when any tracked account creates, joins, or leaves a Twitter community, and delivers alerts via webhook or the Telegram bot @F_xanguard_bot.

How It Works

1. Subscribe via @F_xanguard_bot — pick a plan based on how many accounts you want to track.
2. Add targets — tell the bot which Twitter accounts to monitor (e.g. @elonmusk).
3. Get alerts — within ~30 seconds of a community join/leave/create, you get a notification via your configured webhook or the Telegram bot.

On first add, you'll receive a one-time sync of all communities the target is already in. After that, only changes trigger alerts.

Bot Commands

Filters

CW supports per-client filters to reduce noise. Configure them via /settings in the bot or the API.

CW API & Webhooks

CW has its own REST API and webhook delivery system, separate from the main Xanguard API.

Authentication

All CW API requests require your CW API key (generated via /apikey in the bot). Pass it as a header:

Authorization: Bearer cw_your_api_key_here

Base URL: https://api.xanguard.tech/cw/v1

Managing Targets

Webhook Format

Configure your webhook URL via /settings in the bot. CW sends a POST request for each event:

{
  "event": "community_joined",
  "screen_name": "elonmusk",
  "twitter_user_id": "44196397",
  "community": {
    "id": "1234567890",
    "name": "Crypto Builders",
    "member_count": 15420
  },
  "detected_at": "2026-03-03T15:30:00Z"
}

Event types: community_joined, community_left, community_created, community_renamed, community_description_changed, account_followed

CW Pricing

Community Watch is billed monthly in SOL. Subscribe via @F_xanguard_bot.

Upgrades are prorated — you only pay the difference for the remaining days. Renewals stack from your current expiry date.

Payment is in SOL. The exact SOL amount is calculated at checkout based on current SOL/USD rate.

Convergence Tracker

Convergence Tracker (CT) detects when multiple tracked Twitter accounts cluster in the same community simultaneously. When 2+ targets appear in one community, CT fires a convergence alert — a strong signal that a coordinated token launch or community event may be imminent. Managed via @T_Xanguard_bot.

Bot Commands

Pricing

CT API

All CT API requests require a Bearer token with ct_ prefix, generated via /apikey in the bot.

Authorization: Bearer ct_your_api_key_here

Endpoints

WebSocket

wss://api.xanguard.tech/v1/ct/ws?api_key=ct_your_key

Receives real-time JSON events when convergence is detected.

Xanguard B2B

Xanguard B2B is a real-time Twitter/X monitoring API. It streams tweets, follow/unfollow events, profile changes, and new follower detection for your tracked accounts via WebSocket and REST API. Managed via @B2B_Xanguard_bot.

Modules

Bot Commands

Pricing

B2B API

All B2B API requests require a Bearer token with dt_ prefix, generated via /apikey in the bot.

Authorization: Bearer dt_your_api_key_here

REST Endpoints

Realtime WebSocket

wss://api.xanguard.tech/v1/dt/realtime/ws

TweetCatcher-compatible opcode protocol. Connect, authenticate via LOGIN opcode with your dt_ API key, and receive real-time events for all monitored handles.

Opcodes

Event Types

B2B Realtime WebSocket

High-volume real-time feed with TweetCatcher-compatible opcode protocol. Delivers tweets, follow detection, profile changes, and new follower alerts via a single WebSocket connection. Managed via @B2B_Xanguard_bot.

Connection

wss://api.xanguard.tech/v1/dt/realtime/ws

No query parameter needed — authentication happens via the LOGIN opcode after connecting. Maximum 2 concurrent WebSocket connections per API key.

Opcodes

Handshake Flow

1. Connect → Receive HELLO:

{"op": 10, "d": {"heartbeat_interval": 30000}}

2. Send LOGIN with your API key:

{"op": 2, "d": "dt_your_api_key_here"}

3. Receive READY on success:

{"op": 4, "d": {"client_id": 1, "modules": ["realtime", "follows", "profile_watch", "followers"], "handles": 150, "max_handles": 1000, "max_connections": 2}}

Modules

Modules are configured per client. You only receive events for enabled modules.

Event: twitter.post.new

First delivery of a detected tweet. May have partial metadata. Clients should store this and replace with twitter.post.update if received.

{
  "op": 0,
  "d": {
    "event": "twitter.post.new",
    "event_id": "evt_1234567890123456789",
    "task_info": {"handle": "elonmusk"},
    "data": {
      "id": "1234567890123456789",
      "created_at": 1712000000000,
      "type": "post",
      "text": "Hello world",
      "media": [{"type": "photo", "url": "https://pbs.twimg.com/media/..."}],
      "mentions": [{"screen_name": "vitalikbuterin"}],
      "author": {
        "id": "44196397",
        "handle": "elonmusk",
        "name": "Elon Musk",
        "avatar": "https://pbs.twimg.com/profile_images/...",
        "description": "CEO of Tesla, SpaceX, etc.",
        "verification": {"is_verified": true},
        "stats": {"followers": 190000000, "following": 800}
      },
      "in_reply_to": null,
      "quoted_tweet": null,
      "possibly_sensitive": false
    }
  }
}

Tweet types in data.type: "post", "reply", "quote", "repost"

Event: twitter.post.update

Enriched re-delivery of a previously sent tweet with complete metadata. Shares the same data.id as the original twitter.post.new. Clients should replace any previously stored data for this tweet ID.

{
  "op": 0,
  "d": {
    "event": "twitter.post.update",
    "event_id": "evt_u_1234567890123456789",
    "task_info": {"handle": "elonmusk"},
    "data": {
      "id": "1234567890123456789",
      "created_at": 1712000000000,
      "type": "quote",
      "text": "This is huge 👀",
      "media": [],
      "mentions": [],
      "author": {
        "id": "44196397",
        "handle": "elonmusk",
        "name": "Elon Musk",
        "avatar": "https://pbs.twimg.com/profile_images/...",
        "description": "CEO of Tesla, SpaceX, etc.",
        "verification": {"is_verified": true},
        "stats": {"followers": 190000000, "following": 800}
      },
      "in_reply_to": null,
      "quoted_tweet": {
        "id": "9876543210987654321",
        "text": "Original tweet text here",
        "author": {"handle": "vitalikbuterin", "name": "Vitalik Buterin"}
      },
      "possibly_sensitive": false
    }
  }
}

Event: twitter.following.new

{
  "op": 0,
  "d": {
    "event": "twitter.following.new",
    "event_id": "evt_f_elonmusk_1712000000",
    "task_info": {"handle": "elonmusk"},
    "data": {
      "id": "44196397",
      "handle": "vitalikbuterin",
      "name": "Vitalik Buterin"
    }
  }
}

Event: twitter.profile.update

{
  "op": 0,
  "d": {
    "event": "twitter.profile.update",
    "event_id": "evt_p_elonmusk_1712000000",
    "task_info": {"handle": "elonmusk"},
    "data": {
      "field": "description",
      "prev": "Old bio text",
      "updated": "New bio text"
    }
  }
}

Fields: "description", "name", "avatar", "pinned_post"

Event: twitter.follower.new

{
  "op": 0,
  "d": {
    "event": "twitter.follower.new",
    "event_id": "evt_fl_elonmusk_1712000000",
    "task_info": {"handle": "elonmusk"},
    "data": {
      "id": "555555555",
      "handle": "newfollower",
      "name": "New Follower"
    }
  }
}

Example: JavaScript Client

const ws = new WebSocket('wss://api.xanguard.tech/v1/dt/realtime/ws');

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  switch (msg.op) {
    case 10: // HELLO
      ws.send(JSON.stringify({op: 2, d: 'dt_YOUR_API_KEY'}));
      break;
    case 4: // READY
      console.log('Connected:', msg.d.modules, msg.d.handles, 'handles');
      break;
    case 0: // EVENT
      console.log('Event:', msg.d.event, msg.d.data);
      break;
  }
};

// Heartbeat every 30s
setInterval(() => {
  if (ws.readyState === WebSocket.OPEN) {
    ws.send(JSON.stringify({op: 1}));
  }
}, 30000);

Example: Python Client

import asyncio, websockets, json

async def connect():
    async with websockets.connect('wss://api.xanguard.tech/v1/dt/realtime/ws') as ws:
        hello = json.loads(await ws.recv())  # HELLO
        await ws.send(json.dumps({"op": 2, "d": "dt_YOUR_API_KEY"}))
        ready = json.loads(await ws.recv())  # READY
        print(f"Connected: {ready['d']['modules']}, {ready['d']['handles']} handles")

        while True:
            msg = json.loads(await ws.recv())
            if msg["op"] == 0:  # EVENT
                print(f"{msg['d']['event']}: {msg['d']['data']}")

asyncio.run(connect())

B2B Realtime Pricing

ECA (Early CA Alerts)

ECA detects pump.fun token launches that match community activity signals. Add a ticker, token name, contract address, or creator wallet to your watchlist, and ECA alerts you when a matching token appears on pump.fun. Entries expire after 4 hours. Free to use. Managed via the ECA section in @Xanguard_bot.

API

Auth: Bearer token with eca_ prefix.

Authorization: Bearer eca_your_api_key_here

WebSocket

wss://api.xanguard.tech/v1/eca/ws?api_key=eca_your_key

Receives real-time JSON events when a token launch matches your watchlist criteria.

Engagement Tracker

Engagement Tracker (ET) monitors real-time engagement changes on specific tweets — likes, retweets, replies, quotes, and bookmarks. Real-time engagement change detection with zero-delay alerts. Managed via @E_Xanguard_bot.

Bot Commands

Pricing

API

Auth: Bearer token with et_ prefix.

Authorization: Bearer et_your_api_key_here

Engagement Response

{
  "ok": true,
  "data": {
    "tweet_id": "1234567890",
    "favorite_count": 42,
    "retweet_count": 10,
    "reply_count": 5,
    "quote_count": 2,
    "bookmark_count": 8,
    "last_updated": "2026-03-22T11:30:00Z"
  }
}

WebSocket

wss://api.xanguard.tech/v1/et/ws?api_key=et_your_key

Receives real-time JSON events when engagement counts change for any watched tweet.

Trending Alerts

Trending Alerts polls Twitter’s trending feed every 60 seconds across 24 categories and delivers new trending tweets to you in real time. Free tier gets 1 non-crypto category. Pro tier ($39/mo) unlocks all 24 categories. Managed via @Trends_Xanguard_bot.

Bot Commands

Pricing

API

Auth: Bearer token with trend_ prefix.

Authorization: Bearer trend_your_api_key_here

WebSocket

wss://api.xanguard.tech/v1/trending/ws?api_key=trend_your_key

Receives real-time JSON events when new trending tweets are detected in your subscribed categories.

PumpFun Livestream

PumpFun Livestream Tracker provides sub-second detection of pump.fun livestream starts and ends for monitored Solana wallets. Sub-second detection with zero cost per event. Managed via @PF_Xanguard_bot.

Bot Commands

Pricing

API

Auth: Bearer token with pf_ prefix.

Authorization: Bearer pf_your_api_key_here

Event Response

{
  "ok": true,
  "data": [
    {
      "wallet_address": "DYw8j...",
      "mint": "9PR3c...",
      "token_name": "BONK",
      "token_symbol": "BONK",
      "event_type": "livestream_started",
      "detected_at": "2026-03-22T10:15:00Z",
      "delivery_latency_ms": 450
    }
  ]
}

WebSocket

wss://api.xanguard.tech/v1/pf/ws?api_key=pf_your_key

Receives real-time JSON events when watched wallets start or stop livestreaming on pump.fun.

Search Alerts

Search Alerts monitors Twitter/X for keyword matches in real time. Add up to 20 keyword queries and receive alerts when new matching tweets appear. Configurable intervals from 10 minutes to 6 hours. An add-on for @Xanguard_bot — managed via the Add-ons menu.

Pricing

API

Auth: Bearer token with sa_ prefix, generated via the API Key button in the Search Alerts management screen.

Authorization: Bearer sa_your_api_key_here

Match Event

{
  "type": "search_alert",
  "data": {
    "query_id": 1,
    "query_text": "solana airdrop",
    "tweet_id": "1234567890",
    "full_text": "Massive Solana airdrop incoming...",
    "screen_name": "CryptoWhale",
    "display_name": "Crypto Whale"
  }
}

WebSocket

wss://api.xanguard.tech/v1/sa/ws?api_key=sa_your_key

Receives real-time JSON events when new tweets match your keyword queries.

Plans & Pricing

Choose a plan based on how many Twitter accounts you need to monitor and how many webhook endpoints you require. All paid plans include full access to the REST API, WebSocket streaming, and webhook delivery.

Payment

All payments are made in SOL on the Solana blockchain. Prices are displayed in USD and converted to SOL at the current market rate at the time of payment. To subscribe or upgrade, use the Telegram bot — send /start and select your plan.

What Every Plan Includes

• Real-time tweet detection (sub-second latency, typically 250-500ms)
• Telegram bot notifications with forum topic support
• REST API access (14 endpoints)
• WebSocket streaming
• Per-handle keyword filtering
• Contract address auto-detection (Solana and Ethereum)
• Notification filters (exclude replies, reposts, contracts only)
• Mute/unmute individual accounts

Support

Need help getting set up or have questions about the API? Reach out through any of these channels.