Skip to main content
GET
/
market
/
stock-realtime
cURL
curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/market/stock-realtime?symbol=VNM"
{
  "error_code": "0",
  "message": "success",
  "result": {
    "symbol": "VNM",
    "price": 72500,
    "change": 500,
    "changePercent": 0.69,
    "ceiling": 77500,
    "floor": 67500,
    "reference": 72000,
    "open": 72000,
    "high": 73000,
    "low": 71500,
    "close": 72500,
    "totalVolume": 1500000,
    "totalValue": 108750000000,
    "stockType": "STOCK",
    "exchange": "HOSE",
    "name": "CTCP Sữa Việt Nam",
    "createdAt": 1713441600,
    "pe": 16.8,
    "pb": 4.2,
    "roe": 0.25,
    "marketCap": 150000000000000,
    "marketCapCategory": "Large Cap",
    "hasNewestNews": false
  }
}

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

​
symbol
string

Mã stock đơn lẻ. Loại trừ lẫn với symbols và exchange.

Example:

"VNM"

​
symbols
string

Danh sách mã stock, phân tách bằng dấu phẩy. Loại trừ lẫn với symbol và exchange.

Example:

"VNM,FPT,VIC"

​
exchange
enum<string>

Mã exchange (trả về toàn bộ stock thuộc exchange này). Loại trừ lẫn với symbol và symbols. Mã sàn chứng khoán Việt Nam.

Giá trịÝ nghĩa
HOSESở Giao dịch Chứng khoán TP. HCM
HNXSở Giao dịch Chứng khoán Hà Nội
UPCOMThị trường công ty đại chúng chưa niêm yết
HCXSàn hàng hoá TP. HCM (phái sinh)
Available options:
HOSE,
HNX,
UPCOM,
HCX

Response

Trả về snapshot giá realtime trong result. Là 1 object khi truyền symbol; là array khi truyền symbols / exchange.

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

  • error_code là "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

Single StockRealtime object when symbol is used; array of StockRealtime when symbols or exchange is used.

​
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"