Biểu đồ nhiệt

API cung cấp dữ liệu heatmap theo ngành kinh tế để hiển thị hiệu suất và giao dịch của các công ty theo từng lĩnh vực

HTTP request

• URL: /api/historical/v1/partner/market/heatmap
• 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	Mô Tả
filter	string	Tiêu chí lọc: - market_cap_vnd: vốn hóa thị trường - volume: khối lượng giao dịch - transaction_value: giá trị giao dịch
stockExchange	string	Sàn giao dịch: - HOSE: Sàn HOSE - HNX: Sàn HNX - UPCOM: Sàn UPCOM - (để trống): toàn thị trường
period	string	Khoảng thời gian: - 1D: 1 ngày - 1W: 1 tuần - 1M: 1 tháng - 3M: 3 tháng - YTD: từ đầu năm - ALL: tất cả

Phản Hồi (Response)

Response Mẫu

{
  "status": 200,
  "message": "Success",
  "data": [
    {
      "bcEconomicSectorId": 1,
      "bcEconomicSectorName": "Năng lượng",
      "companies": [
        {
          "ticker": "BSR",
          "companyName": " CTCP Lọc Hóa dầu Bình Sơn",
          "marketCapVnd": 92084838595200,
          "transactionValue": 1705982920000,
          "volume": 60028200,
          "bcEconomicSectorId": 1,
          "bcEconomicSectorName": "Năng lượng",
          "stockExchange": "HOSTC",
          "outstandingShares": 3100499616,
          "priceReference": 27800,
          "priceCeiling": 29700,
          "priceFloor": 25900,
          "priceClose": 29700,
          "netChange": 1900,
          "pctChange": 6.83,
          "pctChangePeriod": 6.83
        },
        {
          "ticker": "PVS",
          "companyName": " Tổng CTCP Dịch Vụ Kỹ Thuật Dầu Khí Việt Nam",
          "marketCapVnd": 16872210037000,
          "transactionValue": 417504480000,
          "volume": 11659900,
          "bcEconomicSectorId": 1,
          "bcEconomicSectorName": "Năng lượng",
          "stockExchange": "HASTC",
          "outstandingShares": 477966290,
          "priceReference": 37000,
          "priceCeiling": 40700,
          "priceFloor": 33300,
          "priceClose": 35300,
          "netChange": -1700,
          "pctChange": -4.59,
          "pctChangePeriod": -4.59
        },
        {
          "ticker": "PVD",
          "companyName": "Tổng Công ty Cổ phần Khoan và Dịch vụ Khoan Dầu khí",
          "marketCapVnd": 12340536133200,
          "transactionValue": 283855795000,
          "volume": 12728300,
          "bcEconomicSectorId": 1,
          "bcEconomicSectorName": "Năng lượng",
          "stockExchange": "HOSTC",
          "outstandingShares": 555880006,
          "priceReference": 22950,
          "priceCeiling": 24550,
          "priceFloor": 21350,
          "priceClose": 22200,
          "netChange": -750,
          "pctChange": -3.27,
          "pctChangePeriod": -3.27
        },
        {
          "ticker": "PLX",
          "companyName": "Tập đoàn Xăng dầu Việt Nam",
          "marketCapVnd": 47011912695000,
          "transactionValue": 183243135000,
          "volume": 4907300,
          "bcEconomicSectorId": 1,
          "bcEconomicSectorName": "Năng lượng",
          "stockExchange": "HOSTC",
          "outstandingShares": 1270592235,
          "priceReference": 38350,
          "priceCeiling": 41000,
          "priceFloor": 35700,
          "priceClose": 37000,
          "netChange": -1350,
          "pctChange": -3.52,
          "pctChangePeriod": -3.52
        },
        {
          "ticker": "PVT",
          "companyName": "Tổng Công ty Cổ phần Vận tải Dầu khí",
          "marketCapVnd": 8623338114700,
          "transactionValue": 149080635000,
          "volume": 8056700,
          "bcEconomicSectorId": 1,
          "bcEconomicSectorName": "Năng lượng",
          "stockExchange": "HOSTC",
          "outstandingShares": 469936682,
          "priceReference": 19000,
          "priceCeiling": 20300,
          "priceFloor": 17700,
          "priceClose": 18350,
          "netChange": -650,
          "pctChange": -3.42,
          "pctChangePeriod": -3.42
        },
        {
          "ticker": "GAS",
          "companyName": "Tổng Công ty Khí Việt Nam - Công ty Cổ phần",
          "marketCapVnd": 156867331550100,
          "transactionValue": 115878150000,
          "volume": 1685400,
          "bcEconomicSectorId": 1,
          "bcEconomicSectorName": "Năng lượng",
          "stockExchange": "HOSTC",
          "outstandingShares": 2296739847,
          "priceReference": 69900,
          "priceCeiling": 74700,
          "priceFloor": 65100,
          "priceClose": 68300,
          "netChange": -1600,
          "pctChange": -2.29,
          "pctChangePeriod": -2.29
        },
        {
          "ticker": "PVC",
          "companyName": " Tổng Công ty Hóa chất và Dịch vụ Dầu khí",
          "marketCapVnd": 1014930787500,
          "transactionValue": 44096280000,
          "volume": 3507800,
          "bcEconomicSectorId": 1,
          "bcEconomicSectorName": "Năng lượng",
          "stockExchange": "HASTC",
          "outstandingShares": 81194463,
          "priceReference": 12900,
          "priceCeiling": 14100,
          "priceFloor": 11700,
          "priceClose": 12500,
          "netChange": -400,
          "pctChange": -3.1,
          "pctChangePeriod": -3.1
        },
        {
          "ticker": "OIL",
          "companyName": " Tổng Công ty Dầu Việt Nam",
          "marketCapVnd": 12927868750000,
          "transactionValue": 32808160000,
          "volume": 2606700,
          "bcEconomicSectorId": 1,
          "bcEconomicSectorName": "Năng lượng",
          "stockExchange": "UPCOM",
          "outstandingShares": 1034229500,
          "priceReference": 12800,
          "priceCeiling": 14700,
          "priceFloor": 10900,
          "priceClose": 12500,
          "netChange": -300,
          "pctChange": -2.34,
          "pctChangePeriod": -2.34
        },
        {
          "ticker": "PLC",
          "companyName": " Tổng Công ty Hóa dầu Petrolimex",
          "marketCapVnd": 2310810387600,
          "transactionValue": 27209680000,
          "volume": 937800,
          "bcEconomicSectorId": 1,
          "bcEconomicSectorName": "Năng lượng",
          "stockExchange": "HASTC",
          "outstandingShares": 80797566,
          "priceReference": 30000,
          "priceCeiling": 33000,
          "priceFloor": 27000,
          "priceClose": 28600,
          "netChange": -1400,
          "pctChange": -4.67,
          "pctChangePeriod": -4.67
        }
      ]
    },
    {
      "bcEconomicSectorId": 2,
      "bcEconomicSectorName": "Nguyên vật liệu",
      "companies": [
        {
          "ticker": "HPG",
          "companyName": "Công ty Cổ phần Tập đoàn Hòa Phát",
          "marketCapVnd": 175257255480000,
          "transactionValue": 2790729000000,
          "volume": 101007400,
          "bcEconomicSectorId": 2,
          "bcEconomicSectorName": "Nguyên vật liệu",
          "stockExchange": "HOSTC",
          "outstandingShares": 6396250200,
          "priceReference": 28150,
          "priceCeiling": 30100,
          "priceFloor": 26200,
          "priceClose": 27400,
          "netChange": -750,
          "pctChange": -2.66,
          "pctChangePeriod": -2.66
        },
        {
          "ticker": "DCM",
          "companyName": "Công ty Cổ phần Phân bón Dầu khí Cà Mau",
          "marketCapVnd": 21440700000000,
          "transactionValue": 485329400000,
          "volume": 12011700,
          "bcEconomicSectorId": 2,
          "bcEconomicSectorName": "Nguyên vật liệu",
          "stockExchange": "HOSTC",
          "outstandingShares": 529400000,
          "priceReference": 42000,
          "priceCeiling": 44900,
          "priceFloor": 39100,
          "priceClose": 40500,
          "netChange": -1500,
          "pctChange": -3.57,
          "pctChangePeriod": -3.57
        },
        {
          "ticker": "NKG",
          "companyName": "Công ty Cổ phần Thép Nam Kim",
          "marketCapVnd": 4251936566900,
          "transactionValue": 481439580000,
          "volume": 29450800,
          "bcEconomicSectorId": 2,
          "bcEconomicSectorName": "Nguyên vật liệu",
          "stockExchange": "HOSTC",
          "outstandingShares": 263277806,
          "priceReference": 16950,
          "priceCeiling": 18100,
          "priceFloor": 15800,
          "priceClose": 16150,
          "netChange": -800,
          "pctChange": -4.72,
          "pctChangePeriod": -4.72
        },
        {
          "ticker": "DGC",
          "companyName": "Công ty Cổ phần Tập đoàn Hóa chất Đức Giang",
          "marketCapVnd": 37598062887000,
          "transactionValue": 459044680000,
          "volume": 4601200,
          "bcEconomicSectorId": 2,
          "bcEconomicSectorName": "Nguyên vật liệu",
          "stockExchange": "HOSTC",
          "outstandingShares": 379778413,
          "priceReference": 102200,
          "priceCeiling": 109300,
          "priceFloor": 95100,
          "priceClose": 99000,
          "netChange": -3200,
          "pctChange": -3.13,
          "pctChangePeriod": -3.13
        },
        {
          "ticker": "HSG",
          "companyName": "Công ty Cổ phần Tập đoàn Hoa Sen",
          "marketCapVnd": 11705516524650,
          "transactionValue": 366923830000,
          "volume": 19333100,
          "bcEconomicSectorId": 2,
          "bcEconomicSectorName": "Nguyên vật liệu",
          "stockExchange": "HOSTC",
          "outstandingShares": 620982309,
          "priceReference": 19600,
          "priceCeiling": 20950,
          "priceFloor": 18250,
          "priceClose": 18850,
          "netChange": -750,
          "pctChange": -3.83,
          "pctChangePeriod": -3.83
        },
        {
          "ticker": "DPM",
          "companyName": "Tổng Công ty Phân bón và Hóa chất Dầu khí - Công ty Cổ phần",
          "marketCapVnd": 10761692150000,
          "transactionValue": 203419510000,
          "volume": 7342100,
          "bcEconomicSectorId": 2,
          "bcEconomicSectorName": "Nguyên vật liệu",
          "stockExchange": "HOSTC",
          "outstandingShares": 391334260,
          "priceReference": 28250,
          "priceCeiling": 30200,
          "priceFloor": 26300,
          "priceClose": 27500,
          "netChange": -750,
          "pctChange": -2.65,
          "pctChangePeriod": -2.65
        },
        {
          "ticker": "VGS",
          "companyName": " Công ty Cổ Phần Ống thép Việt Đức VGPIPE",
          "marketCapVnd": 1705929843000,
          "transactionValue": 110540570000,
          "volume": 3573100,
          "bcEconomicSectorId": 2,
          "bcEconomicSectorName": "Nguyên vật liệu",
          "stockExchange": "HASTC",
          "outstandingShares": 55932126,
          "priceReference": 32300,
          "priceCeiling": 35500,
          "priceFloor": 29100,
          "priceClose": 30500,
          "netChange": -1800,
          "pctChange": -5.57,
          "pctChangePeriod": -5.57
        },
        {
          "ticker": "EVG",
          "companyName": "Công ty Cổ phần Tập đoàn Everland",
          "marketCapVnd": 2206310819000,
          "transactionValue": 107804235000,
          "volume": 10418600,
          "bcEconomicSectorId": 2,
          "bcEconomicSectorName": "Nguyên vật liệu",
          "stockExchange": "HOSTC",
          "outstandingShares": 215249836,
          "priceReference": 11000,
          "priceCeiling": 11750,
          "priceFloor": 10250,
          "priceClose": 10250,
          "netChange": -750,
          "pctChange": -6.82,
          "pctChangePeriod": -6.82
        },
        {
          "ticker": "KSB",
          "companyName": "Công ty Cổ phần Khoáng sản và Xây dựng Bình Dương",
          "marketCapVnd": 2220207838200,
          "transactionValue": 95292990000,
          "volume": 4888600,
          "bcEconomicSectorId": 2,
          "bcEconomicSectorName": "Nguyên vật liệu",
          "stockExchange": "HOSTC",
          "outstandingShares": 114443703,
          "priceReference": 20150,
          "priceCeiling": 21550,
          "priceFloor": 18750,
          "priceClose": 19400,
          "netChange": -750,
          "pctChange": -3.72,
          "pctChangePeriod": -3.72
        },
        {
          "ticker": "DDV",
          "companyName": " CTCP DAP",
          "marketCapVnd": 4602461850000,
          "transactionValue": 80030010000,
          "volume": 2510700,
          "bcEconomicSectorId": 2,
          "bcEconomicSectorName": "Nguyên vật liệu",
          "stockExchange": "UPCOM",
          "outstandingShares": 146109900,
          "priceReference": 33100,
          "priceCeiling": 38000,
          "priceFloor": 28200,
          "priceClose": 31500,
          "netChange": -1600,
          "pctChange": -4.83,
          "pctChangePeriod": -4.83
        },
        {
          "ticker": "BFC",
          "companyName": "Công ty Cổ phần Phân bón Bình Điền",
          "marketCapVnd": 2732630065400,
          "transactionValue": 74447380000,
          "volume": 1564500,
          "bcEconomicSectorId": 2,
          "bcEconomicSectorName": "Nguyên vật liệu",
          "stockExchange": "HOSTC",
          "outstandingShares": 57167993,
          "priceReference": 47250,
          "priceCeiling": 50500,
          "priceFloor": 43950,
          "priceClose": 47800,
          "netChange": 550,
          "pctChange": 1.16,
          "pctChangePeriod": 1.16
        },
        {
          "ticker": "CSV",
          "companyName": "Công ty Cổ phần Hóa chất cơ bản miền Nam",
          "marketCapVnd": 3795671908500,
          "transactionValue": 70112090000,
          "volume": 2023400,
          "bcEconomicSectorId": 2,
          "bcEconomicSectorName": "Nguyên vật liệu",
          "stockExchange": "HOSTC",
          "outstandingShares": 110499910,
          "priceReference": 35400,
          "priceCeiling": 37850,
          "priceFloor": 32950,
          "priceClose": 34350,
          "netChange": -1050,
          "pctChange": -2.97,
          "pctChangePeriod": -2.97
        },
        {
          "ticker": "AAA",
          "companyName": "Công ty Cổ phần Nhựa An Phát Xanh",
          "marketCapVnd": 3134650867200,
          "transactionValue": 43845505000,
          "volume": 5298100,
          "bcEconomicSectorId": 2,
          "bcEconomicSectorName": "Nguyên vật liệu",
          "stockExchange": "HOSTC",
          "outstandingShares": 382274496,
          "priceReference": 8500,
          "priceCeiling": 9090,
          "priceFloor": 7910,
          "priceClose": 8200,
          "netChange": -300,
          "pctChange": -3.53,
          "pctChangePeriod": -3.53
        },
        {
          "ticker": "MSR",
          "companyName": "CTCP Masan High-Tech Materials",
          "marketCapVnd": 22422770568000,
          "transactionValue": 41018700000,
          "volume": 2021600,
          "bcEconomicSectorId": 2,
          "bcEconomicSectorName": "Nguyên vật liệu",
          "stockExchange": "UPCOM",
          "outstandingShares": 1099155420,
          "priceReference": 20400,
          "priceCeiling": 23400,
          "priceFloor": 17400,
          "priceClose": 20400,
          "netChange": 0,
          "pctChange": 0,
          "pctChangePeriod": 0
        },
        {
          "ticker": "LAS",
          "companyName": " CTCP Supe Phốt phát và Hóa chất Lâm Thao",
          "marketCapVnd": 2178128520000,
          "transactionValue": 37040750000,
          "volume": 1902900,
          "bcEconomicSectorId": 2,
          "bcEconomicSectorName": "Nguyên vật liệu",
          "stockExchange": "HASTC",
          "outstandingShares": 112856400,
          "priceReference": 19900,
          "priceCeiling": 21800,
          "priceFloor": 18000,
          "priceClose": 19300,
          "netChange": -600,
          "pctChange": -3.02,
          "pctChangePeriod": -3.02
        },
        {
          "ticker": "HT1",
          "companyName": "Công ty Cổ phần Xi măng VICEM Hà Tiên",
          "marketCapVnd": 6372551513700,
          "transactionValue": 31175470000,
          "volume": 1869400,
          "bcEconomicSectorId": 2,
          "bcEconomicSectorName": "Nguyên vật liệu",
          "stockExchange": "HOSTC",
          "outstandingShares": 381589911,
          "priceReference": 17150,
          "priceCeiling": 18350,
          "priceFloor": 15950,
          "priceClose": 16700,
          "netChange": -450,
          "pctChange": -2.62,
          "pctChangePeriod": -2.62
        },
        {
          "ticker": "TDC",
          "companyName": "Công ty Cổ phần Kinh doanh và Phát triển Bình Dương",
          "marketCapVnd": 1390000000000,
          "transactionValue": 28758365000,
          "volume": 2059300,
          "bcEconomicSectorId": 2,
          "bcEconomicSectorName": "Nguyên vật liệu",
          "stockExchange": "HOSTC",
          "outstandingShares": 100000000,
          "priceReference": 14500,
          "priceCeiling": 15500,
          "priceFloor": 13500,
          "priceClose": 13900,
          "netChange": -600,
          "pctChange": -4.14,
          "pctChangePeriod": -4.14
        },
        {
          "ticker": "VTZ",
          "companyName": " CTCP Sản xuất và Thương mại Nhựa Việt Thành",
          "marketCapVnd": 817000000000,
          "transactionValue": 26730020000,
          "volume": 1412300,
          "bcEconomicSectorId": 2,
          "bcEconomicSectorName": "Nguyên vật liệu",
          "stockExchange": "HASTC",
          "outstandingShares": 43000000,
          "priceReference": 18900,
          "priceCeiling": 20700,
          "priceFloor": 17100,
          "priceClose": 19000,
          "netChange": 100,
          "pctChange": 0.53,
          "pctChangePeriod": 0.53
        }
      ]
    }
  ]
}

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	object (Xem chi tiết)	Dữ liệu biểu đồ

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ả
bcEconomicSectorId	number	ID ngành kinh tế
bcEconomicSectorName	string	Tên ngành kinh tế
companies	array (Xem chi tiết)	Danh sách công ty trong ngành

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

Quay lại

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
ticker	string	Mã cổ phiếu
companyName	string	Tên công ty
marketCapVnd	number	Vốn hóa thị trường (VND)
transactionValue	number	Giá trị giao dịch
volume	number	Khối lượng giao dịch
bcEconomicSectorId	number	ID ngành kinh tế
bcEconomicSectorName	string	Tên ngành kinh tế
stockExchange	string	Sàn giao dịch
outstandingShares	number	Cổ phiếu lưu hành
priceReference	number	Giá tham chiếu
priceCeiling	number	Giá trần
priceFloor	number	Giá sàn
priceClose	number	Giá đóng cửa
netChange	number	Thay đổi tuyệt đối
pctChange	number	Thay đổi phần trăm
pctChangePeriod	number	Thay đổi phần trăm theo kỳ