Skip to main content
Webhooks let you stream Gigabrain-generated market intelligence into your own automation stack. Configure endpoints in the dashboard at Profile -> Integrations -> Webhooks. Alpha trade signals are the primary event and are selected by default. Add Radar insights when you also want earlier market context.

Alpha

Primary event selected by default. Sends alpha.created trade signals. Costs 0.5 credits per real delivery.

Radar

Optional upstream context. Sends radar.created insights. Costs 0.1 credits per real delivery.
Test deliveries from the dashboard are free. Real deliveries are charged once before the webhook request is sent.

Delivery Model

Gigabrain sends webhook requests from the backend webhook worker. Internal Python service IPs are not exposed to your endpoint. Each request uses this envelope:

Headers

Every webhook request includes:

Verify Signatures (Optional)

Signature verification is optional, but recommended before trusting or processing webhook payloads. Store the signing secret when you create the webhook. It is shown only once. The signature is HMAC_SHA256(secret, timestamp + "." + raw_body).
Verify against the raw request body before JSON parsing. Re-stringifying parsed JSON can change whitespace or key ordering and break signature checks.

Alpha Payload

Alpha events are created when an Alpha trade signal is generated. The payload contains the same trade setup fields shown in the Gigabrain UI.

Radar Payload

Radar events are created when a Radar insight is generated. The payload contains the same insight fields shown in the Gigabrain UI.

Retries and Billing

  • Treat any 2xx response as success.
  • Timeouts and non-2xx responses are retried up to 3 attempts with exponential backoff.
  • Your endpoint has 10 seconds to respond.
  • Real deliveries are charged before the request is sent.
  • If the account has insufficient credits, the delivery is marked failed and your endpoint is not called.
  • Retries reuse the same delivery id and do not double-charge.
  • Duplicate source events are deduped per webhook, event type, and resource id.
Return quickly, then process asynchronously: