# Nhà đầu tư nước ngoài

> API Name: /Market/GetCWForeignInvestor

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

{% tabs %}
{% tab title="Ví dụ 1" %}
·       "HnxStockId": 1752293,

·       "OrganCode": "AAV",

·       "Ticker": "AAV",

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

·       "StockType": "ST",

·       "ForeignBuyValueMatched": 0,

·       "ForeignBuyVolumeMatched": 0,

·       "ForeignSellValueMatched": 0,

·       "ForeignSellVolumeMatched": 0,

·       "ForeignBuyValueDeal": 0,

·       "ForeignBuyVolumeDeal": 0,

·       "ForeignSellValueDeal": 0,

·       "ForeignSellVolumeDeal": 0,

·       "ForeignBuyValueTotal": 0,

·       "ForeignBuyVolumeTotal": 0,

·       "ForeignSellValueTotal": 0,

·       "ForeignSellVolumeTotal": 0,

·       "ForeignTotalRoom": 0,

·       "ForeignCurrentRoom": 0,

·       "Status": 1,

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

·       "UpdateDate": "2020-03-17T15:11:09.47"
{% endtab %}

{% tab title="Ví dụ 2" %}
·       "HoseStockId": 2623658,

·       "OrganCode": "AAA",

·       "Ticker": "AAA",

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

·       "StockType": "S",

·       "ForeignBuyValueMatched": 65600000,

·       "ForeignBuyVolumeMatched": 6000,

·       "ForeignSellValueMatched": 223000000,

·       "ForeignSellVolumeMatched": 20000,

·       "ForeignBuyValueDeal": 0,

·       "ForeignBuyVolumeDeal": 0,

·       "ForeignSellValueDeal": 0,

·       "ForeignSellVolumeDeal": 0,

·       "ForeignBuyValueTotal": 65600000,

·       "ForeignBuyVolumeTotal": 6000,

·       "ForeignSellValueTotal": 223000000,

·       "ForeignSellVolumeTotal": 20000,

·       "ForeignTotalRoom": 67709590,

·       "ForeignCurrentRoom": 63568820,

·       "Status": 1,

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

·       "UpdateDate": "2020-03-17T17:01:05.75"
{% endtab %}

{% tab title="Ví dụ 3" %}
·       "UpcomStockId": 1271691,    

·       "OrganCode": "ABI",  

·       "Ticker": "ABI",           

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

·       "StockType": "ST",     

·       "ForeignBuyValueMatched": 17700000,        

·       "ForeignBuyVolumeMatched": 700,  

·       "ForeignSellValueMatched": 5350000,          

·       "ForeignSellVolumeMatched": 200,   

·       "ForeignBuyValueDeal": 0,    

·       "ForeignBuyVolumeDeal": 0, 

·       "ForeignSellValueDeal": 0,    

·       "ForeignSellVolumeDeal": 0, 

·       "ForeignBuyValueTotal": 17700000,  

·       "ForeignBuyVolumeTotal": 700,         

·       "ForeignSellValueTotal": 5350000,    

·       "ForeignSellVolumeTotal": 200,         

·       "ForeignTotalRoom": 18620000,        

·       "ForeignCurrentRoom": 15381390,   

·       "Status": 1,     

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

·       "UpdateDate": "2020-03-17T15:11:18.457"   
{% endtab %}
{% endtabs %}

<table><thead><tr><th width="339.13671875">Tên trường dữ liệu</th><th width="115.66796875">Loại dữ liệu</th><th width="107">Độ dài ký tự dữ liệu</th><th width="201">Mô tả (VN)</th><th width="187">Mô tả (EN)</th></tr></thead><tbody><tr><td>HnxStockId/HoseStockId/UpcomStockId</td><td>bigint</td><td>8</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>OrganCode</td><td>nvarchar</td><td>15</td><td>Mã doanh nghiệp theo quy định của StoxPlus</td><td>Organization Code defined by FiinGroup</td></tr><tr><td>Ticker</td><td>nvarchar</td><td>20</td><td>Mã chứng khoán</td><td>Stock Code</td></tr><tr><td>TradingDate</td><td>datetime</td><td>8</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>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>Status</td><td>tinyint</td><td>1</td><td>Trạng thái của bản ghi. 0: record khóa; 1: record mở; 2: record đã xóa </td><td>The record status: 0: Locked; 1: Open; 2: Deleted</td></tr><tr><td>CreateDate</td><td>datetime</td><td>8</td><td>Ngày tạo record </td><td>The first created date</td></tr><tr><td>UpdateDate</td><td>datetime</td><td>8</td><td>Ngày cập nhật record </td><td>The last updated date</td></tr></tbody></table>