Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.fhsc.com.vn/llms.txt

Use this file to discover all available pages before exploring further.

Hướng dẫn nhanh cách gọi endpoint Tier 1 đầu tiên — chỉ cần 1 header X-FH-APIKEY. Sau khi quen, bạn có thể chuyển sang Tier 2 với HMAC signing đầy đủ ở Authentication.
1

Lấy API key

Đăng nhập tài khoản Finhay rồi truy cập trang Quản lý API để tạo cặp FINHAY_API_KEY và FINHAY_API_SECRET. API key Tier 1 không cần secret — chỉ dùng để gọi các endpoint dữ liệu thị trường.Lưu key vào biến môi trường:
export FINHAY_API_KEY="<key của bạn>"
2

Gọi request đầu tiên

Lấy giá realtime của cổ phiếu VNM:
curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/market/stock-realtime?symbol=VNM"
3

Đọc response

Response trả về theo envelope chuẩn { error_code, message, result }:
{
  "error_code": "0",
  "message": "success",
  "result": {
    "symbol": "VNM",
    "price": 72500,
    "change": 500,
    "changePercent": 0.69,
    "ceiling": 77500,
    "floor": 67500,
    "exchange": "HOSE",
    "marketCap": 150000000000000
  }
}
error_code: "0" nghĩa là thành công. Mọi mã khác "0" là lỗi — xem Errors.
4

Khám phá thêm

Thêm endpoint Tier 1

Lịch sử OHLCV, tin tức, vĩ mô, vàng/bạc/crypto, lịch sự kiện kinh tế.

Truy cập tài khoản

Tier 2 với HMAC signing — đọc số dư, danh mục, sổ lệnh.

​
Bước tiếp

  • Nếu chỉ dùng dữ liệu thị trường công khai → tiếp tục với các endpoint trong API Reference thuộc các tag Dữ liệu giao dịch, Hàng hoá, Kinh tế vĩ mô, Phân tích cơ bản.
  • Nếu cần truy cập tài khoản user → đọc Authentication để setup HMAC signing, sau đó chạy Bootstrap flow để lấy userId + subAccountId.