Danh sách các API

FastConnect Trading hỗ trợ API về Đặt/ Hủy/ Sửa lệnh, Chuyển tiền nội bộ, Nộp/ Rút ký quỹ, Chuyển chứng khoán, Ứng trước tiền bán, Đăng ký quyền mua và Tra cứu thông tin tài khoản.

Danh sách API

• Các API liên quan đến Token và xác thực 2FA

API	Method	Path
AccessToken	POST	Trading/AccessToken
GetOTP	POST	Trading/GetOTP

• Các API tra cứu thông tin tài khoản cơ sở và phái sinh

API	Method	Path
orderBook	GET	Trading/orderBook
auditOrderBook	GET	Trading/auditOrderBook
cashAcctBal	GET	Trading/cashAcctBal
derivAcctBal	GET	Trading/derivAcctBal
ppmmraccount	GET	Trading/ppmmraccount
stockPosition	GET	Trading/stockPosition
derivPosition	GET	Trading/derivPosition
maxBuyQty	GET	Trading/maxBuyQty
maxSellQty	GET	Trading/maxSellQty
orderHistory	GET	Trading/orderHistory
rateLimit	GET	Trading/rateLimit

• Các API đặt lệnh cơ sở/ phái sinh

API	Method	Path
NewOrder	POST	Trading/NewOrder
CancelOrder	POST	Trading/CancelOrder
derNewOrder	POST	Trading/derNewOrder
ModifyOrder	POST	Trading/ModifyOrder
derCancelOrder	POST	Trading/derCancelOrder
derModifyOrder	POST	Trading/derModifyOrder

• Các API liên quan đến Chuyển tiền nội bộ, Nộp/ Rút ký quỹ và Ứng trước tiền bán

API	Method	Path
cashInAdvanceAmount	GET	cash/cashInAdvanceAmount
unsettleSoldTransaction	GET	cash/unsettleSoldTransaction
transferHistories	GET	cash/transferHistories
cashInAdvanceHistories	GET	cash/cashInAdvanceHistories
estCashInAdvanceFee	GET	cash/estCashInAdvanceFee
vsdCashDW	POST	cash/vsdCashDW
transferInternal	POST	cash/transferInternal
createCashInAdvance	POST	cash/createCashInAdvance

• Các API liên quan đến Chuyển chứng khoán

API	Method	Path
transferable	GET	stock/transferable
transferHistories	GET	stock/transferHistories
transfer	POST	stock/transfer

• Các API liên quan đến Đăng ký quyền mua

API	Method	Path
dividend	GET	ors/dividend
exercisableQuantity	GET	ors/exercisableQuantity
histories	GET	ors/histories
create	POST	ors/create

Yêu cầu Config

Method	Content	Content
Post	Header (Authorization, Content-Type)	Body (json)
Get	Header (Authorization)	Params

API Details

POST AccessToken

https://fc-tradeapi.ssi.com.vn/api/v2/Trading/AccessToken

Dùng để tạo access token truy cập vào các api của FC Trading.

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
consumerID	string	Yes	ConsumerID trong thông tin kết nối
consumerSecret	string	Yes	ConsumerSecret trong thông tin kết nối
code	string	No	Mã xác thực khi thực hiện giao dịch, nếu isSave = true thì bắt buộc truyền
TwoFactorType	string	Yes	Loại xác thực giao dịch của tài khoản, hỗ trợ type = 0 (PIN), type = 1 (OTP)
isSave	boolean	Yes	Lưu code khi giao dịch có các giá trị: true (hệ thống sẽ lưu PIN/OTP cho đến khi hết hiệu lực), false (các giao dịch lệnh đều cần truyền code)

Output

Dữ liệu	Kiểu	Mô tả
message	string	Thông báo trả ra khi call api
status	number	Trạng thái
data	list	List data
accessToken	string	Token kết nối API

Ví dụ

• Trường hợp thành công

