X/Twitter Monitor API
A WebSocket feed for the X/Twitter accounts your desk watches: tweets, updates, deletes, pins, unpins, profile changes, follows, unfollows, token detection, OCR, and live price context.
Monitor market-moving X/Twitter accounts without polling
TweetStream streams selected-account alerts over one WebSocket connection. Most monitored tweets are detected in about 200ms on our servers, then sent with the fields your bot or desk needs to act.
- Connect to wss://ws.tweetstream.io/ws with one API key
- Track the handles that move your market instead of scraping broad search results
- Receive tweet content, updates, deletes, pins, unpins, profile changes, follows, unfollows, OCR, token detection, and price context when available
What the WebSocket feed includes
TweetStream is not the official X API and it is not a general social listening suite. It is a focused monitor API for selected accounts and trading workflows.
Tweet alerts that catch the state change
Stream new posts, updates, deletes, pins, and unpins from the accounts in your watchlist, including author fields, media, links, and quote or reply context when available.
Account profile and follow events
Use account event envelopes for profile updates, follow notifications, and unfollow notifications instead of building a separate account-monitoring job.
Trading enrichment
OCR, token detection, exchange references, prediction-market detection, and live price context are attached when TweetStream detects a signal.
A practical WebSocket protocol
Every message uses the same envelope shape, so bots can route tweet, account, and control events without custom parsing for each feature.
Why teams use TweetStream as a Twitter monitor API
- No polling loop to tune, babysit, or rebuild when traffic spikes
- About 200ms server-side detection for most monitored tweets
- Crypto-specific enrichment your team would otherwise build after ingest
- Flat monitored-account limits instead of metered reads for every workflow
Built for the monitored-account workflow
Most crypto teams do not need every public post. They need the small set of accounts that moves price to reach their systems quickly and cleanly.
- Pick the handles. Add the accounts your desk, bot, or Discord channel already watches.
- Open one socket. Authenticate once and receive live JSON envelopes for tweet, account, and control events.
- Route the signal. Send alerts into trading logic, dashboards, Discord, or history replay without maintaining a scraper stack.
Open the WebSocket in minutes
You only need the endpoint and protocols:
WebSocket endpoint: wss://ws.tweetstream.io/ws
Protocols: tweetstream.v1, tweetstream.auth.token.YOUR_API_KEY
See the WebSocket quickstart guide for full examples.
Where this fits
Use TweetStream when speed, payload shape, and enrichment matter more than broad social listening. If you need official write access, compliance archives, or every X API endpoint, use the official X API alongside TweetStream.
X/Twitter monitor API questions
Is TweetStream the official X/Twitter API?
No. TweetStream is an independent monitored-account alert API. It is built for teams that need fast WebSocket delivery and trading enrichment from selected X/Twitter accounts.
Is this a WebSocket firehose for every public tweet?
No. TweetStream streams alerts from the accounts and filters you configure. That keeps the feed focused and avoids forcing your bot to process broad social noise.
What events can I receive over WebSocket?
TweetStream sends tweet content, tweet metadata, tweet updates, delete, pin, and unpin operations where available, account profile updates, follow and unfollow events, and control responses for handle-management actions.
Why use TweetStream instead of polling?
Polling adds delay, retry logic, rate-limit handling, and parsing work. TweetStream keeps one WebSocket connection open and pushes monitored-account events as they arrive.
Ready to start streaming?
Start 3-Day TrialStart real-time Twitter WebSocket alerts today
WebSocket delivery, OCR, and token detection - no infrastructure to build.
Start 3-Day TrialFrom $199/mo · Basic/Elite 3-day trial · OCR + token detection included