Webhooks
Webhooks deliver real-time events to your server when market conditions match your criteria.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
- Always verify signatures — Never trust unverified payloads
- Respond quickly — Return 2xx within 5 seconds; process asynchronously
- Handle duplicates — Use
X-VQ-Webhook-Idfor idempotency - Implement retry tolerance — VecTrade retries failed deliveries 3 times
- Use HTTPS — Webhook URLs must use HTTPS
- Rotate secrets — Regenerate webhook secrets periodically