Input: 
{
  consumerID: "38f5fdfa56b44d5ab8b95895eb588e99",
  consumerSecret: "6d61bffefc6540fc837c71afd2ca4bcf",
  twoFactorType: 1,
  code: "123456789",
  isSave: false
}
Output: 
{
    message: "Success",
    status: 200,
    data: {
        "accessToken": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ”
}

• Trường hợp lỗi

Input: 
{
  consumerID: "38f5fdfa56b44d5ab8b95895eb588e99",
  consumerSecret: "6d61bffefc6540fc837c71afd2ca4bcf",
  twoFactorType: 0,
  code: "123456789",
  isSave: true
}
Output: 
{
message: "Key does not exist.",
status: 400,
data: null
 }

POST GetOTP

https://fc-tradeapi.ssi.com.vn/api/v2/Trading/GetOTP

Dùng để lấy mã OTP nếu tài khoản đã đăng ký sử dụng SMS OTP và Email OTP.

Nếu lấy OTP quá 5 lần mà không xác thực thì dịch vụ OTP sẽ bị tạm khóa.

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
consumerID	string	Yes	ConsumerID trong thông tin kết nối
consumerSecret	string	Yes	ConsumerSecret trong thông tin kết nối

Output

Dữ liệu	Kiểu	Mô tả
message	string	Thông báo trả ra khi call api
status	number	Trạng thái

Ví dụ

• Trường hợp thành công

Input: 
{
  "consumerID": "968d7b5940f5437583021aea2b038f35",
  "consumerSecret": "11ab3fc6af954c59ba646fac016f30cb"
}
Output: 
{
    message: "Success",
    status: 200
}

• Trường hợp lỗi

Input: 
{
  "consumerID": "968d7b5940f5437583021aea2b038f351",
  "consumerSecret": "11ab3fc6af954c59ba646fac016f30cb"
}
Output: 
{
  "message": "ConsumerID is invalid",
  "status": 400
}

GET auditOrderBook

https://fc-tradeapi.ssi.com.vn/api/v2/Trading/auditOrderBook

Trả ra lịch sử cập nhật của lệnh.

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản muốn truy vấn bao gồm Cơ sở và Phái sinh

Output

Dữ liệu	Kiểu	Mô tả
message	string	Thông báo trả ra khi call api
status	number	Trạng thái
data	list	List data
uniqueID	string	ID lệnh của bên gửi
orderID	string	ID lệnh
buySell	string	Bên mua/ bán
price	number	Giá đặt
quantity	number	Khối lượng đặt
filledQty	string	Khối lượng khớp
orderStatus	string	Trạng thái lệnh
marketID	string	Mã sàn
inputTime	string	Thời gian đặt
modifiedTime	string	Thời gian cập nhật
instrumentID	string	Mã chứng khoán
orderType	string	Loại lệnh
cancelQty	string	Khối lượng hủy
avgPrice	string	Giá khớp trung binh
isForcesell	boolean
isShortsell	boolean
rejectReason	string	Lý do từ chối
lastErrorEvent	list	Thông tin lệnh hệ thống trả lỗi khi trùng orderID

Ví dụ

Input: 
{
account: "1184418"
}
Output: 
{
  "message": "Success",
  "status": 200,
  "data": {
    "account": "1184418",
    "orders": [
      {
        "uniqueID": "73885549",
        "orderID": "T202306146w273885549",
        "buySell": "B",
        "price": 1000,
        "quantity": 100,
        "filledQty": 0,
        "orderStatus": "RJ",
        "marketID": "VNFE",
        "inputTime": "1686730747945",
        "modifiedTime": "1686730747945",
        "instrumentID": "VN30F2306",
        "orderType": "LO",
        "cancelQty": 0,
        "avgPrice": 0,
        "isForcesell": "F",
        "isShortsell": "F",
        "rejectReason": "Invalid market status",
        "lastErrorEvent": null
      }     
    ]
  }
}

GET OrderBook

https://fc-tradeapi.ssi.com.vn/api/v2/Trading/OrderBook

Tra cứu lệnh đặt trong ngày của cả tài khoản cơ sở và phái sinh.

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản muốn truy vấn bao gồm Cơ sở và Phái sinh

Output

Dữ liệu	Kiểu	Mô tả
message	string	Thông báo trả ra khi call api
status	number	Trạng thái
data	list	List data
uniqueID	string	ID lệnh của bên gửi
orderID	string	ID lệnh
buySell	string	Bên mua/ bán
price	number	Giá đặt
quantity	number	Khối lượng đặt
filledQty	string	Khối lượng khớp
orderStatus	string	Trạng thái lệnh
marketID	string	Mã sàn
inputTime	string	Thời gian đặt
modifiedTime	string	Thời gian cập nhật
instrumentID	string	Mã chứng khoán
orderType	string	Loại lệnh
cancelQty	string	Khối lượng hủy
avgPrice	string	Giá khớp TB
isForcesell	boolean
isShortsell	boolean
rejectReason	string	Lý do từ chối

Ví dụ

Input: 
{
account: "1184418"
}
Output: 
{
  "message": "Success",
  "status": 200,
  "data": {
    "account": "1184418",
    "orders": [
      {
        "uniqueID": "73885549",
        "orderID": "T202306146w273885549",
        "buySell": "B",
        "price": 1000,
        "quantity": 100,
        "filledQty": 0,
        "orderStatus": "RJ",
        "marketID": "VNFE",
        "inputTime": "1686730747945",
        "modifiedTime": "1686730747945",
        "instrumentID": "VN30F2306",
        "orderType": "LO",
        "cancelQty": 0,
        "avgPrice": 0,
        "isForcesell": "F",
        "isShortsell": "F",
        "rejectReason": "Invalid market status"
      }     
    ]
  }
}

GET orderHistory

https://fc-tradeapi.ssi.com.vn/api/v2/Trading/orderHistory

Truy vấn lịch sử lệnh

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản muốn truy vấn bao gồm Cơ sở và Phái sinh
startDate	date	Yes	Ngày bắt đầu tìm kiếm Định dạng dd/mm/yyyy
endDate	date	Yes	Ngày kết thúc tìm kiếm Định dạng dd/mm/yyyy

Output

Dữ liệu	Kiểu	Mô tả
message	string	Thông báo trả ra khi call api
status	number	Trạng thái
data	list	List data
orderHistories	list	Danh sách lịch sử lệnh
uniqueID	string	ID lệnh của bên gửi
orderID	string	ID lệnh
buySell	string	Bên mua/ bán
price	number	Giá đặt
quantity	number	Khối lượng đặt
filledQty	string	Khối lượng khớp
orderStatus	string	Trạng thái lệnh
marketID	string	Mã sàn
inputTime	string	Thời gian đặt
modifiedTime	string	Thời gian cập nhật
instrumentID	string	Mã chứng khoán
orderType	string	Loại lệnh
cancelQty	string	Khối lượng hủy
avgPrice	string	Giá khớp trung bình
isForcesell	boolean
isShortsell	boolean
rejectReason	string	Lý do từ chối

Ví dụ

Input: 
{
account: "0901358",
startDate: “18/11/2020”,
endDate: “18/11/2020”
}
Output: 
{
    message: "Success",
    status: 200,
    data: {
        orderHistories: [
      {
                uniqueID: null,
                orderID: "12626539",
                buySell: "B",
                price: 800.0,
                quantity: 10,
                filledQty: 0,
                orderStatus: "RJ",
                marketID: "VNFE",
                inputTime: "1603157594668",
                modifiedTime: "1603157594668",
                instrumentID: "VN30F2012",
                orderType: "LO",
                cancelQty: 0,
                avgPrice: 0.0,
                isForcesell: null,
                isShortsell: null
            }
],
        account: "0901358"
    }
 }

GET cashAccountBalance

https://fc-tradeapi.ssi.com.vn/api/v2/Trading/cashAcctBal

Truy vấn thông tin tiền của tài khoản cơ sở.

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản cơ sở muốn truy vấn

Output

Dữ liệu	Kiểu	Mô tả
message	string	Thông báo trả ra khi call api
status	number	Trạng thái
data	list	List data
account	string	Số tài khoản cơ sở
cashbal	number	Tổng tiền mặt
cashonhold	number	Tiền bị phong tỏa
secureamount	number	Secure amount intraday
withdrawable	number	Số tiền có thể rút
receivingcasht1	number	Tiền bán chờ về ngày T1
receivingcasht2	number	Tiền bán chờ về ngày T2
matchedbuyvolume	number	Tiền khớp mua trong ngày
matchedsellvolume	number	Tiền khớp bán trong ngày
unmatchedbuyvolume	number	Tiền mua chứng khoán chờ khớp
unmatchedsellvolume	number	Tiền bán chứng khoán chờ khớp
paidcasht1	number	Tiền mua chứng khoán ngày T1
paidcasht2	number	Tiền mua chứng khoán ngày T2
cia	number	Số tiền ứng trước
debt	number	Dư nợ
purchasingpower	number	Sức mua
totalasset	number	Tổng tài sản

Ví dụ

Input: 
{
    account: "0901351",
}
Output: 
{
message: "Success",
status: 200,
data: {
account: "0901351",
cashBal: 7459369481,
cashOnHold: 0,
secureAmount: 0,
withdrawable: 7459367581,
receivingCashT1: 0,
receivingCashT2: 0,
matchedBuyVolume: 0,
matchedSellVolume: 0,
debt: 1900,
unMatchedBuyVolume: 0,
unMatchedSellVolume: 864619337,
paidCashT1: 0,
paidCashT2: 0,
cia: 0,
purchasingPower: 7459367581,
totalAssets: 9726161481
       }
}

GET stockPosition

https://fc-tradeapi.ssi.com.vn/api/v2/Trading/stockPosition

Truy vấn danh mục của tài khoản cơ sở.

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản cơ sở muốn truy vấn

Output

Tên trường	Kiểu dữ liệu	Mô tả
message	string	Thông báo trả ra khi call api
status	number	Trạng thái
data	list	List data
totalMarketValue	number	Tổng giá trị thị trường danh mục = sum(maketprice * onhand)
stockPositions	list	Danh mục đầu tư của tài khoản
marketID	string	Mã sàn
instrumentID	string	Mã chứng khoán
onHand	number	Tổng khối lượng đang nắm giữ, bao gồm cả chứng khoán bán chưa thanh toán T0, T1; không bao gồm chứng khoán mua chờ thanh toán T0, T1 và chứng khoán quyền.
block	number	Phong tỏa
bonus	number	Cổ phiếu quyền quyền
buyT0	number	Mua khớp thanh toán ngày T0
buyT1	number	Mua khớp thanh toán ngày T1
buyT2	number	Mua khớp thanh toán ngày T2
sellT0	number	Bán khớp thanh toán ngày T0
sellT1	number	Bán khớp thanh toán ngày T1
sellT2	number	Bán khớp thanh toán ngày T2
avgPrice	number	Giá vốn trung bình
mortgage	number	Chứng khoán cầm cố
holdForTrade	number	Chứng khoán hạn chế chuyển nhượng
marketPrice	number	Giá trị trường

Ví dụ

Input: 
{
account: "0901351",
}
}
Output: 
{
  "message": "Success",
  "status": 200,
  "data": {
    "account": "0001011",
    "totalMarketValue": 0,
    "stockPositions": [
      {
        "marketID": "VN",
        "instrumentID": "AMC",
        "onHand": 300,
        "block": 0,
        "bonus": 3819,
        "buyT0": 0,
        "buyT1": 0,
        "buyT2": 0,
        "sellT0": 0,
        "sellT1": 0,
        "sellT2": 0,
        "avgPrice": 1529,
        "mortgage": 0,
        "sellableQty": 300,
        "holdForTrade": 0,
        "marketPrice": 0
      }
    ]
  }
}

GET derivativeAccountBalance

https://fc-tradeapi.ssi.com.vn/api/v2/Trading/derivAcctBal

Kiểm tra số dư tiền tài khoản phái sinh.

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản phái sinh muốn truy vấn

Output

Dữ liệu	Kiểu	Mô tả
message	string	Thông báo trả ra khi call api
status	number	Trạng thái
data	list	List data
account	string	Số tài khoản phái sinh
accountbalance	number	Tổng số dư tiền
fee	number	Phí
commission	number	Thuế
interest	number	Lãi
Loan	number	Nợ
deliveryamount	number	Giá trị chuyển giao
floatingpl	number	Lãi lỗ tạm tính
totalpl	number	Lãi lỗ vị thế
marginable	number	Số dư tối thiếu tiền
depositable	number	Tiền có thể ký quỹ
rccall	number
withdrawable	number	Tiền có thể rút
noncashdrawablerccall	number	Giá trị chứng khoán có thể rút
internalassets	list	Tài sản nội bộ bao gồm: Cash Validnoncash totalvalue: maxvalidnoncash cashwithdrawable Ee
exchangeassets	list	Tài sản ký quỹ bao gồm: Cash Validnoncash totalvalue: maxvalidnoncash cashwithdrawable Ee
internalmargin	list	Margin nội bộ bao gồm: initialmargin deliverymargin marginreq accountratio usedlimitwarninglevel1 usedlimitwarninglevel2 usedlimitwarninglevel3 margincall
exchangemargin	list	Margin ký quỹ bao gồm: marginreq accountratio usedlimitwarninglevel1 usedlimitwarninglevel2 usedlimitwarninglevel3 margincall

