Vero OMS API

POST

https://api-gw.verolabs.co

api

orders

new

{refOrderID}

{accountID}

{symbol}

{orderSide}

{price}

{qty}

{orderType}

Đặt lệnh mới

curl --request POST \
  --url https://api-gw.verolabs.co/api/v1/orders/new/{refOrderID}/{accountID}/{symbol}/{orderSide}/{price}/{qty}/{orderType} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api-gw.verolabs.co/api/v1/orders/new/{refOrderID}/{accountID}/{symbol}/{orderSide}/{price}/{qty}/{orderType}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api-gw.verolabs.co/api/v1/orders/new/{refOrderID}/{accountID}/{symbol}/{orderSide}/{price}/{qty}/{orderType}"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api-gw.verolabs.co/api/v1/orders/new/{refOrderID}/{accountID}/{symbol}/{orderSide}/{price}/{qty}/{orderType}"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

using RestSharp;


var options = new RestClientOptions("https://api-gw.verolabs.co/api/v1/orders/new/{refOrderID}/{accountID}/{symbol}/{orderSide}/{price}/{qty}/{orderType}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

false

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api-gw.verolabs.co/api/v1/orders/new/{refOrderID}/{accountID}/{symbol}/{orderSide}/{price}/{qty}/{orderType}");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

{
  "isSuccess": true,
  "detail": "Order placed successfully",
  "data": "ORDER-V1StGXR8_Z5jdHi6B-myT"
}

{
  "error": "<string>",
  "message": "<string>",
  "detail": "<string>",
  "details": "<string>",
  "status": 123
}

{
  "error": "<string>",
  "message": "<string>",
  "detail": "<string>",
  "details": "<string>",
  "status": 123
}

{
  "error": "<string>",
  "message": "<string>",
  "detail": "<string>",
  "details": "<string>",
  "status": 123
}

{
  "error": "<string>",
  "message": "<string>",
  "detail": "<string>",
  "details": "<string>",
  "status": 123
}

Ủy quyền

Authorization

string

header

bắt buộc

Bearer token used for protected REST API requests.

Tham số đường dẫn

refOrderID

string

bắt buộc

Client-generated order reference used for tracking and duplicate detection.

accountID

string

bắt buộc

Mã tài khoản giao dịch. Người dùng đang đăng nhập phải có quyền truy cập tài khoản này.

symbol

string

bắt buộc

Mã chứng khoán/sản phẩm, ví dụ FPT hoặc VN30F1M.

orderSide

string

bắt buộc

Order side. Accepted values: B for buy, S for sell.

price

number

bắt buộc

Order price. For market-style orders, backend interpretation depends on orderType.

qty

integer<int64>

bắt buộc

Order quantity in shares/contracts/lots accepted by the broker.

orderType

string

bắt buộc

Order type. Common accepted values include LO, MTL, ATO, and ATC.

Phản hồi

Kết quả đặt lệnh thường.

Response đặt lệnh thường.

isSuccess

boolean

bắt buộc

Backend đã chấp nhận và gửi lệnh tới broker hay chưa.

detail

string

bắt buộc

Thông điệp kết quả. Thành công thường là "Order placed successfully"; lỗi chứa lý do reject/validation.

data

string

bắt buộc

System order id do service.orderapi sinh cho lệnh mới. Dùng id này cho API cancel, execution reports và đối chiếu order stream. Đây không phải external broker order id và cũng không phải refOrderID client gửi vào request.

Pattern: ^ORDER-

Ví dụ:

"ORDER-V1StGXR8_Z5jdHi6B-myT"

Hủy lệnhHủy lệnh thường, stop-loss hoặc bracket order theo mã lệnh

Đặt lệnh mới

curl --request POST \
  --url https://api-gw.verolabs.co/api/v1/orders/new/{refOrderID}/{accountID}/{symbol}/{orderSide}/{price}/{qty}/{orderType} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api-gw.verolabs.co/api/v1/orders/new/{refOrderID}/{accountID}/{symbol}/{orderSide}/{price}/{qty}/{orderType}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api-gw.verolabs.co/api/v1/orders/new/{refOrderID}/{accountID}/{symbol}/{orderSide}/{price}/{qty}/{orderType}"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api-gw.verolabs.co/api/v1/orders/new/{refOrderID}/{accountID}/{symbol}/{orderSide}/{price}/{qty}/{orderType}"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

using RestSharp;


var options = new RestClientOptions("https://api-gw.verolabs.co/api/v1/orders/new/{refOrderID}/{accountID}/{symbol}/{orderSide}/{price}/{qty}/{orderType}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

false

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_WRITEDATA, stdout);
curl_easy_setopt(hnd, CURLOPT_URL, "https://api-gw.verolabs.co/api/v1/orders/new/{refOrderID}/{accountID}/{symbol}/{orderSide}/{price}/{qty}/{orderType}");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer <token>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

{
  "isSuccess": true,
  "detail": "Order placed successfully",
  "data": "ORDER-V1StGXR8_Z5jdHi6B-myT"
}

{
  "error": "<string>",
  "message": "<string>",
  "detail": "<string>",
  "details": "<string>",
  "status": 123
}

{
  "error": "<string>",
  "message": "<string>",
  "detail": "<string>",
  "details": "<string>",
  "status": 123
}

{
  "error": "<string>",
  "message": "<string>",
  "detail": "<string>",
  "details": "<string>",
  "status": 123
}

{
  "error": "<string>",
  "message": "<string>",
  "detail": "<string>",
  "details": "<string>",
  "status": 123
}

Tổng quan

REST API

Streaming API

Tích hợp

Hỗ trợ

Đặt lệnh mới

Ủy quyền

Tham số đường dẫn

Phản hồi