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

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ú

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

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

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