Dữ liệu streaming

Cập nhật trạng thái lệnh/vị thế phái sinh thời gian thực

1. Order Event

Thông tin streaming cập nhật trạng thái lệnh về đặt/ hủy/ sửa lệnh bao gồm những thông tin sau:

Tên trường	Kiểu dữ liệu	Mô tả
type	string	Tên event: orderEvent
uniqueID	string
prefix	string
ipAddress	string	Được xác định yêu cầu từ Client
notifyID	string	Số serrial của msg
orderID	string
instrumentID	string	Mã chứng khoán
buySell	string	buy (B): mua/Sell (S): bán đã đặt theo orderID của lệnh B: Buy S: Sell
orderType	string	Loại lệnh: LO\|ATO\|ATC\|MP\|MTL\|MOK\|MAK\|PLO
price	number	Giá
quantity	number	Khối lượng
marketID	string	Sàn: VN: thị trường cơ sở VNFE: thị trường phái sinh
origRequestID	string
account	string	Số tài khoản
cancelQty	number	Tổng khối lượng đã hủy
osqty	number	Tổng khối lượng chưa khớp
filledQty	number	Tổng khối lượng khớp
avgPrice	number	Giá trung bình
channel	string	Kênh đặt lệnh
inputTime	string	Unixtime
modifiedTime	string	Unixtime
isForceSell	Boolean
orderStatus	Boolean	Trạng thái lệnh: WA: Chờ duyệt RS: Chờ gửi SD: Đã gửi QU: Chờ khớp FF: Đã khớp PF: Khớp 1 phần FFPC: Khớp 1 phần hủy phần còn lại WM: Chờ sửa WC: Chờ hủy CL: Đã hủy RJ: Từ chối EX: Hết hiệu lực SOR: Chờ kích hoạt SOS: Đã kích hoạt IAV: Lệnh trước phiên SOI: Lệnh điều kiện trước phiên
origOrderID	string
rejectReason	string
stopOrder	string	Loại lệnh: True: Đối với lệnh điều kiện False: Đối với lệnh thường
stopType	string	Loại điều kiện. Bắt buộc nhập nếu stopType = true - D: Down - U: Up - V: Trailling Up - E: Trailing Down - O: OCO - B: BullBear
stopStep	number
stopPrice	number
profitPrice	number

Tên trường

Kiểu dữ liệu

Mô tả

type

string

Tên event: orderEvent

uniqueID

string

prefix

string

ipAddress

string

Được xác định yêu cầu từ Client

notifyID

string

Số serrial của msg

orderID

string

instrumentID

string

Mã chứng khoán

buySell

string

buy (B): mua/Sell (S): bán đã đặt theo orderID của lệnh

B: Buy

S: Sell

orderType

string

Loại lệnh:

LO|ATO|ATC|MP|MTL|MOK|MAK|PLO

price

number

Giá

quantity

number

Khối lượng

marketID

string

Sàn:

VN: thị trường cơ sở

VNFE: thị trường phái sinh

origRequestID

string

account

string

Số tài khoản

cancelQty

number

Tổng khối lượng đã hủy

osqty

number

Tổng khối lượng chưa khớp

filledQty

number

Tổng khối lượng khớp

avgPrice

number

Giá trung bình

channel

string

Kênh đặt lệnh

inputTime

string

Unixtime

modifiedTime

string

Unixtime

isForceSell

Boolean

orderStatus

Boolean

Trạng thái lệnh: WA: Chờ duyệt

RS: Chờ gửi

SD: Đã gửi

QU: Chờ khớp

FF: Đã khớp

PF: Khớp 1 phần

FFPC: Khớp 1 phần hủy phần còn lại

WM: Chờ sửa

WC: Chờ hủy

CL: Đã hủy

RJ: Từ chối

EX: Hết hiệu lực

SOR: Chờ kích hoạt

SOS: Đã kích hoạt

IAV: Lệnh trước phiên

SOI: Lệnh điều kiện trước phiên

origOrderID

string

rejectReason

string

stopOrder

string

Loại lệnh:

True: Đối với lệnh điều kiện

False: Đối với lệnh thường

stopType

string

Loại điều kiện. Bắt buộc nhập nếu stopType = true

- D: Down

- U: Up

- V: Trailling Up

- E: Trailing Down

- O: OCO

- B: BullBear

stopStep

number

stopPrice

number

profitPrice

number

Ví dụ:

Streaming đặt lệnh thành công

