Introduction
Written for the engineer sitting down to integrate on a Friday afternoon — precise, lean, and opinionated about what matters. What an endpoint should do, which events you can subscribe to, and how to verify that a payload actually came from us.
The scope
This first volume is intentionally small — the goal is to answer the three questions every team has on day one, not to pad the page with generic API hand-waving.
Browse every public MT5 route, request schema, response envelope, and executable Scalar example from the generated OpenAPI spec.
Read the guideTrader and signal lifecycle events are pushed to your endpoint the moment they happen — no polling, no drift, no missed states.
Read the guideEvery delivery carries a signed header. POST signs the raw body; GET signs the canonical query string.
Read the guideFailed deliveries are retried with exponential backoff; anything that dies for good can be replayed by hand from the dashboard.
Read the guideOrientation
If you're wiring a receiver from scratch, take these in sequence — each page assumes the one before it.
First
Event names, configurable params, delivery semantics, and how retries are recorded. Five minutes end-to-end.
Next
Four receivers (Node, Python, PHP, Go) with the same three-step check. Copy, paste, verify.
Then
Create an endpoint, pick your event groups, and fire the first test — the delivery log tells you if your receiver is right.
Etiquette
Small conventions that make webhook receivers calm instead of flaky.
Return quickly.
Respond 2xx within a few seconds and push slow work — emails, DB writes, downstream calls — to your own background queue.
Verify the signed payload.
For POST, store the raw body before parsing. For GET, rebuild the canonical query string before checking the signature.
Deduplicate by event id.
We may retry. Treat every delivery as 'at least once' and idempotent on the X-Webhook-Event-Id header.
Log the headers.
When a delivery misbehaves, the signature header and your local clock are the first two things we'll ask about.