Ví dụ

Input: 
{
    account: "0901358",
}
Output: 
{
message: "Success",
status: 200,
data: {
account: "0901358",
accountBalance: 11166309263,
fee: 0,
commission: 0,
interest: 1514965,
loan: 0,
deliveryAmount: 0,
floatingPL: 0,
totalPL: 0,
marginable: 0,
depositable: 1148597520,
rcCall: 0,
withdrawable: 10912447363,
nonCashDrawableRCCall: 0,
internalAssets: {
cash: 1165730020,
validNonCash: 0,
totalValue: 11166309263,
maxValidNonCash: 0,
cashWithdrawable: 1148597520,
ee: 8197059272
        },
exchangeAssets: {
cash: 10000579243,
validNonCash: 0,
totalValue: 10000579243,
maxValidNonCash: 0,
cashWithdrawable: 9763849843,
ee: 7322887382
         },
        internalMargin: {
initialMargin: 172660800,
deliveryMargin: 0,
marginReq: 172660800,
accountRatio: 1.5462656096416592,
usedLimitWarningLevel1: 75,
usedLimitWarningLevel2: 85,
usedLimitWarningLevel3: 90,
marginCall: 0
        },
      exchangeMargin: {
marginReq: 172660800,
accountRatio: 1.7265079932330476,
usedLimitWarningLevel1: 75,
usedLimitWarningLevel2: 85,
usedLimitWarningLevel3: 90,
marginCall: 0
        }
     }
}

GET derivativePosition

https://fc-tradeapi.ssi.com.vn/api/v2/Trading/derivPosition

Truy vấn vị thế của tài khoản phái sinh.

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản phái sinh muốn truy vấn
querySummary	boolean	Yes	Mode net vị thế: - True: có net vị thế - False: không net vị thế

Output

Dữ liệu	Kiểu dữ liệu	Mô tả
message	string	Thông báo trả ra khi call api
status	number	Trạng thái
data	list	List data
account	string	Số tài khoản
openPosition	list	Mở vị thế
closePosition	list	Đóng vị thế
marketID	string	Mã sàn
instrumentID	string	Mã chứng khoán
longQty	number	Vị thế mở
shortQty	number	Vị thế đóng
net	number	Net
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ụ

Input: 
{
account: "0901358",
querySummary: true
}
Output: 
{
message: "Success",
status: 200,
data: {
       account: "0901358",
       openPosition: [
       {
           marketID: "VNFE",
           instrumentID: "VN30F2106",
           longQty: 8,
           shortQty: 0,
           net: 8,
           bidAvgPrice: 0,
           askAvgPrice: 0,
           tradePrice: 1452.7,
           marketPrice: 1452.7,
           floatingPL: 0,
           tradingPL: 0
          }   ],
        closePosition: [ ]
    }
}

GET maxBuyQty

https://fc-tradeapi.ssi.com.vn/api/v2/Trading/maxBuyQty

Truy vấn số lượng mua tối đa, sử dụng cho cả tài khoản cơ sở và phái sinh.

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản muốn truy vấn bao gồm Cơ sở và Phái sinh
instrumentID	string	Yes	Mã chứng khoán
price	number	Yes	Giá

Output

Dữ liệu	Kiểu	Mô tả
message	string	Thông báo trả ra khi call api
status	number	Trạng thái
data	list	List data
account	string	Số tài khoản
maxbuyqty	number	Khối lượng mua tối đa
marginRatio	number	tỷ lệ Margin
purchasingPower	number	Sức mua

Ví dụ

Input: 
{
account: "0041691",
instrumentD: “SSI”,
price:17
}
Output: 
{
    message: "Success",
    status: 200,
    data: {
        account: "0041691",
        maxBuyQty: 8241440,
        marginRatio: "50%",
        purchasingPower: 99292902171
    }
}

GET maxSellQty

https://fc-tradeapi.ssi.com.vn/api/v2/Trading/maxSellQty

Truy vấn số lượng bán tối đa, sử dụng cho cả tài khoản cơ sở và phái sinh.

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản muốn truy vấn bao gồm Cơ sở và Phái sinh
instrumentID	string	Yes	Mã chứng khoán
price	number	Yes	Giá

Output

Dữ liệu	Kiểu	Mô tả
message	string	Thông báo trả ra khi call api
status	number	Trạng thái
data	list	List data
account	string	Số tài khoản
maxSellQty	number	Khối lượng bán tối đa

Ví dụ

Input: 
{
account: "0041691",
intrumentID: “SSI”
}
Output: 
{
    "message": "Success",
    "status": 200,
    "data": {
        "account": "0041691",
        "maxSellQty": 2000
    }
}

POST NewOrder

https://fc-tradeapi.ssi.com.vn/api/v2/Trading/NewOrder

Dùng để đặt lệnh, sử dụng cho cả tài khoản cơ sở và phái sinh. Khi gửi thông tin lệnh thành công, api trả 200. Để xem lệnh có đẩy lên sàn thành công hay không cần kết nối streaming để nhận kết quả (hoặc call api oderBook)

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
instrumentID	string	Yes	Mã chứng khoán đặt lệnh
market	string	Yes	VN: thị trường cơ sở VNFE: thị trường phái sinh
buySell	string	Yes	B: Buy S: Sell
orderType	string	Yes	Loại lệnh
channelID	string	Yes	Kênh đặt lệnh VD: TA (trader API)
price	number	Yes	Giá đặt lệnh: - Nếu loại lệnh là LO -> Giá đặt > 0 - Nếu loại lệnh khác LO -> Giá đặt = 0
quantity	number	Yes	Khối lượng đặt
account	string	Yes	Số tài khoản muốn đặt lệnh
requestID	string	Yes	ID đặt lệnh trong ngày. Bắt buộc 8 số random
stopOrder	string	Yes	Loại lệnh: True: Nếu là lệnh điều kiện. Chỉ áp dụng cho tài khoản phái sinh. False: nếu là lệnh thường
stopPrice	number	Yes	Giá đặt mong muốn cắt lỗ/chốt lãi Nếu stopOrder = true -> stopPrice > 0
stopType	string	Yes	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	Yes	Bước chốt lỗ, chỉ dùng cho lệnh điều kiện BullBear (stopType = B)
profitStep	number	Yes	Bước chốt lãi, chỉ dùng cho lệnh điện BullBear (stopType = B)
code	number	No	Trading code: PIN, OTP Nếu API Xác thực người dùng input: isSave = false, code bắt buộc điền
deviceId	string	Yes	Định danh thiết bị
userAgent	string	No	Tác nhân người dùng

Output

Dữ liệu	Kiểu	Mô tả
message	string	Thông báo trả ra khi call api
status	number	Trạng thái
data	list	List data
requestID	string	ID của lệnh gửi
requestData	string	Dữ liệu yêu cầu
instrumentID	string	mã chứng khoán đặt lệnh
market	string	Sàn: VN: thị trường cơ sở VNFE: thị trường phái sinh
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
channelID	string	Kênh đặt lệnh VD: TA (trader API)
price	number	Giá đặt lệnh: - Nếu loại lệnh là LO -> Giá đặt > 0 - Nếu loại lệnh khác LO -> Giá đặt = 0
quantity	number	Khối lượng đặt
account	string	Số tài khoản muốn đặt lệnh: xxxxxx1: Cơ sở xxxxxx8: Phái sinh
requestID	string	ID đặt lệnh trong ngày. Bắt buộc 8 số random
stopOrder	string	Loại lệnh: True: Đối với lệnh điều kiện False: Đối với lệnh thường
stopPrice	number	Giá đặt mong muốn cắt lỗ/chốt lãi Nếu stopOrder = true -> stopPrice > 0s
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	Bước chốt lỗ, chỉ dùng cho lệnh điều kiện BullBear (stopType = B)
profitStep	number	Bước chốt lãi, chỉ dùng cho lệnh điện BullBear (stopType = B)

Ví dụ

• Thành công