{ 
instrumentID: "SSI",
market: "VN",
buySell: "B",
orderType: "LO",
channelID: "IW",
price: 21000,
quantity: 300,
account: "0901351",
stopOrder: false,
stopPrice: 0,
stopType: "string",
stopStep: 0,
lossStep: 0,
profitStep: 0
requestID: "1678195",
code: “123456789”,
deviceID: "MAC Address",
userAgent: “FCTrading”
 }

{
"type":"orderEvent",
"data": {
"orderID":"12663204",
"notifyID":10, 
“instrumentID":"VN30F2106",
"uniqueID":"30304045",
"buySell":"B",
“orderType":"LO",
"ipAddress":"192.168.202.36",
"price":1410,"prefix":"2mw",
"quantity":10,
"marketID":"VNFE",
"origOrderId":"",
"account":"0901358",
"cancelQty":0,"osQty":10,
"filledQty":0,
"avgPrice":0,
"channel":"TA",
"inputTime":"1606277281849",
"modifiedTime":"1606277281850",
"isForceSell":"F",
"isShortSell":"F",
"orderStatus":"RS",
"rejectReason":"",
"origRequestID":"30304045",
"stopOrder":false,
"stopPrice":0,
"stopType":"",
"stopStep":0,
"profitPrice":0
}
}

Streaming đặt lệnh không thành công

{ 
instrumentID: "SSI",
market: "VN",
buySell: "B",
orderType: "LO",
channelID: "IW",
price: 1600,
quantity: 300,
account: "0901351",
stopOrder: false,
stopPrice: 0,
stopType: "string",
stopStep: 0,
lossStep: 0,
profitStep: 0
requestID: "1678195",
code: “123456789”,
deviceID: "MAC Address",
userAgent: “FCTrading”
 }

{
  "type": "orderError",
  "data": {
    "message": "Price 1,600.00 exceeds ceiling price 808.50!",
    "notifyID": 15455,
    "data": null,
    "errorCode": "ERR500",
    "uniqueID": "02365132",
    "connectionID": "",
    "ipAddress": "192.168.202.87",
    "prefix": "23o"
  }
}

Streaming về sửa lệnh thành công

{
requestID: "93235974",
orderID: "12658867",
price: 1410,
quantity: 2,
account: "0901358",
instrumentID: "VN30F2106",
marketID: "VNFE",
buySell: "B",
orderType: "LO"
code:”123456789”,
deviceID: "MAC Address",
userAgent: “FCTrading”
}son

{
"type":"orderEvent",
"data": {
"orderID":"12663204",
"notifyID":11,
"instrumentID":"VN30F2106",
"uniqueID":"31618366",
"buySell":"B",
"orderType":"LO",
"ipAddress":"192.168.202.36",
"price":1410,
"prefix":"2mw",
"quantity":2,
"marketID":"VNFE",
"origOrderId":"",
"account":"0901358",
"cancelQty":0,
"osQty":2,
"filledQty":0,
"avgPrice":0,
"channel":"TA",
"inputTime":"1606277281849",
"modifiedTime":"1606277330852",
"isForceSell":"F",
"isShortSell":"F",
"orderStatus":"RS",
"rejectReason":"",
"origRequestID":"30304045",
"stopOrder": false,
"stopPrice":0,
"stopType":"",
"stopStep":0,
"profitPrice":0
}
}

Streaming sửa lệnh không thành công

{
requestID: "93235974",
orderID: "12658867",
price: 1000,
quantity: 2,
account: "0901358",
instrumentID: "VN30F2106",
marketID: "VNFE",
buySell: "B",
orderType: "LO"
code:”123456789”,
deviceID: "MAC Address",
userAgent: “FCTrading”
}

{
  "type": "orderError",
  "data": {
    "message": "Price 1,000.00 exceeds ceiling price 808.50!",
    "notifyID": 15460,
    "data": null,
    "errorCode": "ERR500",
    "uniqueID": "65896571",
    "connectionID": "",
    "ipAddress": "192.168.202.87",
    "prefix": "23o"
  }
}

Streaming hủy lệnh thành công

{
orderID: "12658867",
account: "0901358",
marketID: "VNFE",
instrumentID: "VN30F2106",
buySell: "B",
requestID: "52513603"
code:”123456789”,
deviceID: "MAC Address",
userAgent: “FCTrading”
}

