Skip to main content

Webhooks

Webhooks deliver real-time events to your server when market conditions match your criteria.
Webhooks are coming soon. This feature is currently in development and not yet available on the public API. Subscribe to our changelog for launch announcements.

Supported Events

Creating a Webhook

Verifying Webhook Signatures

Every webhook delivery includes a signature header for verification. Always verify signatures to ensure events are from VecTrade. Headers sent with each delivery:

Verification

Webhook Payload Format

Managing Webhooks

Best Practices

  1. Always verify signatures — Never trust unverified payloads
  2. Respond quickly — Return 2xx within 5 seconds; process asynchronously
  3. Handle duplicates — Use X-VQ-Webhook-Id for idempotency
  4. Implement retry tolerance — VecTrade retries failed deliveries 3 times
  5. Use HTTPS — Webhook URLs must use HTTPS
  6. Rotate secrets — Regenerate webhook secrets periodically