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.Optional SL and TP
sl and tp are absolute prices. Send either or both when opening; omitted or
null values are not sent, and 0 specifies no level. Precision and distances
are validated; invalid prices are not rounded.
Buy protection is checked against Bid; sell protection against Ask.
Modify orders or positions · MT5 volume unitsAuthorizations
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 trading intent, including a modification.
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"
Integer MT5 units: 10000 = 1 lot, independent of contract size. Must match the symbol minimum, maximum and step.
100
Order direction.
buy, sell "buy"
Optional absolute Stop Loss price. Omit or send null to skip; 0 specifies no SL.
x >= 0Optional absolute Take Profit price. Omit or send null to skip; 0 specifies no TP.
x >= 0Legacy 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.

