Submit a market order
Request an opening trade and receive the MT5 submission response.
What this operation does
Requires a verified account, trading enabled, and a valid Idempotency-Key. The service returns 400 if the header is missing or its format is invalid. Persist the key and body before submitting; then save the MT5 ID and query its result.Complete workflow
See the step-by-step guide and errors and their handling. Playground values are examples. Replace the account, symbol, volume, and price with valid data for your integration.Authorizations
Send the provider-issued token in the Authorization header using Bearer authentication.
Headers
Persisted key for this intent. Reuse the same key and body when retrying; use a new key for another opening or closing order.
16 - 128^[A-Za-z0-9._:-]{16,128}$"550e8400-e29b-41d4-a716-446655440000"
Body
Trading account login.
104205
MT5 symbol name.
1 - 32^[A-Za-z0-9._-]+$"EURUSD"
MT5 volume units: 100 = 0.01 lots; 10000 = 1 lot.
100
Order direction.
buy, sell "buy"
Legacy explicit price; send together with digits or omit both for automatic pricing.
x > 0Legacy price decimals; omit with price to use the symbol configuration.
0 <= x <= 10Order comment stored in MT5.
31Response
Successful Response
The response is of type Response Market Order Api V1 Orders Market Post · object.