Quickstart

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.

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

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/quotes/stocks/VNM"

const res = await fetch(
  "https://open-api.fhsc.com.vn/market/quotes/stocks/VNM",
  { headers: { "X-FH-APIKEY": process.env.FINHAY_API_KEY! } }
);
const json = await res.json();
console.log(json.data);

import os, requests

res = requests.get(
    "https://open-api.fhsc.com.vn/market/quotes/stocks/VNM",
    headers={"X-FH-APIKEY": os.environ["FINHAY_API_KEY"]},
)
print(res.json()["data"])

Đọc response

Response trả về theo envelope chuẩn { error_code, message, data }:

{
  "error_code": "0",
  "message": "success",
  "data": {
    "symbol": "VNM",
    "name": "Vinamilk",
    "exchange": "HOSE",
    "currency": "VND",
    "price": 68500,
    "change": 300,
    "change_percent": 0.44,
    "ceiling": 72900,
    "floor": 63500,
    "volume": 1284500
  }
}

error_code: "0" nghĩa là thành công. Mọi mã khác "0" là lỗi — xem Errors.

Nhóm endpoint dữ liệu thị trường trả kết quả trong data; nhóm tài khoản / giao dịch (Tier 2) vẫn trả trong result.

Khám phá thêm

Thêm endpoint Tier 1

Sổ lệnh, lịch sử OHLCV, chỉ số / forex / crypto / hàng hoá / quỹ mở / trái phiếu / ETF, tin tức, vĩ mô, 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 Bảng giá thị trường, Phân tích cơ bản, Tin tức-sự kiện, Kinh tế vĩ mô.
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.

Bắt đầu

Xác thực

Tham khảo

Lịch sử

Thêm endpoint Tier 1

Truy cập tài khoản

Bước tiếp

Thêm endpoint Tier 1

Truy cập tài khoản

​Bước tiếp

Bước tiếp