Skip to main content
GET
/
market
/
index-realtime
cURL
curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/market/index-realtime?index=VNINDEX"
{
  "error_code": "0",
  "message": "success",
  "result": [
    {
      "index": "VNINDEX",
      "indexValue": 1792.6,
      "allQuantity": 248009131,
      "change": 2.07,
      "changePercent": 0.12,
      "reference": 1790.53,
      "allValue": 6543210000000,
      "advances": 245,
      "declines": 168,
      "nochanges": 52,
      "ceiling": 9,
      "floor": 5,
      "values": [
        1790.53,
        1791.84,
        1792.6
      ],
      "volumes": [
        85230000,
        167450000,
        248009131
      ],
      "times": [
        1780300800000,
        1780304400000,
        1780308000000
      ],
      "advancesArr": [
        180,
        220,
        245
      ],
      "declinesArr": [
        210,
        185,
        168
      ],
      "nochangesArr": [
        60,
        58,
        52
      ],
      "ceilings": [
        4,
        7,
        9
      ],
      "floors": [
        9,
        7,
        5
      ],
      "sessionInExchange": "PROGRESS",
      "name": "VNINDEX"
    }
  ]
}

Authorizations

X-FH-APIKEY
string
header
required

API key dài hạn của client. Cấu hình 1 lần lúc khởi tạo; có thể wire thẳng vào static setter của SDK tự-gen. Đi kèm với FINHAY_API_SECRET — secret này chỉ dùng ở phía client để tính X-FH-SIGNATURE, không bao giờ gửi qua mạng.

Query Parameters

index
enum<string>[]
required

Mã chỉ số cần lấy. Truyền nhiều mã phân tách bằng dấu phẩy — ví dụ VNINDEX,HNX30.

Minimum array length: 1

Mã chỉ số thị trường chứng khoán Việt Nam.

Giá trịÝ nghĩa
VNINDEXChỉ số tổng hợp sàn HOSE
HNXINDEXChỉ số tổng hợp sàn HNX
UPCOMINDEXChỉ số thị trường UPCoM
VN30Rổ 30 mã vốn hoá lớn & thanh khoản cao trên HOSE
HNX30Rổ 30 mã vốn hoá lớn & thanh khoản cao trên HNX
Available options:
VNINDEX,
HNXINDEX,
UPCOMINDEX,
VN30,
HNX30

Response

Trả về mảng snapshot chỉ số trong result (1 phần tử / mã).

Các field chung của envelope trong mọi response của Finhay API.

  • error_code"0" (string) khi thành công, mã khác "0" khi lỗi.
  • message là thông điệp ngắn từ server.
result
object[]
required

Mảng snapshot chỉ số — 1 phần tử cho mỗi mã truyền vào index. Mã không hợp lệ / không có dữ liệu bị bỏ qua (không sinh lỗi), nên mảng có thể ngắn hơn số mã yêu cầu, hoặc rỗng.

error_code
string

"0" khi thành công, khác "0" khi lỗi.

Example:

"0"

message
string

Thông điệp trạng thái dễ đọc.

Example:

"success"