Lịch sử chỉ số

Truy vấn thông tin lịch sử các chỉ số thị trường theo khoảng thời gian.

GET /price/{indexName}/market-index

Lịch sử chỉ số

cURL

curl --request GET \
  --url https://openapi.dnse.com.vn/price/{indexName}/market-index \
  --header 'X-Api-Key: <x-api-key>' \
  --header 'X-Aux-Date: <x-aux-date>' \
  --header 'X-Signature: <x-signature>'

200

{
  "data": [
    {
      "indexName": "VN30",
      "valueIndexes": 1867.57,
      "changedValue": -8.57,
      "changedRatio": -0.46,
      "fluctuationUpIssueCount": 4,
      "fluctuationDownIssueCount": 24,
      "fluctuationSteadinessIssueCount": 2,
      "fluctuationLowerLimitIssueCount": 1,
      "fluctuationUpperLimitIssueCount": 0,
      "fluctuationDownIssueVolume": 151005844,
      "fluctuationUpIssueVolume": 12011382,
      "fluctuationSteadinessIssueVolume": 19131891,
      "currencyCode": "VND",
      "indexTypeCode": "101",
      "lowestValueIndexes": 1864.16,
      "highestValueIndexes": 1879.66,
      "priorValueIndexes": 1876.14,
      "contauctAccTrdVal": 4001.6785832,
      "contauctAccTrdVol": 119469304,
      "blkTrdAccTrdVal": 1633.46998985,
      "blkTrdAccTrdVol": 62679813,
      "grossTradeAmount": 5635.14857305,
      "totalVolumeTraded": 182149117,
      "marketIndexClass": "HSX",
      "marketId": "STO",
      "tradingSessionId": "40",
      "time": "2026-09-10 09:15:00.000"
    }
  ],
  "nextPageToken": "NDYwMTQ1XzIwMjYtMDMtMTJUMDQ6MjU6MDUuNTZa"
}

Tiêu đề

X-Api-Key · string · bắt buộc

API key được cấp khi đăng ký dịch vụ DNSE OpenAPI. Ví dụ: b3JnOmRuc2UgaWQ6MjdlZTc1MzcxZGFkNTY0NmYzYTM2NDk1ZGE3OGNiOGQgaDptdXJtdXIxMjg=

X-Aux-Date · string · bắt buộc

Thời gian thực hiện request, dùng trong cơ chế ký request của DNSE. Ví dụ: Sat, 01 May 2026 14:24:23 +0000

X-Signature · string · bắt buộc

Chữ ký xác thực request được tạo từ API key secret và X-Aux-Date. Ví dụ: Signature keyId="b3JnOmRuc2UgaWQ6MjdlZTc1MzcxZGFkNTY0NmYzYTM2NDk1ZGE3OGNiOGQgaDptdXJtdXIxMjg=",algorithm="hmac-sha256",headers="(request-target) x-aux-date",signature="rfbVXHDUi%2B%2FsOkLXle7O17Qm%2F05cbISSR%2BDcFrBHfqQ%3D",nonce="4add8c3264e4492b9f8ecde0cf26b523"

Tham số đường dẫn

indexName · enum<string> · bắt buộc

Tên chỉ số thị trường. Tên chỉ số thị trường.

• VNINDEX: Chỉ số sàn HOSE
• HNX: Chỉ số sàn HNX
• HNX30: Chỉ số Top 30 cổ phiếu sàn HNX
• VN30: Chỉ số Top 30 cổ phiếu sàn HOSE
• VN100: Chỉ số Top 100 cổ phiếu sàn HOSE
• VNXALLSHARE: Chỉ số các cổ phiếu chọn lọc sàn HOSE
• UPCOM: Chỉ số sàn UPCOM
• VNMITECH: Chỉ số nhóm cổ phiếu công nghệ
• VN50GROWTH: Chỉ số nhóm 50 cổ phiếu tăng trưởng sàn HOSE
• VNDIVIDEND: Chỉ số nhóm cổ phiếu có tỷ suất cổ tức tăng trưởng

Tùy chọn có sẵn: VNINDEX, HNX, HNX30, VN30, VN100, VNXALLSHARE, UPCOM, VNMITECH, VN50GROWTH, VNDIVIDEND

Ví dụ:

"VN30"

Tham số truy vấn

from · string · bắt buộc

Thời gian bắt đầu (timestamp).

to · string · bắt buộc

Thời gian kết thúc (timestamp).

limit · integer<int32>

Số lượng bản ghi tối đa trả về.

Phạm vi bắt buộc: x >= 1

order · enum<string> · mặc định: DESC

Thứ tự dữ liệu theo thời gian.

Tùy chọn có sẵn: ASC, DESC

nextPageToken · string

Token dùng để lấy trang tiếp theo.

Phản hồi

200

application/json

OK

Danh sách dữ liệu lịch sử chỉ số thị trường.

data · object[]

Danh sách bản ghi lịch sử chỉ số.

Show child attributes

nextPageToken · string

Token dùng để lấy trang tiếp theo.

Ví dụ:

"NDYwMTQ1XzIwMjYtMDMtMTJUMDQ6MjU6MDUuNTZa"