# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://datafeed.fiingroup.vn/api-giao-dich/chung-quyen/chung-quyen/nha-dau-tu-nuoc-ngoai.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.