Place a pending order - Vexpro FX · Partners

POST

/

api

/

v1

/

orders

/

pending

Place a pending order

curl --request POST \
  --url https://api-trading.vexprofx.com/api/v1/orders/pending \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "login": 104205,
  "order_type": "buy_limit",
  "price": 1.09,
  "symbol": "EURUSD",
  "volume": 100
}
'

import requests

url = "https://api-trading.vexprofx.com/api/v1/orders/pending"

payload = {
    "login": 104205,
    "order_type": "buy_limit",
    "price": 1.09,
    "symbol": "EURUSD",
    "volume": 100
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    login: 104205,
    order_type: 'buy_limit',
    price: 1.09,
    symbol: 'EURUSD',
    volume: 100
  })
};

fetch('https://api-trading.vexprofx.com/api/v1/orders/pending', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{}

{
  "detail": "Invalid request"
}

Requires a verified account, trading enabled, the endpoint scope, and Idempotency-Key. See types, prices, and examples and recovery.

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 opening or closing order.

Required string length: 16 - 128

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

Example:

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

Body

application/json

Example:

104205

symbol

string

required

Required string length: 1 - 32

Pattern: ^[A-Za-z0-9._-]+$

Example:

"EURUSD"

volume

integer

required

MT5 volume units: 100 = 0.01 lots; 10000 = 1 lot.

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

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.

Place a pending order

curl --request POST \
  --url https://api-trading.vexprofx.com/api/v1/orders/pending \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "login": 104205,
  "order_type": "buy_limit",
  "price": 1.09,
  "symbol": "EURUSD",
  "volume": 100
}
'

import requests

url = "https://api-trading.vexprofx.com/api/v1/orders/pending"

payload = {
    "login": 104205,
    "order_type": "buy_limit",
    "price": 1.09,
    "symbol": "EURUSD",
    "volume": 100
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    login: 104205,
    order_type: 'buy_limit',
    price: 1.09,
    symbol: 'EURUSD',
    volume: 100
  })
};

fetch('https://api-trading.vexprofx.com/api/v1/orders/pending', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{}

{
  "detail": "Invalid request"
}