TWITTER WEBSOCKET API

Catch the alphabefore the candle prints.

~200ms WebSocket alerts your bot can trade — posts, profile moves, tokens, OCR, and live price attached.

Start 3-Day Trial Read the WebSocket docs →

3-day trial · Cancel anytime · 5 accounts · 1 connection during trial

From monitored post to routed alert in three steps

Connect your live feed in minutes

Authenticate with your API key and open a WebSocket connection. No custom streaming pipeline required.

Track the accounts that move your market

Add handles and keyword filters so you only see tweets that can actually move price.

Route alerts into your decision layer

Alerts can include post/account changes, OCR text, detected tokens, and live prices, so bots can run risk checks on structured payloads.

Read the docs →

Detect

Tweet captured

Enrich

Deletes, pins, follows + OCR + token + Polymarket detection

Deliver

WebSocket + Discord webhooks

LIVE FEED

CONNECTED

TIMEACCOUNTSIGNALTYPEDETECTIONTIMESIGNALDETECTION

14:32:01@CryptoKaleoWatching SOL reclaim 178.8 after NY open. Clear if BTC holds.NEWS143ms14:32:01@CryptoKaleo · Watching SOL reclaim 178.8 after NY open. Clear if BTC holds.143ms

14:31:58@Trader_XOIf 68.4k flips, I add. If not, still range trading for now.NEWS187ms14:31:58@Trader_XO · If 68.4k flips, I add. If not, still range trading for now.187ms

14:31:44@HsakaTradesETH perps funding cooling off while spot bids keep stepping in.TOKEN112ms14:31:44@HsakaTrades · ETH perps funding cooling off while spot bids keep stepping in.112ms

14:31:31@inversebrahChart screenshot posted. OCR pulled contract: 7Yf2...9nqP (SOL).OCR196ms14:31:31@inversebrah · Chart screenshot posted. OCR pulled contract: 7Yf2...9nqP (SOL).196ms

14:31:15@GCRClassicPolymarket market detected: ETH > $4k by Mar. Odds now 62%.POLY158ms14:31:15@GCRClassic · Polymarket market detected: ETH > $4k by Mar. Odds now 62%.158ms

8 signals / 60s~200ms p50 server detection▮

~200ms

DETECTION

WEBSOCKET CONNECTIONS

250

TRACKED ACCOUNTS

THE PROBLEM

Right now, you're reading the post after the move.

Polling endpoints and scrapers trail the timeline by seconds. TweetStream pushes monitored posts, deletes, pins, profile moves, follows, tokens, OCR, and price over WebSocket in ~200ms.

×Custom scrapers depend on X's private GraphQL — slow, rate-limited, breaks on rotation
×Official X API is pay-per-use — caps and stream engineering still on you
×Raw posts still need delete/pin handling, profile/follow handling, token, OCR, price, filter, and routing logic

WITHOUT TWEETSTREAM

Seconds late

Polled endpoints, scrapers, and manual feeds trail the timeline

WITH TWEETSTREAM

~200ms

Most monitored posts detected on our servers (p50)

Pricing

Choose the edge that fits your trading speed. Start the 3-day trial, wire it into your stack, and cancel anytime.

Basic

For solo traders and small teams

$139/mo

billed annually

3 WebSocket connections

Up to 50

3 WebSocket connections for parallel filters and strategies
Monitor up to 50 X/Twitter accounts
Follow and unfollow notifications when available
Tweets, replies, quote tweets, retweets, and updates
Delete, pin, and unpin events when observed
Profile-change notifications when available
Donald Trump Truth Social notifications
Keyword filtering to see only alerts that match your tokens
Automatic token, OCR, prediction-market, and live price enrichment

Start 3-Day Trial

POPULAR CHOICE

Elite

For traders who cannot afford to miss market-moving tweets

$349/mo

billed annually

10 WebSocket connections

Up to 250

10 WebSocket connections for parallel filters and strategies
Monitor up to 250 X/Twitter accounts
Follow and unfollow notifications when available
Real-time tweets, replies, quote tweets, retweets, and updates
Delete, pin, and unpin events when observed
Profile-change notifications when available
Donald Trump Truth Social notifications
Historical replay API to backtest signals or replay missed alerts
Keyword filtering to see only alerts that match your tokens
Automatic token, OCR, prediction-market, and live price enrichment