Input: 
{ 
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: "8C-EC-4B-D3-0B-96",
userAgent: “FCTrading”
 }
 Output: 
 {
message: "Success",
status: 200,
data: {
requestID: "1678195",
requestData: 
{
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
}
    }
}

• Trường hợp lỗi

Input: 
{  
instrumentID: "SSI",
market: "VN",
buySell: "B",
orderType: "ATO",
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: "8C-EC-4B-D3-0B-96",
userAgent: “FCTrading”
 }
Output: 
 {
    message: "Price is null or equal zero when order is market order",
    status: 400,
    data: null
}

POST ModifyOrder

https://fc-tradeapi.ssi.com.vn/api/v2/Trading/ModifyOrder

Dùng để sửa lệnh, sử dụng cho cả tài khoản cơ sở và phái sinh.

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
orderID	string	Yes	ID của lệnh
instrumentID	string	Yes	mã chứng khoán đặt lệnh
marketID	string	Yes	VN: thị trường cơ sở VNFE: thị trường phái sinh
buySell	string	Yes	B: Buy S: Sell
orderType	string	Yes	Loại lệnh
channelID	string	Yes	Kênh đặt lệnh VD: TA (trader API)
price	number	Yes	Giá đặt lệnh: - Nếu loại lệnh là LO -> Giá đặt > 0 - Nếu loại lệnh khác LO -> Giá đặt = 0
quantity	number	Yes	Khối lượng đặt
account	string	Yes
requestID	string	Yes	ID duy nhất của yêu cầu do client sinh. Bao gồm 8 kí tự số.
code	number	No	Trading code: PIN, OTP Nếu API Xác thực người dùng input: isSave = false, code bắt buộc điền
deviceId	string	Yes	Định danh thiết bị xuất phát yêu cầu.
userAgent	string	No

Output

Dữ liệu	Kiểu	Mô tả
message	string	Thông báo trả ra khi call api
status	number	Trạng thái
data	list	List data
requestID	string	ID của lệnh gửi
requestData	string	Dữ liệu yêu cầu
instrumentID	string	mã chứng khoán đặt lệnh
market	string	Sàn: VN: thị trường cơ sở VNFE: thị trường phái sinh
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
price	number	Giá đặt lệnh: - Nếu loại lệnh là LO -> Giá đặt > 0 - Nếu loại lệnh khác LO -> Giá đặt = 0
quantity	number	Khối lượng đặt
orderID	string	ID của lệnh
account	string	Số tài khoản

Ví dụ

• Thành công

Input: 
{
requestID: "93235974",
orderID: "12658867",
price: 1410,
quantity: 2,
account: "0901358",
instrumentID: "VN30F2106",
marketID: "VNFE",
buySell: "B",
orderType: "LO"
code:”123456789”,
deviceId: "8C-EC-4B-D3-0B-96",
userAgent: “FCTrading”
}
Output: 
{
message: "Success",
status: 200,
data: {
   requestID: "93235974",
   requestData: {
         orderID: "12658867",
         price: 1410,
         quantity: 2,
         account: "0901358",
         instrumentID: "VN30F2106",
         marketID: "VNFE",
         buySell: "B",
         orderType: "LO"
      }
  }
}

• Trường hợp lỗi

Input: 
{
requestID: "93235971",
orderID: "",
price: 1410,
quantity: 2,
account: "0901358",
instrumentID: "VN30F2106",
marketID: "VNFE",
buySell: "B",
orderType: "LO"
code:”123456789”,
deviceId: "8C-EC-4B-D3-0B-96",
userAgent: “FCTrading”
}
Output: 
{
data: null,
message: "’Order ID’ must not be empty ",
status: 400
}

POST CancelOrder

https://fc-tradeapi.ssi.com.vn/api/v2/Trading/CancelOrder

Sử dụng để hủy lệnh, sử dụng cho cả tài khoản cơ sở và phái sinh.

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
orderID	string	Yes	ID của lệnh
instrumentID	string	Yes	mã chứng khoán đặt lệnh
market	string	Yes	VN: thị trường cơ sở VNFE: thị trường phái sinh
buySell	string	Yes	B: Buy S: Sell
orderType	string	Yes	Loại lệnh
channelID	string	Yes	Kênh đặt lệnh VD: TA (trader API)
price	number	Yes	Giá đặt lệnh: - Nếu loại lệnh là LO -> Giá đặt > 0 - Nếu loại lệnh khác LO -> Giá đặt = 0
quantity	number	Yes	Khối lượng đặt
account	string	Yes
requestID	string	Yes
code	number	No	Trading code: PIN, OTP Nếu API Xác thực người dùng input: isSave = false, code bắt buộc điền
deviceId	string	Yes	Định danh thiết bị xuất phát yêu cầu.
userAgent	string	No	Tác nhân người dùng VD: FCTrading

Output

Dữ liệu	Kiểu	Mô tả
message	string	Thông báo trả ra khi call api
status	number	Trạng thái
data	list	List data
requestID	string	ID của lệnh gửi
requestData	string	Dữ liệu yêu cầu
instrumentID	string	mã chứng khoán đặt lệnh
marketID	string	Sàn: VN: thị trường cơ sở VNFE: thị trường phái sinh
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
price	number	Giá đặt lệnh: - Nếu loại lệnh là LO -> Giá đặt > 0 - Nếu loại lệnh khác LO -> Giá đặt = 0
quantity	number	Khối lượng đặt
orderID	string	ID của lệnh
account	string	Số tài khoản

Ví dụ

• Thành công

Input: 
{
requestID: "93235974",
orderID: "12658867",
price: 1410,
quantity: 2,
account: "0901358",
instrumentID: "VN30F2106",
marketID: "VNFE",
buySell: "B",
orderType: "LO"
code:”123456789”,
deviceId: "8C-EC-4B-D3-0B-96",
userAgent: “FCTrading”
}
Output: 
{
message: "Success",
status: 200,
data: {
   requestID: "93235974",
   requestData: {
         orderID: "12658867",
         price: 1410,
         quantity: 2,
         account: "0901358",
         instrumentID: "VN30F2106",
         marketID: "VNFE",
         buySell: "B",
         orderType: "LO"
      }
  }
}

• Trường hợp lỗi

Input: 
{
requestID: "93235971",
orderID: "",
price: 1410,
quantity: 2,
account: "0901358",
instrumentID: "VN30F2106",
marketID: "VNFE",
buySell: "B",
orderType: "LO"
code:”123456789”,
deviceId: "8C-EC-4B-D3-0B-96",
userAgent: “FCTrading”
}
Output: 
{
data: null,
message: "’Order ID’ must not be empty ",
status: 400
}

POST derNewOrder

https://fc-tradeapi.ssi.com.vn/api/v2/Trading/derNewOrder

Dùng để đặt lệnh phái sinh.

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
instrumentID	string	Yes	mã chứng khoán đặt lệnh
market	string	Yes	VNFE: thị trường phái sinh
buySell	string	Yes	B: Buy S: Sell
orderType	string	Yes	Loại lệnh
channelID	string	Yes	Kênh đặt lệnh VD: TA (trader API)
price	number	Yes	Giá đặt lệnh: - Nếu loại lệnh là LO -> Giá đặt > 0 - Nếu loại lệnh khác LO -> Giá đặt = 0
quantity	number	Yes	Khối lượng đặt
account	string	Yes	Số tài khoản muốn đặt lệnh: xxxxxx8: Phái sinh
requestID	string	Yes	ID đặt lệnh trong ngày. Bắt buộc 8 số random
stopOrder	string	Yes	Loại lệnh: True: Đối với lệnh điều kiện False: Đối với lệnh thường
stopPrice	number	Yes	Giá đặt mong muốn cắt lỗ/chốt lãi Nếu stopOrder = true -> stopPrice > 0s
stopType	string	Yes	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	Yes	Bước chốt lỗ, chỉ dùng cho lệnh điều kiện BullBear (stopType = B)
profitStep	number	Yes	Bước chốt lãi, chỉ dùng cho lệnh điện BullBear (stopType = B)
code	number	No	Trading code: PIN, OTP Nếu API Xác thực người dùng input: isSave = false, code bắt buộc điền
deviceId	string	Yes	Thiết bị định danh từ máy tính (lap) khách hàng cài đặt
userAgent	string	No	Tác nhân người dùng VD: FCTrading

Output