{
"type":"orderEvent",
"data": {
"orderID":"12663204",
"notifyID":12,
"instrumentID":"VN30F2106",
"uniqueID":"59028516",
"buySell":"B",
"orderType":"LO",
"ipAddress":"192.168.202.36",
"price":1410
,"prefix":"2mw",
"quantity":2,
"marketID":"VNFE",
"origOrderId":"",
"account":"0901358",
"cancelQty":2,
"osQty":0,
"filledQty":0,
"avgPrice":0,
"channel":"TA",
"inputTime":"1606277281849",
"modifiedTime":"1606277330861",
"isForceSell":"F",
"isShortSell":"F",
"orderStatus":"CL",
"rejectReason":"",
"origRequestID":"30304045",
"stopOrder": false,
"stopPrice":0,
"stopType":"",
"stopStep":0,
"profitPrice":0
}
}

Streaming hủy lệnh không thành công

{
orderID: "12658867",
account: "0901358",
marketID: "VNFE",
instrumentID: "VN30F2106",
buySell: "B",
requestID: "52513603"
code:”123456789”,
deviceID: "MAC Address",
userAgent: “FCTrading”
}

{
  "type": "orderError",
  "data": {
    "message": "Invalid Order Transition Error!",
    "notifyID": 15468,
    "data": null,
    "errorCode": "ERR500",
    "uniqueID": "25162310",
    "ipAddress": ":",
    "192.168.202.87": ",",
    "prefix": ":",
    "23o": "}}"
  }
}

2. OrderError

Khi yêu cầu đặt/hủy/sửa bị lỗi, hệ thống sẽ cập nhật qua streaming các thông tin như sau:

Tên trường	Kiểu dữ liệu	Mô tả
type	string	Tên event: orderError
data		Thông tin dữ liệu
Detail of data
uniqueid	string
ipaddress	string
notifyID	string
errorCode	string	Mã code lỗi trả ra
message	string	Thông tin lệnh lỗi
orderID	string	Số hiệu lệnh
instrumentID	string	Mã CK
buySell	string	Chiều mua/ bán B: Buy S: Sell

prefix	string
orderType	string	Loại lệnh: LO\|ATO\|ATC\|MP\|MTL\|MOK\|MAK\|PLO
price	number	Giá
quantity	number	Khối lượng
marketID	string	Sàn
origOrderID	string
account	string	Số tài khoản
channel	string	Kênh
inputTime	string	Thời gian nhận
modifiedTime	string	Thời gian sửa lệnh
isForceSell	Boolean	Luôn = F
isShortSell	Boolean	Luôn = F
origRequestID	string
stopOrder	string	True hoặc False
stopPrice	number
stopType	string	Loại điều kiện. Bắt buộc nhập nếu stopType = true - D: Down - U: Up - V: Trailling Up - E: Trailing Down - O: OCO - B: BullBear
stopStep	number
profitPrice	number
modifiable	string
note	string	Ghi chú

Tên trường

Kiểu dữ liệu

Mô tả

type

string

Tên event: orderError

data

Thông tin dữ liệu

Detail of data

uniqueid

string

ipaddress

string

notifyID

string

errorCode

string

Mã code lỗi trả ra

message

string

Thông tin lệnh lỗi

orderID

string

Số hiệu lệnh

instrumentID

string

Mã CK

buySell

string

Chiều mua/ bán B: Buy

S: Sell

prefix

string

orderType

string

Loại lệnh:

LO|ATO|ATC|MP|MTL|MOK|MAK|PLO

price

number

Giá

quantity

number

Khối lượng

marketID

string

Sàn

origOrderID

string

account

string

Số tài khoản

channel

string

Kênh

inputTime

string

Thời gian nhận

modifiedTime

string

Thời gian sửa lệnh

isForceSell

Boolean

Luôn = F

isShortSell

Boolean

Luôn = F

origRequestID

string

stopOrder

string

True hoặc False

stopPrice

number

stopType

string

Loại điều kiện. Bắt buộc nhập nếu stopType = true

- D: Down

- U: Up

- V: Trailling Up

- E: Trailing Down

- O: OCO

- B: BullBear

stopStep

number

profitPrice

number

modifiable

string

note

string

Ghi chú

Ví dụ:

{
  "type": "orderError",
  "data": {
    "message": "This channel has been block; disallow to place order ",
    "notifyID": 0,
    "errorCode": "ORD015",
    "uniqueID": "6163422",
    "orderID": "T20230504w3806163422",
    "instrumentID": "SSI",
    "ipAddress": "10.255.241.47",
    "buySell": "B",
    "prefix": "w38",
    "orderType": "LO",
    "price": 19600,
    "quantity": 200,
    "marketID": "VN",
    "origOrderId": "T20230504w3806163422",
    "account": "0322206",
    "channel": "TA",
    "inputTime": "1683165600160",
    "modifiedTime": "1683165600161",
    "isForceSell": "F",
    "isShortSell": "F",
    "origRequestID": "6163422",
    "stopOrder": false,
    "stopPrice": 0,
    "stopType": "",
    "stopStep": 0,
    "profitPrice": 0,
    "modifiable": false,
    "note": ""
  }
}

