Skip to main content
POST
/
orders
Error
A valid request URL is required to generate request examples
{
  "comment": "novosky",
  "magic": 20250101,
  "price_current": 95050,
  "price_open": 95000,
  "profit": 5,
  "sl": 94800,
  "swap": -0.12,
  "symbol": "BTCUSDc",
  "ticket": 123456789,
  "time": 1777879028,
  "tp": 95300,
  "type": 0,
  "volume": 0.01
}

Documentation Index

Fetch the complete documentation index at: https://docs.novosky.app/llms.txt

Use this file to discover all available pages before exploring further.

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:

"BTCUSDc"

​
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

​
sl
number

Stop loss price.

Example:

94800

​
stoplimit
number

Limit price for BUY_STOP_LIMIT / SELL_STOP_LIMIT orders.

​
tp
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

​
sl
number
Example:

94800

​
swap
number
Example:

-0.12

​
symbol
string
Example:

"BTCUSDc"

​
ticket
integer
Example:

123456789

​
time
integer

Position open time as Unix epoch.

Example:

1777879028

​
tp
number
Example:

95300

​
type
integer

0 = BUY, 1 = SELL.

Example:

0

​
volume
number
Example:

0.01