# Phái sinh sàn HNX

> API Name: /Market/GetHnxDerivative

{% hint style="info" %}
**Dưới đây là một ví dụ minh họa về cách dữ liệu được trình bày trong API:**

·       "HnxDerivativeId": 345594,

·       "DerivativeCode": "VN30F2009",

·       "StockNo": 0,

·       "TradingDate": "2020-03-17T00:00:00",

·       "StockType": "FU",

·       "CeilingPrice": 717.9,

·       "FloorPrice": 624.1,

·       "ReferencePrice": 671,

·       "ReferenceDate": "2020-03-17T00:00:00",

·       "OpenPrice": 680,

·       "ClosePrice": 696.5,

·       "MatchPrice": 696.5,

·       "MatchVolume": 1,

·       "MatchValue": 69650000,

·       "PriceChange": 25.5,

·       "PercentPriceChange": 0.0380029806,

·       "HighestPrice": 709,

·       "LowestPrice": 671.5,

·       "AveragePrice": 0,

·       "DealVolume": 0,

·       "DealPrice": 0,

·       "TotalMatchVolume": 106,

·       "TotalMatchValue": 7288710000,

·       "TotalDealVolume": 0,

·       "TotalDealValue": 0,

·       "TotalVolume": 106,

·       "TotalValue": 7288710000,

·       "ForeignBuyValueMatched": 0,

·       "ForeignBuyVolumeMatched": 0,

·       "ForeignSellValueMatched": 206700000,

·       "ForeignSellVolumeMatched": 3,

·       "ForeignBuyValueDeal": 0,

·       "ForeignBuyVolumeDeal": 0,

·       "ForeignSellValueDeal": 0,

·       "ForeignSellVolumeDeal": 0,

·       "ForeignBuyValueTotal": 0,

·       "ForeignBuyVolumeTotal": 0,

·       "ForeignSellValueTotal": 206700000,

·       "ForeignSellVolumeTotal": 3,

·       "ForeignTotalRoom": 0,

·       "ForeignCurrentRoom": 0,

·       "Parvalue": 0,

·       "BoardCode": "DER\_BRD\_01",

·       "TradingSessionId": null,

·       "TradSesStatus": 0,

·       "SecurityTradingStatus": -2147483648,

·       "ListingStatus": -2147483648,

·       "TotalBuyTradeVolume": 150,

·       "TotalSellTradeVolume": 126,

·       "PriorOpenPrice": 690.2,

·       "PriorClosePrice": 671,

·       "CurrentPrice": 0,

·       "CurrentVolume": 0,

·       "TotalSellTrade": 175,

·       "TotalBuyTrade": 475,

·       "TotalBuyTradingVolume": 0,

·       "BuyCount": 0,

·       "TotalBuyTradingValue": 0,

·       "TotalSellTradingVolume": 0,

·       "SellCount": 0,

·       "TotalSellTradingValue": 0,

·       "TotalBidQtty\_OD": 0,

·       "TotalOfferQtty\_OD": 0,

·       "Status": 1,

·       "CreateDate": "2020-03-17T15:11:59.88",

·       "UpdateDate": "2020-03-17T15:11:59.88",

·       "SessionStatus": -2147483648,

·       "RecordOrder": 0,

·       "SenderCompID": "HNX",

·       "OpenInterest": 131,

·       "PercentOpenInterestChange": -0.015037594,

·       "FirstTradingDate": "2020-03-17T00:00:00",

·       "LastTradingDate": "2020-03-17T00:00:00",

·       "OpenMatchVolume": 2,

·       "CloseMatchVolume": 6,

·       "ComGroupCode": "VN30",

·       "OrganCode": null,

·       "BondCode": null
{% endhint %}