3. Order Match Event

Thông tin Streaming gồm những trường sau:

Tên trường	Kiểu dữ liệu	Mô tả
type	string	Tên event: orderMatchEvent
data		Thông tin khớp lệnh
orderID	string	Thông tin orderID
instrumentID	string	Mã chứng khoán
ipAddress	string	IP xác định từ yêu cầu Client
uniqueID	string
notifyid	string
buySell	string
matchPrice	number	giá khớp
matchQty	number	khối lượng khớp
prefix	string
account	string	Số tài khoản
matchTime	string	Thời gian khớp

Tên trường

Kiểu dữ liệu

Mô tả

type

string

Tên event: orderMatchEvent

data

Thông tin khớp lệnh

orderID

string

Thông tin orderID

instrumentID

string

Mã chứng khoán

ipAddress

string

IP xác định từ yêu cầu Client

uniqueID

string

notifyid

string

buySell

string

matchPrice

number

giá khớp

matchQty

number

khối lượng khớp

prefix

string

account

string

Số tài khoản

matchTime

string

Thời gian khớp

Ví dụ:

{
  "type": "orderMatchEvent",
  "data": {
    "orderID": "16201867",
    "notifyID": 101180,
    "instrumentID": "BVS",
    "uniqueID": "24194396",
    "buySell": "B",
    "matchPrice": 1000,
    "ipAddress": "10.48.41.16",
    "matchQty": 100,
    "prefix": "t4c",
    "account": "1184411",
    "matchTime": "1656665019000"
  }
}

4. Vị thế phái sinh

Thông tin streaming vị thế phái sinh bao gồm vị thế mở và vị thế đã đóng trong ngày.

Tên trường	Kiểu dữ liệu	Mô tả
type	string	Tên event: clientPortfolioEvent
uniqueid	string
connectionid	string
ipaddress	string	IP được xác định từ yêu cầu Client
notifyid	string
account	string	Số tài khoản
marketid	string	Thị trường - VNFE: Phái sinh
instrumentid	string	Mã chứng khoán
longqty	number	Vị thế long
shortqty	number	Vị thế short
Net	number	Vị thế net (Tính bằng long - short).
bidavgprice	number	Giá mua trung bình
askavgprice	number	Giá bán trung bình
tradeprice	number	Giá khớp
marketprice	number	Giá thị trường
floatingpl	number	Lãi/ Lỗ tạm tính
tradingpl	number	Lãi/ Lỗ đã chốt

Tên trường

Kiểu dữ liệu

Mô tả

type

string

Tên event: clientPortfolioEvent

uniqueid

string

connectionid

string

ipaddress

string

IP được xác định từ yêu cầu Client

notifyid

string

account

string

Số tài khoản

marketid

string

Thị trường - VNFE: Phái sinh

instrumentid

string

Mã chứng khoán

longqty

number

Vị thế long

shortqty

number

Vị thế short

Net

number

Vị thế net (Tính bằng long - short).

bidavgprice

number

Giá mua trung bình

askavgprice

number

Giá bán trung bình

tradeprice

number

Giá khớp

marketprice

number

Giá thị trường

floatingpl

number

Lãi/ Lỗ tạm tính

tradingpl

number

Lãi/ Lỗ đã chốt

Ví dụ:

{
  "type": "clientPortfolioEvent",
  "data": {
    "account": "0901358",
    "notifyID": 27,
    "data": null,
    "clientPortfoliosOpen": [
      {
        "martketID": "VNFE",
        "instrumentID": "VN30F2106",
        "longQty": 9,
        "shortQty": 0,
        "net": 9,
        "bidAvgPrice": 1402.4000244140625,
        "askAvgPrice": 0,
        "tradePrice": 0,
        "marketPrice": 873,
        "floatingPL": -476460000,
        "tradingPL": 0
      },
      {
        "martketID": "VNFE",
        "instrumentID": "VN30F2107",
        "longQty": 2,
        "shortQty": 0,
        "net": 2,
        "bidAvgPrice": 830,
        "askAvgPrice": 0,
        "tradePrice": 0,
        "marketPrice": 830,
        "floatingPL": 0,
        "tradingPL": 0
      }
    ],
    "uniqueID": null,
    "clientPortfoliosClose": null,
    "connectionID": "",
    "ipAddress": null,
    "prefix": null
  }
}

PreviousDanh sách các API NextBảng mã dữ liệu

Last updated 1 year ago