Dữ liệu	Kiểu	Mô tả
message	string	Thông báo trả ra khi call api
status	number	Trạng thái
data	list	List data
requestID	string	ID của lệnh gửi
requestData	string	Dữ liệu yêu cầu
instrumentID	string	mã chứng khoán đặt lệnh
market	string	Sàn: VN: thị trường cơ sở VNFE: thị trường phái sinh
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
channelID	string	Kênh đặt lệnh VD: TA (trader API)
price	number	Giá đặt lệnh: - Nếu loại lệnh là LO -> Giá đặt > 0 - Nếu loại lệnh khác LO -> Giá đặt = 0
quantity	number	Khối lượng đặt
account	string	Số tài khoản muốn đặt lệnh: xxxxxx1: Cơ sở xxxxxx8: Phái sinh
requestID	string	ID đặt lệnh trong ngày. Tối đa 8 số random
stopOrder	string	Loại lệnh: True: Đối với lệnh điều kiện False: Đối với lệnh thường
stopPrice	number	Giá đặt mong muốn cắt lỗ/chốt lãi Nếu stopOrder = true -> stopPrice > 0
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	Bước chốt lỗ, chỉ dùng cho lệnh điều kiện BullBear (stopType = B)
profitStep	number	Bước chốt lãi, chỉ dùng cho lệnh điện BullBear (stopType = B)

Ví dụ

• Thành công

Input: 
{  
instrumentID: "VN30F2306",
market: "VNFE",
buySell: "B",
orderType: "LO",
channelID: "TA",
price: 1200,
quantity: 10,
account: "1184418",
stopOrder: false,
stopPrice: 0,
stopType: "string",
stopStep: 0,
lossStep: 0,
profitStep: 0
requestID: "1678198",
code: “123456789”,
deviceId: "8C-EC-4B-D3-0B-96",
userAgent: “FCTrading"
 }
 Output: 
 {
  "message": "Success",
  "status": 200,
  "data": {
    "requestID": "3407154",
    "requestData": {
      "instrumentID": "VN30F2306",
      "market": "VNFE",
      "buySell": "B",
      "orderType": "LO",
      "channelID": "TA",
      "price": 1200,
      "quantity": 100,
      "account": "1184418",
      "stopOrder": false,
      "stopPrice": 0,
      "stopType": "",
      "stopStep": 0,
      "lossStep": 0,
      "profitStep": 0
    }
  }
}

• Trường hợp lỗi

Input: 
{  
instrumentID: "SSI",
market: "VN",
buySell: "B",
orderType: "ATO",
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: "8C-EC-4B-D3-0B-96",
userAgent: “FCTrading”
 }
 Output: 
{
    message: "Price is null or equal zero when order is market order",
    status: 400,
    data: null
}

POST derModifyOrder

https://fc-tradeapi.ssi.com.vn/api/v2/Trading/derModifyOrder

Dùng để sửa lệnh phái sinh.

Thông tin chi tiết

First Tab

Dữ liệu	Kiểu	Bắt buộc	Mô tả
orderID	string	Yes	ID của lệnh
instrumentID	string	Yes	mã chứng khoán đặt lệnh
marketID	string	Yes	Sàn: VNFE: thị trường phái sinh
buySell	string	Yes	buy (B): mua/Sell (S): bán đã đặt theo orderID của lệnh B: Buy S: Sell
orderType	string	Yes	Loại lệnh
channelID	string	Yes	Kênh đặt lệnh VD: TA (trader API)
price	number	Yes	Giá đặt lệnh: - Nếu loại lệnh là LO -> Giá đặt > 0 - Nếu loại lệnh khác LO -> Giá đặt = 0
quantity	number	Yes	Khối lượng đặt
account	string	Yes	Số tài khoản muốn đặt lệnh: xxxxxx8: Phái sinh
requestID	string	Yes	ID đặt lệnh trong ngày. Bắt buộc 8 số random
code	number	No	Trading code: PIN, OTP Nếu API Xác thực người dùng input: isSave = false, code bắt buộc điền
deviceId	string	Yes	Thiết bị định danh từ máy tính (lap) khách hàng cài đặt
userAgent	string	No	Tác nhân người dùng VD: FCTrading

Output

Dữ liệu	Kiểu	Mô tả
message	string	Thông báo trả ra khi call api
status	number	Trạng thái
data	list	List data
requestID	string	ID của lệnh gửi
requestData	string	Dữ liệu yêu cầu
instrumentID	string	mã chứng khoán đặt lệnh
market	string	Sàn: VN: thị trường cơ sở VNFE: thị trường phái sinh
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
price	number	Giá đặt lệnh: - Nếu loại lệnh là LO -> Giá đặt > 0 - Nếu loại lệnh khác LO -> Giá đặt = 0
quantity	number	Khối lượng đặt
orderID	string	ID của lệnh
account	string	Số tài khoản

Ví dụ

• Thành công

Input: 
{
requestID: "93235974",
orderID: "12658867",
price: 1410,
quantity: 3,
account: "1184418",
instrumentID: "VN30F2306",
marketID: "VNFE",
buySell: "B",
orderType: "LO"
code:”123456789”,
deviceId: "8C-EC-4B-D3-0B-96",
userAgent: “FCTrading”
}
Output: 
{
message: "Success",
status: 200,
data: {
   requestID: "93235974",
   requestData: {
         orderID: "12658867",
         price: 1410,
         quantity: 3,
         account: "1184418",
         instrumentID: "VN30F2306",
         marketID: "VNFE",
         buySell: "B",
         orderType: "LO"
      }
  }
}

• Trường hợp lỗi

Input: 
{
requestID: "93235974",
orderID: "",
price: 1410,
quantity: 3,
account: "1184418",
instrumentID: "VN30F2306",
marketID: "VNFE",
buySell: "B",
orderType: "LO"
code:”123456789”,
deviceId: "8C-EC-4B-D3-0B-96",
userAgent: “FCTrading”
}
Output: 
{
data: null,
message: "’Order ID’ must not be empty ",
status: 400
}

POST derCancelOrder

https://fc-tradeapi.ssi.com.vn/api/v2/Trading/derCancelOrder

Dùng để hủy lệnh phái sinh.

Thông tin chi tiết

First Tab

Dữ liệu	Kiểu	Bắt buộc	Mô tả
orderID	string	Yes	ID của lệnh
instrumentID	string	Yes	mã chứng khoán của lệnh
market	string	Yes	VNFE: thị trường phái sinh
buySell	string	Yes	buy (B): mua/Sell (S): bán đã đặt theo orderID của lệnh B: Buy S: Sell
orderType	string	Yes	Loại lệnh
channelID	string	Yes	Kênh đặt lệnh VD: TA (trader API)
price	number	Yes	Giá đặt lệnh: - Nếu loại lệnh là LO -> Giá đặt > 0 - Nếu loại lệnh khác LO -> Giá đặt = 0
quantity	number	Yes	Khối lượng đặt
account	stri
requestID	string	Yes	ID đặt lệnh trong ngày. Bắt buộc 8 số random
code	number	No	Trading code: PIN, OTP Nếu API Xác thực người dùng input: isSave = false, code bắt buộc điền
deviceId	string	Yes	Định dang thiết bị
userAgent	string	No

Output

Dữ liệu	Kiểu	Mô tả
message	string	Thông báo trả ra khi call api
status	number	Trạng thái
data	list	List data
requestID	string	ID của lệnh gửi
requestData	string	Dữ liệu yêu cầu
instrumentID	string	mã chứng khoán đặt lệnh
marketID	string	Sàn: VN: thị trường cơ sở VNFE: thị trường phái sinh
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
price	number	Giá đặt lệnh: - Nếu loại lệnh là LO -> Giá đặt > 0 - Nếu loại lệnh khác LO -> Giá đặt = 0
quantity	number	Khối lượng đặt
orderID	string	ID của lệnh
account	string	Số tài khoản

Ví dụ

• Thành công

Input: 
{
orderID: "12658867",
account: "1184418",
marketID: "VNFE",
instrumentID: "VN30F2306",
buySell: "B",
requestID: "52513603"
code:”123456789”,
deviceId: "8C-EC-4B-D3-0B-96",
userAgent: “FCTrading”
}
Output: 
{
message: "Success",
status: 200,
data: {
    requestID: "52513603",
    requestData: {
         orderID: "12658867",
         account: "1184418",
         marketID: "VNFE",
         instrumentID: "VN30F2106",
         buySell: "B",
         requestID: "52513603"
       }
    }
}

• Trường hợp lỗi

