Skip to main content
POST
Place a pending order
Requires a verified account, trading enabled, the endpoint scope, and Idempotency-Key. See types, prices, and examples and recovery.

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. Pending protection uses price as reference, or stop_limit_price for stop-limit. Modify orders or positions · MT5 volume units

Authorizations

Authorization
string
header
required

Send the provider-issued token in the Authorization header using Bearer authentication.

Headers

Idempotency-Key
string
required

Persisted key for this intent. Reuse the same key and body when retrying; use a new key for another trading intent, including a modification.

Required string length: 16 - 128
Pattern: ^[A-Za-z0-9._:-]{16,128}$
Example:

"550e8400-e29b-41d4-a716-446655440000"

Body

application/json
login
integer
required
Example:

104205

symbol
string
required
Required string length: 1 - 32
Pattern: ^[A-Za-z0-9._() -]+$
Example:

"EURUSD"

volume
integer
required

Integer MT5 units: 10000 = 1 lot, independent of contract size. Must match the symbol minimum, maximum and step.

Example:

100

order_type
enum<string>
required
Available options:
buy_limit,
sell_limit,
buy_stop,
sell_stop,
buy_stop_limit,
sell_stop_limit
price
number
required

Pending order price; activation price for stop-limit.

Example:

1.1

sl
number | null

Optional absolute Stop Loss price. Omit or send null to skip; 0 specifies no SL.

Required range: x >= 0
tp
number | null

Optional absolute Take Profit price. Omit or send null to skip; 0 specifies no TP.

Required range: x >= 0
stop_limit_price
number | null

Limit order price after activation; required only for stop-limit orders.

Required range: x > 0
comment
string
default:REST API
Maximum string length: 31

Response

Successful Response

The response is of type Response Pending Order Api V1 Orders Pending Post · object.