TWITTER WEBSOCKET API

tweet to trade
in 200ms.

Real-time X/Twitter signals for your trading bots. No infrastructure to build.

Basic/Elite 1-day trial · Cancel anytime · Live in under 5 minutes

From connection to signal in three steps

01
Connect via WebSocket in minutes
Authenticate with your API key and open a WebSocket connection for a live tweet stream.
02
Live monitor Twitter/X accounts and keywords
Add handles and keyword filters to capture the signals that matter.
03
Receive enriched alerts instantly
Every alert includes OCR text, detected tokens, and live prices, so your bots trade before manual traders see the tweet.
Read the docs
Detect step icon
Detect
Tweet captured
Enrich step icon
Enrich
OCR + token + Polymarket detection
Deliver step icon
Deliver
WebSocket + Discord webhooks
Live feed junction icon
LIVE FEED
CONNECTED
TIMEACCOUNTSIGNALTYPELATENCYTIMESIGNALLATENCY
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 / 60savg 156ms
~200ms
MEDIAN DETECTION
99.9%
UPTIME SLA
1M+
SIGNALS / DAY
THE PROBLEM

Right now, you’re losing trades to latency.

Your scraper takes 2–5 seconds. Manual monitoring means you see tweets after the move. Every second of delay is alpha lost to faster desks.

  • ×Custom scrapers break when Twitter changes their markup
  • ×The official API costs $5,000/mo for enterprise access
  • ×Discord copy-traders see the same signals you do — at the same time
WITHOUT TWEETSTREAM
2-5s
Typical scraper latency
WITH TWEETSTREAM
~200ms
Median detection time

Pricing

Simple plans. Basic and Elite include a 1-day trial, upgrade or cancel anytime.

Basic
For small teams and individual researchers
$139/mo
billed annually
3 WebSocket connections
50 accounts
  • Included feature3 WebSocket connections for parallel filters and strategies
  • Included featureMonitor up to 50 X/Twitter accounts
  • Included featureTweets, replies, quote tweets, and retweets
  • Included featureKeyword filtering to see only alerts that match your tokens
  • Included featureAutomatic token, Polymarket, and screenshot text detection
Start 1-Day Trial
Enterprise
For large organizations with custom needs
Custom
Unlimited connections
Custom limits
  • Included featureUnlimited WebSocket Connections
  • Included featureCustom account monitoring limits
  • Included featureAll Elite features included
  • Included featureDedicated high-performance servers
  • Included featureMulti-user access with individual filters and tracked accounts
  • Included featureCustom API integrations
  • Included featureDedicated account manager
  • Included featurePremium support
  • Included featureService Level Agreement (SLA)
Contact Sales
Basic and Elite include a 1-day trial. Cancel anytime.

Features

Everything your trading stack needs, from tweet detection to trade execution.

Median server detection time is ~200ms

Detection time is measured on our servers from tweet timestamp to processing, so your trading bot or alert system reacts before manual traders see the post.

@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
OCR panel icon
OCR extraction arrow
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

Every detected token includes live pricing context, and alerts also include Polymarket market detection when relevant, with no second API call.

POLYMARKET EVENT
ETH > $4k by March
62%
connect.js
1
const ws = new WebSocket(
2
"wss://ws.tweetstream.io/ws",
3
["tweetstream.v1",
4
`tweetstream.auth.token.<API_KEY>`]
5
);
6
7
ws.onmessage = ({ data }) => {
8
const msg = JSON.parse(data);
9
// msg.op: "content" | "meta"
10
// msg.d: { tweetId, text, author,
11
// ocr?, detected?: { tokens } }
12
13
if (msg.d.detected?.tokens?.length) {
14
executeTrade(msg);
15
}
16
};

WebSocket API

Structured JSON delivered via WebSocket the instant a tracked account posts. 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
FeatureTWEETSTREAMTWITTER API V2CUSTOM SCRAPER
Setup time5 minutesDays-weeksWeeks
Latency~200ms1-5s2-10s
OCR detectionBuilt-inNoneBuild yourself
Token extractionBuilt-inNoneBuild yourself
PolymarketBuilt-inNoneNone
MaintenanceZeroAPI changesConstant
CostFrom $139/mo$5,000/mo+Engineering time

WHAT USERS SAY

Trusted by traders and developers who need speed.

Cut tweet-to-trade latency from 2+ seconds to ~200ms. Enrichment data means zero parsing.

David Park
Quantitative Trader

Replaced our custom scraping setup in a weekend. Now monitoring 500+ accounts with zero server maintenance.

James Chen
Crypto Developer

The OCR caught a contract address in a screenshot our old system missed. That single trade paid for a year of TweetStream.

Ryan Torres
Trading Firm Founder
FAQ

TweetStream Frequently Asked Questions

TweetStream is a real-time tweet stream API that delivers crypto-relevant X/Twitter alerts via WebSocket. It automatically detects tokens, extracts text from images using OCR, and enriches alerts with live prices. A Twitter API alternative built for traders, trading bots, and teams who need to act fast on social signals.

Basic is $199/month ($139/month annually) for 3 WebSocket connections and 50 monitored accounts. Elite is $499/month ($349/month annually) for 10 connections, 250 accounts, and full historical replay API access. Both include token detection, OCR, and Polymarket detection.

Yes. TweetStream offers WebSocket delivery with token detection, OCR, and price enrichment so you can act without building a streaming pipeline. See our full comparison and confirm X pricing in the X API docs.

Yes. Our OCR automatically extracts text from tweets' images - screenshots of charts, terminals, announcements. The extracted text is scanned for tokens and included in the alert payload.

Yes. The WebSocket API delivers structured JSON with detected tokens, prices, and contract addresses. See our quickstart guide for code examples in JavaScript, TypeScript, and Python.

No. TweetStream is an independent service built by Finite Technologies PTY LTD. We are not affiliated with, endorsed by, or sponsored by X/Twitter or any of its subsidiaries.

Median server detection time is around ~200ms for monitored accounts. We measure this as server receive time minus the tweet snowflake timestamp. End-to-end latency varies by your selected accounts, region, and market conditions. Additional details like quoted tweet content may arrive in a follow-up update message shortly after.

Want to try TweetStream?

Start your 1-day trial with full access. No commitment required - we'll help you wire the live feed into your terminals or bots.

Start 1-Day Trial

The fastest X/Twitter monitoring for traders and trading desks.

Twitter WebSocket API for Crypto Traders