<table><thead><tr><th width="247.1171875">Tên trường dữ liệu</th><th width="84">Loại dữ liệu</th><th width="108">Độ dài ký tự dữu liệu</th><th width="201">Mô tả (VN)</th><th width="187">Mô tả (EN)</th></tr></thead><tbody><tr><td>HnxDerivativeId</td><td>bigint</td><td></td><td>Khóa chính của bảng auto-generated IDENTITY(1,1)</td><td>Auto-generated key defined by FiinGroup</td></tr><tr><td>DerivativeCode</td><td>nvarchar</td><td>15</td><td>Mã doanh nghiệp theo quy định của StoxPlus</td><td>DerivativeCode</td></tr><tr><td>StockNo</td><td>int</td><td></td><td>Mã chứng khoán dạng số</td><td>StockNo</td></tr><tr><td>TradingDate</td><td>datetime</td><td></td><td>Ngày giao dịch hiện tại theo định dạng yyyyMMdd hh:mm:ss</td><td>Trading Date formatted as yyyyMMdd hh:mm:ss</td></tr><tr><td>StockType</td><td>nvarchar</td><td>5</td><td>Loại chứng khoán:<br>ST: Cổ phiếu<br>BO: Trái phiếu<br>MF: Chứng chỉ quỹ<br>EF: ETF<br>FU : Future<br>OP: Option<br></td><td>Stock Type:<br>ST: Share<br>BO: Bond<br>MF: Fund Certificate<br>EF: ETF<br>FU: Future<br>OP: Option</td></tr><tr><td>CeilingPrice</td><td>decimal</td><td>(18,2)</td><td>Giá trần</td><td>Ceiling Price</td></tr><tr><td>FloorPrice</td><td>decimal</td><td>(18,2)</td><td>Giá sàn</td><td>Floor Price</td></tr><tr><td>ReferencePrice</td><td>decimal</td><td>(18,2)</td><td>Giá tham chiếu</td><td>Reference Price</td></tr><tr><td>ReferenceDate</td><td>date</td><td></td><td>Ngày gd gần nhất trước ngày gd hiện tại</td><td>Last Trading Date</td></tr><tr><td>OpenPrice</td><td>decimal</td><td>(18,2)</td><td>Giá tạm khớp trong đợt KL định kỳ</td><td>Open Price</td></tr><tr><td>ClosePrice</td><td>decimal</td><td>(18,2)</td><td>Giá khớp mở cửa</td><td>Close Price</td></tr><tr><td>MatchPrice</td><td>decimal</td><td>(18,2)</td><td>Giá khớp gần nhất của GD khớp lệnh lô chẵn</td><td>Latest Matching Price of round-lot order-matching</td></tr><tr><td>MatchVolume</td><td>decimal</td><td>(18,0)</td><td>KL khớp gần nhất của GD khớp lệnh lô chăn</td><td>Latest round-lot Order-Matching Volume</td></tr><tr><td>MatchValue</td><td>decimal</td><td>(18,0)</td><td>Giá trị khớp lệnh gần nhất của gd khớp lệnh lô chẵn</td><td>Latest round-lot Order-Matching Value</td></tr><tr><td>PriceChange</td><td>decimal</td><td>(18,2)</td><td>Giá trị thay đổi</td><td>Price Change</td></tr><tr><td>PercentPriceChange</td><td>decimal</td><td>(18,2)</td><td>% thay đổi</td><td>Price Change Percentage</td></tr><tr><td>HighestPrice</td><td>decimal</td><td>(18,2)</td><td>Giá thực hiện cao nhất của GD khớp lệnh và thỏa thuận (lô chẵn)</td><td>Highest Price of order-matching and put-through (round lot)</td></tr><tr><td>LowestPrice</td><td>decimal</td><td>(18,2)</td><td>Giá thực hiện thấp nhất của GD khớp lệnh và thỏa thuận (lô chẵn)</td><td>Lowest Price of order-matching and put-through (round lot)</td></tr><tr><td>AveragePrice</td><td>decimal</td><td>(18,2)</td><td>Giá khớp trung bình</td><td>Average Price</td></tr><tr><td>DealVolume</td><td>decimal</td><td>(18,0)</td><td>Khối lượng thực hiện của giao dịch thỏa thuận (lô chẵn và lẻ)</td><td>Put-through Volume (round and odd lot)</td></tr><tr><td>DealPrice</td><td>decimal</td><td>(18,2)</td><td>Giá thực hiện của giao dịch thỏa thuận lô chẵn</td><td>Round-lot put-through Price</td></tr><tr><td>TotalMatchVolume</td><td>decimal</td><td>(18,0)</td><td>Tổng khối lượng giao dịch thông thường của GD khớp lệnh lô chẵn</td><td>Total round-lot order-matching Volume</td></tr><tr><td>TotalMatchValue</td><td>decimal</td><td>(18,0)</td><td>Tổng giá trị giao dịch thông thường của GD khớp lệnh lô chẵn</td><td>Total round-lot order-matching Value</td></tr><tr><td>TotalDealVolume</td><td>decimal</td><td>(18,0)</td><td>Tổng khối lượng của giao dịch thỏa thuận (lô chẵn và lẻ)</td><td>Total Put-through Volume</td></tr><tr><td>TotalDealValue</td><td>decimal</td><td>(18,0)</td><td>Tổng giá trị của giao dịch thỏa thuận (lô chẵn và lẻ)</td><td>Total Put-through Value</td></tr><tr><td>TotalVolume</td><td>decimal</td><td>(18,0)</td><td>Tổng KL giao dịch của GD khớp lệnh và thỏa thuận (lô chẵn và lẻ)</td><td>Total Volume of order-matching and put-through (round and odd lot)</td></tr><tr><td>TotalValue</td><td>decimal</td><td>(18,0)</td><td>Tổng giá trị giao dịch của GD khớp lệnh và thỏa thuận (lô chẵn và lẻ)</td><td>Total Value of order-matching and put-through (round and odd lot)</td></tr><tr><td>ForeignBuyValueMatched</td><td>decimal</td><td>(18,0)</td><td>Giá trị NĐTNN khớp lệnh mua </td><td>Foreign order-matching Buy Value</td></tr><tr><td>ForeignBuyVolumeMatched</td><td>decimal</td><td>(18,0)</td><td>Khối lượng NĐTNN khớp lệnh mua </td><td>Foreign order-matching Buy Volume</td></tr><tr><td>ForeignSellValueMatched</td><td>decimal</td><td>(18,0)</td><td>Giá trị NĐTNN khớp lệnh bán </td><td>Foreign order-matching Sell Value</td></tr><tr><td>ForeignSellVolumeMatched</td><td>decimal</td><td>(18,0)</td><td>Khối lượng NĐTNN khớp lệnh bán</td><td>Foreign order-matching Sell Volume</td></tr><tr><td>ForeignBuyValueDeal</td><td>decimal</td><td>(18,0)</td><td>Giá trị NĐTNN thỏa thuận mua </td><td>Foreign Put-through Buy Value</td></tr><tr><td>ForeignBuyVolumeDeal</td><td>decimal</td><td>(18,0)</td><td>Khối lượng NĐTNN  thỏa thuận mua </td><td>Foreign Put-through Buy Volume</td></tr><tr><td>ForeignSellValueDeal</td><td>decimal</td><td>(18,0)</td><td>Giá trị NĐTNN  thỏa thuận bán </td><td>Foreign Put-through Sell Value</td></tr><tr><td>ForeignSellVolumeDeal</td><td>decimal</td><td>(18,0)</td><td>Khối lượng NĐTNN  thỏa thuận bán</td><td>Foreign Put-through Sell Volume</td></tr><tr><td>ForeignBuyValueTotal</td><td>decimal</td><td>(18,0)</td><td>Tổng giá trị mua khớp của NĐTNN. Áp dụng cho GD khớp lệnh và thỏa thuận (lô chẵn và lẻ)</td><td>Total Foreign Buy Value. Applying for order-matching and put-through (round and odd lot)</td></tr><tr><td>ForeignBuyVolumeTotal</td><td>decimal</td><td>(18,0)</td><td>Tổng khối lượng mua khớp của NĐT NN. Áp dụng cho GD khớp lệnh và thỏa thuận (lô chẵn và lẻ)</td><td>Total Foreign Buy Volume. Applying for order-matching and put-through (round and odd lot)</td></tr><tr><td>ForeignSellValueTotal</td><td>decimal</td><td>(18,0)</td><td>Tổng giá trị bán khớp của NĐTNN. Áp dụng cho GD khớp lệnh và thỏa thuận (lô chẵn và lẻ)</td><td>Total Foreign Sell Value. Applying for order-matching and put-through (round and odd lot)</td></tr><tr><td>ForeignSellVolumeTotal</td><td>decimal</td><td>(18,0)</td><td>Tổng khối lượng bán khớp của NĐT NN. Áp dụng cho GD khớp lệnh và thỏa thuận (lô chẵn và lẻ)</td><td>Total Foreign Sell Volume. Applying for order-matching and put-through (round and odd lot)</td></tr><tr><td>ForeignTotalRoom</td><td>decimal</td><td>(18,0)</td><td>Tổng Room NĐTNN được phép mua</td><td>Total Foreign Room</td></tr><tr><td>ForeignCurrentRoom</td><td>decimal</td><td>(18,0)</td><td>Số lượng còn lại cho phép NDTNN đặt lệnh mua</td><td>Current Foreign Room</td></tr><tr><td>Parvalue</td><td>int</td><td></td><td>Mệnh giá chứng khoán (=10.000vnđ)</td><td>Par Value (=VND10,000)</td></tr><tr><td>BoardCode</td><td>nvarchar</td><td>50</td><td>Mã bảng giao dịch của chứng khoán</td><td>BoardCode</td></tr><tr><td>TradingSessionId</td><td>nvarchar</td><td>50</td><td>Mã phiên giao dịch</td><td>TradingSessionId</td></tr><tr><td>TradSesStatus</td><td>int</td><td></td><td>Trạng thái giao dịch</td><td>TradSesStatus</td></tr><tr><td>SecurityTradingStatus</td><td>Int</td><td></td><td>Trạng thái chứng khoán</td><td>Security Trading Status</td></tr><tr><td>ListingStatus</td><td>Int</td><td></td><td>Tình trạng chứng khoán</td><td>Listing Status</td></tr><tr><td>TotalBuyTradeVolume</td><td>decimal</td><td>(18,0)</td><td>Tổng KL đặt mua của GD khớp lệnh lô chẵn(trừ khối lượng sửa, hủy)</td><td>Total Buy Trade Volume</td></tr><tr><td>TotalSellTradeVolume</td><td>decimal</td><td>(18,0)</td><td>Tổng KL đặt bán của GD khớp lệnh lô chẵn(trừ khối lượng sửa, hủy)</td><td>Total Sell Trade Volume</td></tr><tr><td>PriorOpenPrice</td><td>decimal</td><td>(18,2)</td><td>Giá mở cửa phiên giao dịch trước phiên giao dịch hiện tại</td><td>Prior Open Price</td></tr><tr><td>PriorClosePrice</td><td>decimal</td><td>(18,2)</td><td>Gía đóng cửa phiên trước phiên giao dịch hiện tại</td><td>Prior Close Price</td></tr><tr><td>CurrentPrice</td><td>decimal</td><td>(18,2)</td><td>Giá khớp của phiên định kỳ. Khi chưa kết thúc phiên định kỳ thì là giá dự kiến khớp</td><td>Traded Price of regular session. When trading session is not closed yet, it is expectedly traded price</td></tr><tr><td>CurrentVolume</td><td>decimal</td><td>(18,0)</td><td>Khối lượng khớp của phiên định kỳ. Khi chưa kết thúc phiên định kỳ thì là khối lượng dự kiến khớp</td><td>Traded Price of regular session. When trading session is not closed yet, it is expectedly traded price</td></tr><tr><td>TotalSellTrade</td><td> int</td><td></td><td>Tổng số lệnh đặt bán của GD khớp lệnh lô chẵn</td><td>Sell Trade Order</td></tr><tr><td>TotalBuyTrade</td><td> int</td><td></td><td>Tổng số lệnh đặt mua của GD khớp lệnh lô chẵn</td><td>Buy Trade Order</td></tr><tr><td>TotalBuyTradingVolume</td><td>decimal</td><td>(18,0)</td><td>Tổng khối lượng mua khớp của GD khớp lệnh và thỏa thuận (lô chẵn và lẻ)</td><td>Total Buy Trading Volume of order-matching and put-through (round and odd lot)</td></tr><tr><td>BuyCount</td><td> int</td><td></td><td>Tổng số lệnh mua khớp của GD khớp lệnh và thỏa thuân (lô chẵn và lẻ)</td><td>Buy Count of order-matching and put-through (round and odd lot)</td></tr><tr><td>TotalBuyTradingValue</td><td>decimal</td><td>(18,0)</td><td>Tổng giá trị mua khớp của GD khớp lệnh và thỏa thuận (lô chẵn và lẻ)</td><td>Total Buy Trading Value of order-matching and put-through (round and odd lot)</td></tr><tr><td>TotalSellTradingVolume</td><td>decimal</td><td>(18,0)</td><td>Tổng khối lượng bán khớp của GD khớp lệnh và thỏa thuân (lô chẵn và lẻ)</td><td>Total Sell Trading Volume of order-matching and put-through (round and odd lot)</td></tr><tr><td>SellCount</td><td> int</td><td></td><td>Tổng số lệnh bán khớp của GD khớp lệnh và thỏa thuân (lô chẵn và lẻ)</td><td>Sell Count of order-matching and put-through (round and odd lot)</td></tr><tr><td>TotalSellTradingValue</td><td>decimal</td><td>(18,0)</td><td>Tổng giá trị bán khớp của GD khớp lệnh và thỏa thuận (lô chẵn và lẻ)</td><td>Total Sell Trading Value of order-matching and put-through (round and odd lot)</td></tr><tr><td>TotalBidQtty_OD</td><td>decimal</td><td>(18,0)</td><td>Tổng KL đặt mua của GD khớp lệnh lô lẻ(trừ khối lượng sửa, hủy)</td><td>Total Bid Volume of odd-lot order-matching (excluding correction and cancellation)</td></tr><tr><td>TotalOfferQtty_OD</td><td>decimal</td><td>(18,0)</td><td>Tổng KL đặt bán của GD khớp lệnh lô lẻ(trừ khối lượng sửa, hủy)</td><td>Total Offer Volume of odd-lot order-matching (excluding correction and cancellation)</td></tr><tr><td>Status</td><td>tinyint</td><td></td><td>Trạng thái của bản ghi. 0: record khóa; 1: record mở; 2: record đã xóa </td><td>Record Status. 0: locked; 1: open; 2: deleted</td></tr><tr><td>CreateDate</td><td>datetime</td><td></td><td>Ngày tạo record </td><td>Created Date</td></tr><tr><td>UpdateDate</td><td>datetime</td><td></td><td>Ngày cập nhật record </td><td>Updated Date</td></tr><tr><td>SessionStatus</td><td>tinyint</td><td></td><td>Trạng thái phiên giao dịch. 97 đóng phiên</td><td>SessionStatus</td></tr><tr><td>RecordOrder</td><td>int</td><td></td><td>Order của từng bản ghi theo index</td><td>RecordOrder</td></tr><tr><td>SenderCompID</td><td>nvarchar</td><td>30</td><td>ID người gửi. Nếu là message do HNX gửi thì giá trị là “HNX”</td><td>SenderCompID</td></tr><tr><td>OpenInterest</td><td>decimal</td><td>(18,10)</td><td>Khối lượng mở OI</td><td></td></tr><tr><td>PercentOpenInterestChange</td><td>decimal</td><td>(18,10)</td><td>Thay đổi OI (%)</td><td>Percent Open Interest Change %</td></tr><tr><td>FirstTradingDate</td><td>date</td><td></td><td>Ngày giao dịch đầu tiên</td><td>FirstTradingDate</td></tr><tr><td>LastTradingDate</td><td>date</td><td></td><td>Ngày giao dịch cuối cùng</td><td>LastTradingDate</td></tr><tr><td>OpenMatchVolume</td><td>decimal</td><td>(18,0)</td><td>Khối lượng khớp lệnh mở cửa</td><td>OpenMatchVolume</td></tr><tr><td>CloseMatchVolume</td><td>decimal</td><td>(18,0)</td><td>Khối lượng khớp lệnh đóng cửa</td><td>CloseMatchVolume</td></tr><tr><td>ComGroupCode</td><td>nvarchar</td><td>15</td><td>Tài sản cơ sở Index (VN30, HNX30)</td><td>Index Code in API CompanyGroup</td></tr><tr><td>OrganCode</td><td>nvarchar</td><td>15</td><td>Tài sản cơ sở Stock (ABT)</td><td>Organization Code defined by FiinGroup</td></tr><tr><td>BondCode</td><td>nvarchar</td><td>15</td><td>Tài sản cơ sở Bond (..)</td><td>BondCode</td></tr></tbody></table>
