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/stock-realtime?symbol=VNM"

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

import os, requests

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

Đọ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.

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.

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