Input: 
{
orderID: " ",
account: "0901358",
marketID: "VNFE",
instrumentID: "VN30F2106",
buySell: "B",
requestID: "52513603"
code:”123456789”,
deviceId: "8C-EC-4B-D3-0B-96",
userAgent: “FCTrading”
}
Output: 
{
message: "’Order ID' must not be empty.",
status: 400,
data: null
}

GET rateLimit

https://fc-tradeapi.ssi.com.vn/api/v2/Trading/rateLimit

Truy vấn thông tin những API được set rateLimit

Thông tin chi tiết

Output

Dữ liệu	Kiểu	Mô tả
message	string	Mô tả msg call API
status	number	Trạng thái
data	list	Thông tin dữ liệu trả ra
endpoint	string	Thông tin set rateLimit bao gồm 1 trong các trường hợp sau: * -> Toàn bộ các API post:* -> Toàn bộ các API method POST get:* -> Toàn bộ các API method GET *:*/api_name -> rateLimit riêng từng API
period	string	Thời gian giới hạn (s,m,h,d)
limit	number	Số lần giới hạn

Ví dụ

Output: 
{
  "message": "Success",
  "status": 200,
  "data": [
    {
      "endpoint": "*",
      "period": "1s",
      "limit": 5
    },
    {
      "endpoint": "*",
      "period": "5s",
      "limit": 30
    }
  ]
}

Giao dịch liên quan đến tiền, Nộp/Rút ký quỹ, Ứng trước tiền bán

GET cashInAdvanceAmount

https://fc-tradeapi.ssi.com.vn/api/v2/cash/cashInAdvanceAmount

Trả danh sách giao dịch Ứng trước tiền bán và thông tin số tiền có thể ứng

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản muốn truy vấn

Output

Dữ liệu	Kiểu	Mô tả
message	string	Mô tả msg call API
status	number	Trạng thái
data	list	Thông tin dữ liệu trả ra
account	string	Số tài khoản
ciaAmounts	list	Thông tin số tiền có thể ứng
dueDate	string	Ngày tiền về Định dạng: dd/mm/yyyy
sellValue	number	Giá trị bán chứng khoán
netSellValue	number	Tiền bán đã trừ phí thuế
advance	number	Tiền đã ứng
cashAdvance	number	Tiền có thể ứng

Ví dụ

Input: 
{
  account: "8888881"
}
Output: 
{
    "message": "Success",
    "status": 200,
    "data": {
        "account": "8888881",
        "ciaAmounts": [
            {
                "dueDate": "08/03/2023",
                "sellValue": 3000000.0,
                "netSellValue": 0.0,
                "advance": 0.0,
                "cashAdvance": 0.0
            }
        ]
    }
}

GET unsettleSoldTransaction

https://fc-tradeapi.ssi.com.vn/api/v2/cash/unsettleSoldTransaction

Trả danh sách giao dịch chưa thanh toán (tiền chưa về tài khoản)

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản nguồn truy vấn
settleDate	string	No	Ngày tất toán Định dạng: dd/mm/yyyy

Output

Dữ liệu	Kiểu	Mô tả
message	string	Mô tả msg call API
status	number	Trạng thái
data	list	Thông tn dữ liệu trả ra
account	string	Số tài khoản
unsettledSoldTransactions	list	Danh sách đã bán chưa xử lý
tradeDate	string	Ngày bán Chứng khoán
instrumentID	string	Mã chứng khoán
netSellValue	number	Tiền bán khớp (đã trừ phí thuế)
quantity	number	Khối lượng
price	number	Giá khớp

Ví dụ

Input: 
{
  account: "8888881",
  settleDate: "10/03/2023"
}
Output: 
{
    "message": "Success",
    "status": 200,
    "data": {
        "account": "8888881",
        "unsettledSoldTransactions": [
            {
                "tradeDate": "08/03/2023",
                "instrumentID": "SSI",
                "quantity": 100,
                "price": 0.0,
                "netSellValue": 1990000.0
            },
            {
                "tradeDate": "08/03/2023",
                "instrumentID": "SSI",
                "quantity": 100,
                "price": 0.0,
                "netSellValue": 1990000.0
            },
            {
                "tradeDate": "08/03/2023",
                "instrumentID": "SSI",
                "quantity": 100,
                "price": 0.0,
                "netSellValue": 117410.0
            }
        ]
    }
}

GET transferHistories

https://fc-tradeapi.ssi.com.vn/api/v2/cash/transferHistories

Tra cứu thông tin Lịch sử chuyển tiền nội bộ và Nộp/Rút kỹ quỹ

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản nguồn truy vấn
fromDate	string	Yes	Ngày bắt đầu tìm kiếm Định dạng: dd/mm/yyyy
toDate	string	Yes	Ngày kết thúc tìm kiếm Định dạng: dd/mm/yyyy

Output

Dữ liệu	Kiểu	Mô tả
message	string	Mô tả msg call API
status	number	Trạng thái
data	list	Thông tn dữ liệu trả ra
transferHistories	list	Danh sách lịch sử chuyển tiền và Nộp/Rút ký quỹ
transactionID	string	Mã chi nhánh ngân hàng
date	string	Ngày thực hiện giao dịch
account	string	Số tài khoản chuyển
beneficiaryAccount	string	Số tài khoản nhận
amount	number	Số tiền
bankName	string	Ngân hàng nhận
bankBranchName	string	Chi nhánh ngân hàng nhận
beneficiary	string	Tên người nhận
remark	string	Nội dung
type	string	Loại giao dịch (Nộp/ Rút)
status	string	Trạng thái chuyển

Ví dụ

Input: 
account:8888881
fromDate: 10/01/2023
toDate: 10/08/2023
Output: 
{
  "message": "Success",
  "status": 200,
  "data": {
    "transferHistories": [
      {
        "transactionID": "101660519",
        "date": "07/03/2023 11:54:22",
        "account": "8888881",
        "beneficiaryAccount": "8888886",
        "amount": 1000000,
        "bankName": "TECHCOMBANK_NH KỸ THƯƠNG",
        "bankBranchName": "CN THANG LONG",
        "beneficiary": "TK tự doanh CK niêm yết (TK 8)",
        "remark": "Huyen test chuyen tien sang 6",
        "type": "W",
        "status": "A"
      }
    ]
  }
}

GET cashInAdvanceHistories

https://fc-tradeapi.ssi.com.vn/api/v2/cash/cashInAdvanceHistories

Truy vấn lịch sử giao dịch ứng trước tiền bán

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản nguồn truy vấn
fromDate	string	Yes	Ngày bắt đầu tìm kiếm Định dạng: dd/mm/yyyy
toDate	string	Yes	Ngày kết thúc tìm kiếm Định dạng: dd/mm/yyyy

Output

Dữ liệu	Kiểu	Mô tả
message	string	Mô tả msg call API
status	number	Trạng thái
data	list	Thông tn dữ liệu trả ra
account	string	Số tài khoản
ciaHistories	list	Danh sách lịch sử ứng trước tiền bán
transactionID	string	Mã chi nhánh ngân hàng
date	string	Ngày thực hiện giao dịch
totalAmount	number	Tổng số tiền đã ứng
status	string	Trạng thái giao dịch
detai	list	Bản ghi lặp lại của giao dịch
type	string	Loại giao dịch (I: Fee và D & W: ciaAmount)
value	number	Số tiền đã ứng trước, phí
settleDate	string	Ngày tiền về của giao dịch Ứng trước tiền bán

Lưu ý:

• Tìm kiếm fromDate - toDate không quá 1 tháng

• Thời gian tìm kiếm quá khứ không quá 6 tháng

Ví dụ

Input: 
account:0001011
fromDate: 10/01/2023
toDate: 10/08/2023
Output: 
{
  "message": "Success",
  "status": 200,
  "data": {
    "account": "0001011",
    "ciaHistories": [
      {
        "transactionID": "20230731-45895",
        "dateTime": "31/07/2023 09:01:56",
        "totalAmount": 200000,
        "details": [
          {
            "type": "D",
            "value": 200000,
            "settleDate": null
          },
          {
            "type": "I",
            "value": 50000,
            "settleDate": null
          },
          {
            "type": "W",
            "value": 200000,
            "settleDate": "01/08/2023"
          }
        ],
        "status": "A"
      }
        ],
        "status": "A"
      }
    ]
  }
}

GET estCashInAdvanceFee

https://fc-tradeapi.ssi.com.vn/api/v2/cash/estCashInAdvanceFee