Start 3-Day Trial

Enterprise

For large organizations with custom needs

Custom

Unlimited connections

Custom

Unlimited WebSocket Connections
Custom account monitoring limits
All Elite features included
Dedicated high-performance servers
Multi-user access with individual filters and tracked accounts
Custom API integrations
Dedicated account manager
Premium support
Commercial support terms

Contact Sales

Basic and Elite include a 3-day trial. Enterprise uses custom onboarding.

Features

Everything your alert stack needs, from monitored-account detection to structured routing.

Most monitored tweets detected in about 200ms

Monitor posts, account-change alerts, and optional Trump Truth Social posts. Speed is measured on TweetStream servers from production database timestamps.

@CryptoKaleo: SOL reclaiming 178.8 after open143ms

@Trader_XO: BTC 68.4k level still key for trend187ms

@HsakaTrades: ETH perps cooling while spot bids hold112ms

0x7a250d...Contract detectedToken: $PEPE

OCR reads contract addresses from screenshots

When an influencer posts a chart screenshot, OCR extracts tickers and addresses - so you catch alpha others miss.

Tokens arrive with live prices

Detected tokens include live pricing context when available, and alerts can include Polymarket market detection when relevant, with no second API call.

POLYMARKET EVENT

ETH > $4k by March

62%

connect.js

const ws = new WebSocket(

  "wss://ws.tweetstream.io/ws",

  ["tweetstream.v1",

   `tweetstream.auth.token.<API_KEY>`]

);

ws.onmessage = ({ data }) => {

  const msg = JSON.parse(data);

  // Route by msg.t and msg.op.

  // msg.d: { tweetId, text, author,

  //   ocr?, detected?: { tokens } }

  if (msg.op === "meta" && msg.d.detected?.tokens?.length) {

    routeToStrategy(msg);

}

};

WebSocket API

Structured JSON delivered via WebSocket when a tracked account posts, edits context, deletes, pins, unpins, follows, unfollows, or changes profile fields. Integrate with your trading bot, Discord webhook integrations, or analytics pipeline in minutes.

Historical Replay API

Replay previously delivered alerts for research and model evaluation. Query by account, token, or time range to backtest and audit signal quality.

GET /api/history?handle=CryptoKaleo

{
"tweetId": "18723...",
"body": "$SOL breakout",
"time": "2024-01-15T...",
"meta": { "tokens": [...] }
}

COMPARE

TweetStream vs. the alternatives

Comparison of TweetStream, Twitter API v2, and custom scraper solutions
Feature	TWEETSTREAM	TWITTER API V2	CUSTOM SCRAPER
Setup time	5 minutes	Days-weeks	Weeks
Latency	About 200ms on our servers	~6-7s p99 docs	2-10s typical
OCR detection	Built-in	None	Build yourself
Token extraction	Built-in	None	Build yourself
Polymarket	Built-in	None	None
Maintenance	Managed	API changes	Constant
Cost	From $139/mo	Metered or custom	Engineering time

TweetStream speed is p50 server detection (server receive time minus tweet snowflake timestamp). End-to-end delivery varies. X API latency and pricing should be confirmed in your own Developer Console.

WHAT TO TEST IN TRIAL

Use the trial to verify timing, payload shape, and routing with the accounts you monitor.

Latency

Time detection on your watchlist

Connect a trial key and compare arrival time against your current feed.

Payload

Wire the stream into your stack

Inspect WebSocket payloads and reconnects, then route alerts into your bot, terminal, or Discord.

Enrichment

See OCR and tokens fire on real posts

Watch post alerts, account-change alerts, contract OCR, token detection, and live price context land from your monitored accounts.

FAQ

TweetStream Frequently Asked Questions

What is TweetStream?+

How much does TweetStream cost?+

Is TweetStream a good X/Twitter API alternative?+

Can TweetStream read text from images?+

Can I integrate TweetStream with my trading bot?+

Is TweetStream affiliated with X/Twitter?+

How fast is TweetStream?+

Catch signals before the crowd does

Start your 3-day trial and plug the live feed into your bot, terminal, or Discord in minutes.

Start 3-Day Trial

Focused X/Twitter monitoring for traders and trading desks.

All systems operational