WebSocket Integration
Complete guide on our WebSocket Integration
This guide walks you through how to create and deploy a custom WebSocket server that works seamlessly with Stellar. This feature allows external monitoring servers to push real-time product data directly into the bot — giving Stellar users faster and more customized alerts.
It’s perfect for cook groups, monitor providers or developers who want to power Stellar’s WebSocket tab with their own monitoring.
What is Stellar’s WebSocket Feature?
Stellar users can now connect to external WebSocket servers via a dedicated field in the Settings tab. These servers act just like Stellar’s in-house server-side monitor — providing fast and reliable product pings for supported modules.
This gives you the power to:
Run your own monitors and deliver custom product pings to users
Monetize or enhance your group offerings with Stellar-compatible support
Push lightning-fast restock info from your own backends into Stellar tasks
How Does It Work?
When you add your WebSocket server in your bot settings, Stellar connects to your endpoint (ws://
or wss://
) and begins listening for product restock pings in real time.
Your server should:
Accept connections from authenticated Stellar users
Broadcast product pings to all connected users in Stellar’s accepted format
Optionally restrict or track key usage (for private servers)

How Do I Build a Compatible WebSocket Server?
You can use any backend language or framework as long as it:
Accepts WebSocket traffic (port 80 for
ws://
, or 443 forwss://
via reverse proxy like NGINX)Sends properly formatted stringified JSON payloads
Authenticates users by API key (via query string)
We recommend building with Node.js, Python, Go, or Rust for ease of development and scale — but any language that supports WebSocket libraries will work.
Websocket Format
Amazon Format
Required for Amazon connections:
region
,sku
, andofferId
are requiredproductImage
must be a valid URLproductPrice
must be a stringSupported Regions:
['USA', 'CA', 'UK', 'NL', 'FR', 'IT', 'DE', 'JP', 'ES', 'BE', 'PL', 'AU']
{
"site": "amazon",
"region": "US",
"sku": "B09MQ5L5N9",
"offerId": "OID",
"details": {
"productTitle": "Amazon Test",
"productImage": "https://www.image.com/",
"productPrice": "199.99"
}
}
All Other Sites
sku
is always requiredofferId
is only used for Walmart US/CAproductImage
must be a valid URLproductPrice
must be a string
{
"site": "exactly like in task creator",
"sku": "SKU required",
"offerId": "only Walmart US/CA",
"details": {
"productTitle": "Example Product",
"productImage": "https://www.image.com/",
"productPrice": "199.99"
}
}
Due to the number of supported sites, not all have been individually tested — we strongly recommend testing your WebSocket with an in-stock item and if detection doesn’t work, open a ticket and we'll tag the dev team.
Last updated
Was this helpful?