Truy vấn mức phí của giao dịch Ứng trước tiền bán

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản nguồn truy vấn
ciaAmount	string	No	Số tiền muốn ứng trước
receiveAmount	string	No	Số tiền nhận được

Output

Dữ liệu	Kiểu	Mô tả
message	string	Mô tả msg call API
status	number	Trạng thái
data	list	Thông tn dữ liệu trả ra
account	string	Số tài khoản
ciaAmount	number	Số tiền ứng trước tiền bán
receiveAmount	number	Số tiền nhận được
fee	number	Mức phí

Ví dụ

Input: 
account:0001011
ciaAmount: 50000
Output:
{
  "message": "Success",
  "status": 200,
  "data": {
    "account": "0001011",
    "ciaAmount": 0,
    "receiveAmount": 0,
    "fee": 0
  }
}

POST vsdCashDW

https://fc-tradeapi.ssi.com.vn/api/v2/cash/vsdCashDW

Tạo giao dịch nộp/ rút phái sinh

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản nguồn
amount	number	Yes	Số tiền
type	string	Yes	Loại giao dịch D = Nộp W = Rút
remark	string	No	Mô tả nội dung tạo giao dịch
code	string	No	isSave = false -> Điền PIN/ OTP tùy phương thức xác thực isSave = true -> Không cần điền

Output

Dữ liệu	Kiểu	Mô tả
message	string	Mô tả msg call API
status	number	Trạng thái
data	list	Thông tn dữ liệu trả ra
transactionID	string	Số hiệu giao dịch

Ví dụ

• Thành công

Input: 
{
  "account": "0901358",
  "amount": 50000,
  "type": "D",
  "remark": "string",
  "code": "string"
}
Output: 
{
  "message": "Success",
  "status": 200,
  "data": {
    "transactionID": "579108"
  }
}

• Lỗi

Input: 
{
  "account": "0901351",
  "amount": 50000,
  "type": "D",
  "remark": "string",
  "code":"string"
}
Output: 
{
  "message": "Not support cash transfer with vsd for stock account",
  "status": 400,
  "data": null
}

POST transferInternal

https://fc-tradeapi.ssi.com.vn/api/v2/cash/transferInternal

Tạo giao dịch chuyển tiền giữa các tài khoản Cơ sở hoặc chuyển tiền từ tài khoản Phái sinh sang Cơ sở

Lưu ý:

Số tài khoản nguồn và Số tài khoản nhận phải cùng tên và chỉ được chuyển tiền giữa các tiểu khoản

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản nguồn
beneficiaryAccount	string	Yes	Số tài khoản nhận
amount	number	Yes	Số tiền
type	string	Yes	Loại giao dịch D = Nộp W = Rút
remark	string	No	Mô tả nội dung tạo giao dịch
code	string	No	isSave = false -> Điền PIN/ OTP tùy phương thức xác thực isSave = true -> Không cần điền

Output

Dữ liệu	Kiểu	Mô tả
message	string	Mô tả msg call API
status	number	Trạng thái
data	list	Thông tn dữ liệu trả ra
transactionID	string	Số hiệu giao dịch

Ví dụ

• Thành công

Input: 
{
  "account": "0901351",
  "beneficiaryAccount": "0901356",
  "amount": 50000,
  "remark": "string", 
  "code":"string"
}
Output: 
{
  "message": "Success",
  "status": 200,
  "data": {
    "transactionID": "101844165"
  }
}

• Lỗi

Input: 
{
  "account": "0901351",
  "beneficiaryAccount": "0901356",
  "amount": 50000,
  "remark": "string",
  "code":"string"
}
Output: 
{
  "message": "Account 0901352 is not exist",
  "status": 400,
  "data": null
}

POST createCashInAdvance

https://fc-tradeapi.ssi.com.vn/api/v2/cash/createCashInAdvance

Tạo giao dịch ứng trước tiền bán

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản nguồn truy vấn
ciaAmount	string	No	Số tiền muốn ứng trước
receiveAmount	string	No	Số tiền nhận được
code	string	Yes	Mã OTP/PIN cần nhập trước khi làm giao dịch

Output

Dữ liệu	Kiểu	Mô tả
message	string	Mô tả msg call API
status	number	Trạng thái
data	list	Thông tn dữ liệu trả ra
account	string	Số tài khoản
transactionID	string	Số hiệu giao dịch

Ví dụ

• Thành công

Input: 
{
  "account": "8888881",
  "ciaAmount": 50000,
  "code": 1234567
}
Output: 
{
  "message": "Success",
  "status": 200,
  "data": {
    "account": "1158851",
    "transactionID": "20230824-46286"
  }
}

• Lỗi

Input: 
{
  "account": "8888881",
  "ciaAmount": 50000, 
  "code":1234567
}
Output: 
{
  "message": "Not support derivatives account",
  "status": 400,
  "data": null
}

Giao dịch liên quan đến đăng ký quyền mua

GET dividend

https://fc-tradeapi.ssi.com.vn/api/v2/ors/dividend

Truy vấn thông tin cổ tức bằng tiền, Chứng khoán mà khách hàng được nhận (không phải đăng ký)

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản nguồn truy vấn

Output

Dữ liệu	Kiểu	Mô tả
message	string	Mô tả msg call API
status	number	Trạng thái
data	list	Thông tn dữ liệu trả ra
account	string	Số tài khoản
dividends	list	Danh sách cổ tức
stockDividend	string	Loại hưởng quyền bao gồm: - STOCK DIVIDEND - CASH DIVIDEND - BONUS ISSUE - EXERCISE CW - EXERCISE RIGHTS
instrumentID	string	Mã chứng khoán
quantity	number	Số lượng chứng khoán hưởng quyền
executedRate	string	Tỉ lệ
closeDate	string	Ngày chốt quyền Định dạng: dd/mm/yyyy
paidDate	string	Ngày thực hiện Định dạng: dd/mm/yyyy
amount	number	Số tiền nhận được
status	string	Tình trạng
receivedQuantity	number	Số chứng khoán nhận được
issueInstrument	string	Mã chứng khoán được nhận
distributedFlag	string	Cờ phân bổ
payableDate	string	Ngày dự kiến Định dạng: dd/mm/yyyy
subscriptionPrice	number	Giá đăng ký
subscriptionAmount	number	Số tiền đăng ký
subscriptionQuantity	number	Khối lượng đăng ký
subscriptionPeriodFrom	string	Ngày đăng ký từ Định dạng: dd/mm/yyyy
subscriptionPeriodTo	string	Ngày đăng ký đến Định dạng: dd/mm/yyyy
entitlementID	string	Mã sự kiện quyền

Ví dụ

Input: 
account: 0901351
Output: 
{
  "message": "Success",
  "status": 200,
  "data": {
    "account": "0901351",
    "dividends": [
      {
        "stockDividend": "STOCK DIVIDEND",
        "instrumentID": "SSI",
        "quantity": 49500,
        "executedRate": "100:15",
        "closeDate": "05/10/2020",
        "paidDate": "07/10/2020",
        "amount": 0,
        "status": "A",
        "receivedQuantity": 7425,
        "issueInstrument": "SSI",
        "distributedFlag": "N",
        "payableDate": null,
        "subscriptionPrice": 0,
        "subscriptionAmount": 0,
        "subscriptionQuantity": 0,
        "subscriptionPeriodFrom": null,
        "subscriptionPeriodTo": null,
        "entitlementID": null
      }
      ]
  }
}

GET exercisableQuantity

https://fc-tradeapi.ssi.com.vn/api/v2/ors/exercisableQuantity

Truy vấn số lượng chứng khoán có thể thực hiện đăng ký quyền

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản nguồn truy vấn

Output

Dữ liệu	Kiểu	Mô tả
message	string	Mô tả msg call API
status	number	Trạng thái
data	list	Thông tn dữ liệu trả ra
account	string	Số tài khoản
exercisableQuantities	list	Danh sách số lượng chứng khoán có thể thực hiện
entitlementID	string	Mã quyền
instrumentID	string	Mã chứng khoán
subscriptionPrice	number	Giá mua
executedRateFrom	number	Tỉ lệ từ
subscriptionPeriodFrom	string	Ngày bắt đầu đăng ký quyền Định dạng: dd/mm/yyyy
subscriptionPeriodTo	string	Hạn đăng ký Định dạng: dd/mm/yyyy
exerciseableQuantity	number	Số chứng khoán hưởng quyền
exerciseableReceiveQuantity	number	Số chứng khoán còn được mua
exercisedReceiveQuantity	number	Số chứng khoán đã đăng ký mua
executedRateTo	number	Ngày đăng ký từ Định dạng: dd/mm/yyyy
exercisedQuantity	number	Số lượng thực hiện
payableDate	string	Ngày dự kiến thanh toán Định dạng: dd/mm/yyyy

