Place a new order

{ "comment": "novosky", "magic": 20250101, "price_current": 95050, "price_open": 95000, "profit": 5, "sl": 94800, "swap": -0.12, "symbol": "BTCUSD", "ticket": 123456789, "time": 1777879028, "tp": 95300, "type": 0, "volume": 0.01 }

{ "comment": "novosky", "magic": 20250101, "price_open": 94500, "sl": 94300, "symbol": "BTCUSD", "ticket": 987654321, "time_setup": 1777879028, "tp": 94800, "type": 2, "volume_current": 0.01 }

Authorizations

Authorization

string

header

required

Set API_TOKEN in .env to match the token configured on the server.

Body

application/json

Request body for placing a new order.

symbol

string

required

Example:

"BTCUSD"

type

enum<string>

required

Order type. The bot only uses BUY and SELL; the rest are available for manual use.

Available options:

BUY,

SELL,

BUY_LIMIT,

SELL_LIMIT,

BUY_STOP,

SELL_STOP,

BUY_STOP_LIMIT,

SELL_STOP_LIMIT

Example:

"BUY"

volume

number

required

Lot size.

Example:

0.01

comment

string

Example:

"novosky"

deviation

integer

Max allowed price deviation in points.

Example:

20

expiration

integer

Expiry time as Unix epoch (for SPECIFIED type_time).

magic

integer

EA magic number for trade identification.

Example:

20250101

price

number

Order price (required for limit/stop orders).

Example:

95000

number

Stop loss price.

Example:

94800

stoplimit

number

Limit price for BUY_STOP_LIMIT / SELL_STOP_LIMIT orders.

number

Take profit price.

Example:

95300

type_time

string

Order expiry type: GTC, TODAY, SPECIFIED, SPECIFIED_DAY.

Example:

"GTC"

Response

Order filled — open position returned

An open position.

comment

string

Example:

"novosky"

magic

integer

EA magic number.

Example:

20250101

price_current

number

Example:

95050

price_open

number

Example:

95000

profit

number

Floating profit in account currency.

Example:

5

number

Example:

94800

swap

number

Example:

-0.12

symbol

string

Example:

"BTCUSD"

ticket

integer

Example:

123456789

time

integer

Position open time as Unix epoch.

Example:

1777879028

number

Example:

95300

type

integer

0 = BUY, 1 = SELL.

Example:

0

volume

number

Example:

0.01

Overview

Account

System

History

Orders

Positions

Symbols

Terminal

Time

Authorizations

Body

Response