# Webhooks

HTTP push for every onchain event, across every chain. Subscribe your server to 20+ event types spanning EVM and SVM (trader activity, price and volume moves, market and token lifecycle, metric thresholds, and asset prices) with HMAC-signed, at-least-once delivery.

## HTTP push for every onchain event, across every chain

- **One endpoint, every chain**: Register a single subscription and receive events from every chain Struct indexes, EVM and SVM alike, in one unified shape. No per-network integration to build or maintain. Unified event model, EVM and SVM coverage, one subscription.
- **Every onchain signal**: One subscription spans 20+ event types: trader flow, price moves, market lifecycle, and metric thresholds, all routed to your endpoint.
- **Millisecond latency**: Deliveries leave the moment data lands onchain. No polling intervals, no cache windows, no waiting on your endpoint to ask.

## Every onchain event, routed to your server

Trader flow, price and volume moves, market lifecycle, and aggregated metrics. Subscribe only to the categories your system needs, across any chain.

- **Trader Activity**: Fire on whale trades, first trades from tracked wallets, and per-wallet PnL crossings. Filter by address, size, or market on any chain.
- **Price & Volume Moves**: Detect sudden price moves and volume surges on any market, token, or tag, with pre-aggregated deltas and no client-side math.
- **Markets & Tokens**: Track new markets and tokens as they launch, plus every status change through their lifecycle. Filter by tag, category, or status across chains.
- **Metrics & Thresholds**: Threshold crossings on aggregated metrics: volume, liquidity, open interest, and transaction counts across markets, tokens, and wallets.

Explore the full API reference: https://docs.struct.to

## One event stream, everything you build on top

From consumer notifications to autonomous trading systems, the same signed events power it all, on every chain.

- **Notifications & Alerts**: Push user-facing alerts the instant something moves: whale trades, price swings, and volume milestones, straight from the chain to your app. Real-time alerts, threshold triggers, any chain on one feed.
- **Backend Automation**: Wire events directly into trading bots and backend jobs. React to onchain signals without polling, and let signed payloads drive your automation. Trading bots, event-driven jobs, no polling loops.
- **AI Agents**: Feed live onchain events straight into autonomous agents so they can monitor, research, and trade as signals fire, wherever they trade, without polling for state. React to live signals, monitor and trade, any chain on one feed.

## Everything the platform gives you

The delivery infrastructure behind production trading systems, exposed as webhooks.

- **HMAC-signed delivery**: Every payload is signed with your subscription secret so you can verify authenticity in one line.
- **At-least-once delivery**: Failed deliveries retry with exponential backoff until they land, so no event is silently dropped.
- **Granular filters**: Scope by chain, wallet, market, tag, or category, with thresholds set per subscription server-side.
- **Sub-second delivery**: Events fire the moment they land onchain. No polling intervals, no cache windows, no waiting.
- **Unified multi-chain coverage**: One event model across every chain Struct indexes, EVM and SVM, with no per-network integration.
- **No infra to run**: No queues, workers, or indexers to operate. Register an endpoint and Struct handles delivery.

## Frequently asked questions

### How do I get started with webhooks?

Create a free account, generate an API key, and register a subscription pointing at your HTTPS endpoint. Pick the event types you care about, add any filters, and Struct starts pushing signed payloads the moment matching events land onchain. The documentation walks through registration, filtering, and signature verification, and the TypeScript SDK gives you typed subscription helpers.

### What do webhooks cover?

The self-serve webhooks are Polymarket. You subscribe once and receive the same event shapes for every market, trade, and trader. Need other chains or protocols? That is an engagement. We stand up the feed with your team: https://www.struct.to/apps

### What event types can I subscribe to?

Over 20 event types spanning trader activity and PnL crossings, price and volume moves, metric thresholds, market and token lifecycle changes, wallet and balance events, and asset prices. Subscribe only to the categories your system needs and ignore the rest.

### How fast are events delivered?

Events fire the moment matching activity lands onchain. There is no polling loop or cache window between the chain and your endpoint, so most deliveries reach your server sub-second across every supported chain.

### What delivery guarantees do I get?

Delivery is at-least-once. If your endpoint is unreachable or returns an error, Struct retries with exponential backoff until it succeeds or the retry window is exhausted. Design handlers to be idempotent so an occasional duplicate is harmless.

### How granular is the filtering?

Filters run server-side, so you only receive the events you asked for. Scope subscriptions by chain, wallet address, market, token, tag, or category, and set thresholds like whale-trade size, price move, volume milestone, or PnL crossing per subscription.

### Where can I find the full webhook reference?

Every event type, payload schema, and callback shape is documented in the API reference. It covers registration parameters, filter options, retry behavior, and the signature scheme.

### How do I verify a payload is authentic?

Every payload is signed with an HMAC using your subscription secret. Recompute the signature over the raw request body and compare it against the header in one line of middleware. Reject any request whose signature does not match to block tampered or spoofed deliveries.

### How are webhooks billed?

Every plan includes a monthly allowance of webhook deliveries and a cap on active subscriptions. There is no separate infrastructure to run, so you only pay for delivered events. See the pricing page for plan details.

## Learn more

- [REST API](https://www.struct.to/rest-api)
- [WebSockets](https://www.struct.to/websockets)
- [Pricing](https://www.struct.to/pricing)
- [Documentation](https://docs.struct.to)
- [API reference](https://docs.struct.to/api-reference)
- [TypeScript SDK](https://docs.struct.to/sdk/getting-started)