The Alerts endpoint lets you receive the same events as Struct’s webhooks (trader whale trades, PnL crossings, probability spikes, volume milestones, and more) pushed directly over a websocket connection instead of HTTP POSTs.This is useful when you want the low-latency push model of webhooks without having to host a public HTTP endpoint.
Perfect for In-App Alert Systems
Alerts are especially well-suited for building in-app notification systems on trading platforms, letting your users track specific wallets, listen for price spikes on markets they care about, get notified when volume milestones are hit, or follow whale activity in real time.Because subscriptions are scoped to a single connection, you can open a dedicated socket per logged-in user and dynamically subscribe and unsubscribe as they adjust their alert preferences, without touching any server-side webhook configuration.
Alerts use the same API key authentication as the Rooms endpoint. Subscriptions are ephemeral: they live only for the duration of the connection and are dropped on disconnect.
Subscribe to an alert type by sending a JSON message. The op and event fields identify the subscription; all filter fields are flat on the top level of the message.
Alerts are billed at 0.1 or 0.2 credits per delivered event depending on the event type, with a standard 1 credit connection hold on connect. See each alert’s page for its specific cost, or visit Pricing for details.
