Dòng tiền nước ngoài - Cổ phiếu

API cung cấp giá trị mua/bán của nhà đầu tư nước ngoài theo mã cổ phiếu, lấy các phiên gần nhất tính đến ngày yêu cầu (sắp xếp giảm dần theo ngày).

HTTP request

• URL: /api/historical/v1/partner/foreign-flows/stock
• Method: GET
• Content Type: application/json
• Response Type: application/json

Tham số header

Header	Mô tả	Kiểu dữ liệu	Bắt buộc
X-Api-Key	Khóa duy nhất.	string	có

Tham Số Truy Vấn (Query Parameters)

Tên Tham Số	Kiểu Dữ Liệu	Bắt buộc	Mô Tả
ticker	string	có	Mã cổ phiếu
tradeDate	string	có	Ngày mốc, định dạng yyyy-MM-dd. Lấy các phiên có ngày nhỏ hơn hoặc bằng ngày này
limit	number	không	Số phiên tối đa trả về (mặc định 20)

Phản Hồi (Response)

Response Mẫu

{
  "status": 200,
  "message": "Success",
  "data": [
    {
      "date": "2024-01-05",
      "ticker": "HPG",
      "buyForeignValue": 152340000000,
      "sellForeignValue": 98120000000
    },
    {
      "date": "2024-01-04",
      "ticker": "HPG",
      "buyForeignValue": 130250000000,
      "sellForeignValue": 110430000000
    }
  ]
}

Chi Tiết Tham Số Response

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
status	number	Mã trạng thái HTTP
message	string	Thông báo kết quả xử lý
data	array (Xem chi tiết)	Danh sách dòng tiền nước ngoài

Cấu trúc thuộc tính data

Quay lại

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
date	string	Ngày giao dịch, định dạng yyyy-MM-dd
ticker	string	Mã cổ phiếu
buyForeignValue	number	Giá trị mua của nhà đầu tư nước ngoài
sellForeignValue	number	Giá trị bán của nhà đầu tư nước ngoài