Ví dụ

Input: 
account: 0901351
Output:
{
  "message": "Success",
  "status": 200,
  "data": {
    "account": "0901351",
    "exercisableQuantities": [
      {
        "entitlementID": "913279",
        "instrumentID": "HCB",
        "subscriptionPrice": 10000,
        "executedRateFrom": 1,
        "subscriptionPeriodFrom": "03/10/2022",
        "subscriptionPeriodTo": "03/10/2023",
        "exerciseableQuantity": 0,
        "exerciseableReceiveQuantity": 0,
        "exercisedReceiveQuantity": 0,
        "executedRateTo": 1,
        "exercisedQuantity": 0,
        "payableDate": null
      }
      ]
  }
}

GET histories

https://fc-tradeapi.ssi.com.vn/api/v2/ors/histories

Truy vấn lịch sử giao dịch đăng ký quyền mua

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản nguồn truy vấn
startDate	string	Yes	Ngày bắt đầu tìm kiếm Định dạng: dd/mm/yyyy
endDate	string	Yes	Ngày kết thúc tìm kiếm Định dạng: dd/mm/yyyy

Output

Dữ liệu	Kiểu	Mô tả
message	string	Mô tả msg call API
status	number	Trạng thái
data	list	Thông tn dữ liệu trả ra
account	string	Số tài khoản
onlineRightSubscriptionHistories	list	Danh sách giao dịch đăng ký quyền mua
transactionID	string	ID của giao dịch
dateTime	string	Thời gian yêu cầu
instrumentID	string	Mã chứng khoán
ratioFrom	number	Tỉ lệ từ
subscriptionPrice	number	Giá mua
subscriptionPeriodFrom	string	Ngày bắt đầu đăng ký Định dạng: dd/mm/yyyy
subscriptionPeriodTo	string	Hạn đăng ký quyền Định dạng: dd/mm/yyyy
exercisedReceivedQty	number	Số chứng khoán đã đăng ký mua
amount	number	Số tiền đã nộp
status	string	Tình trạng
ratioTo	number	Tỉ lệ đến
underlyingInstrumentID	string	Mã chứng khoán tham chiếu

Lưu ý:

• Tìm kiếm startDate - endDate không quá 1 tháng

• Thời gian tìm kiếm quá khứ không quá 1 năm

Ví dụ

Input: 
account: 1158851
startDate: 10/07/2023
endDate: 10/07/2023
Output: 
{
  "message": "Success",
  "status": 200,
  "data": {
    "account": "1158851",
    "onlineRightSubscriptionHistories": []
  }
}

POST create

https://fc-tradeapi.ssi.com.vn/api/v2/ors/create

Tạo giao dịch đăng ký quyền

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản
instrumentID	string	Yes	Mã chứng khoán
entitlementID	string	Yes	Mã quyền
quantity	number	Yes	Khối lượng
amount	number	Yes	Số tiền
code	string	No	Mã OTP/PIN cần nhập trước khi làm giao dịch

Output

Dữ liệu	Kiểu	Mô tả
message	string	Mô tả msg call API
status	number	Trạng thái
data	list	Thông tn dữ liệu trả ra
account	string	Số tài khoản
transactionID	string	Số hiệu giao dịch

Ví dụ

• Thành công

Input: 
{  
   "account": "0901351",  
   "instrumentID": "SSI",  
   "entitlementID": "913312",  
   "quantity": 100,  
   "amount": 1000,
   "code":"569858" 
 }
Output: 
{
  "message": "Success",
  "status": 200,
  "data": {
    "account": "0901351",
    "transactionID": "17509268"
  }
}

• Lỗi

Input: 
{  
   "account": "0901351",  
   "instrumentID": "VND",  
   "entitlementID": "913312",  
   "quantity": 100,  
   "amount": 1000,
   "code":"459865"  
 }
Output: 
{
  "message": "Invalid ammount (max amount 1,459,882)",
  "status": 40006,
  "data": null
}

Giao dịch chuyển chứng khoán

GET transferable

https://fc-tradeapi.ssi.com.vn/api/v2/stock/transferable

Truy vấn thông tin số lượng chứng khoán có thể chuyển nhượng của tài khoản

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản nguồn truy vấn

Output

Dữ liệu	Kiểu	Mô tả
message	string	Mô tả msg call API
status	number	Trạng thái
data	list	Thông tn dữ liệu trả ra
account	string	Số tài khoản
transferableStocks	list	Danh sách thông tin số lượng mã chứng khoán có thể chuyển nhượng
instrumentID	string	Mã chứng khoán
quantity	number	Khối lượng
instrumentType	string	Loại mã chứng khoán

Ví dụ

Input: 
account: 0901351
Output: 
{
  "message": "Success",
  "status": 200,
  "data": {
    "account": "0901351",
    "transferableStocks": [
      {
        "instrumentID": "ACB",
        "quantity": 100,
        "instrumentType": "EQ"
      },
      {
        "instrumentID": "BTS",
        "quantity": 300,
        "instrumentType": "EQ"
      }
    ]
  }
}

GET transferHistories

https://fc-tradeapi.ssi.com.vn/api/v2/stock/transferHistories

Truy vấn lịch sử giao dịch chuyển nhượng chứng khoán giữa các tài khoản

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản nguồn truy vấn
startDate	string	Yes	Ngày bắt đầu tìm kiếm Định dạng: dd/mm/yyyy
endDate	string	Yes	Ngày kết thúc tìm kiếm Định dạng: dd/mm/yyyy

Output

Dữ liệu	Kiểu	Mô tả
message	string	Mô tả msg call API
status	number	Trạng thái
data	list	Thông tn dữ liệu trả ra
account	string	Số tài khoản
stockTransferHistories	list	Danh sách thông tin số lượng mã chứng khoán có thể chuyển nhượng
transactionID	string	ID của giao dịch
beneficiaryAccount	string	Số tài khoản nhận
instrumentID	string	Mã chứng khoán
quantity	number	Khối lượng
dateTime	string	Thời gian thực hiện
status	string	Trạng thái
remark	string	Lý do
auditRemark	string

Lưu ý:

• Tìm kiếm startDate - endDate không quá 1 tháng

• Thời gian tìm kiếm quá khứ không quá 6 tháng

Ví dụ

Input: 
account: 0901351
startDate: 10/07/2023
enđate: 10/08/2023
Output: 
{
  "message": "Success",
  "status": 200,
  "data": {
    "account": "0901351",
    "stockTransferHistories": []
  }
}

POST transfer

https://fc-tradeapi.ssi.com.vn/api/v2/stock/transfer

Tạo giao dịch chuyển chứng khoán có trong danh mục giữa các tài khoản cơ sở

Thông tin chi tiết

Input

Dữ liệu	Kiểu	Bắt buộc	Mô tả
account	string	Yes	Số tài khoản nguồn
beneficiaryAccount	string	Yes	Số tài khoản nhận
exchangeID	string	Yes	Mã sàn
instrumentID	string	Yes	Mã chứng khoán
quantity	number	Yes	Khối lượng
code	string	No	isSave = false -> Điền PIN/ OTP tùy phương thức xác thực isSave = true -> Không cần điền

Output

Dữ liệu	Kiểu	Mô tả
message	string	Mô tả msg call API
status	number	Trạng thái
data	list	Thông tn dữ liệu trả ra
account	string	Số tài khoản
transactionID	string	Số hiệu giao dịch

Ví dụ

• Thành công

Input: 
{
  "account": "0901351",
  "beneficiaryAccount": "0901356",
  "exchangeID": "HOSE",
  "instrumentID": "SSI",
  "quantity": 100,
  "code": "string"
}
Output: 
{
  "message": "Success",
  "status": 200,
  "data": {
    "account": "0901351",
    "transactionID": "462764"
  }
}

• Lỗi

Input: 
{
  "account": "0901351",
  "beneficiaryAccount": "0901356",
  "exchangeID": "HOSE",
  "instrumentID": "SSI",
  "quantity": 100,
  "code": "string"
}
Output: 
{
  "message": "Account 0901352 is not exist",
  "status": 400,
  "data": null
}