Skip to main content
GET
cURL

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 symbolsexchange.

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 symbolexchange.

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 symbolsymbols. Mã sàn chứng khoán Việt Nam.

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