Skip to main content
Finhay Securities Open API cho phép đối tác và developer truy cập dữ liệu thị trường (giá realtime, lịch sử OHLCV, tin tức, dữ liệu vĩ mô, …) cùng thông tin tài khoản / danh mục / lệnh của user thông qua HTTP/REST.

​
Bắt đầu nhanh

Quickstart

Gọi request đầu tiên trong 5 phút — không cần signing.

Authentication

2 tier xác thực: API key đơn giản và HMAC signing đầy đủ.

Bootstrap flow

Lấy userId và subAccountId để gọi các endpoint tài khoản.

API Reference

Đặc tả OpenAPI 3.1 đầy đủ kèm form gọi thử endpoint trực tiếp.

​
Mô hình xác thực

API chia 2 tier theo mức độ nhạy cảm của dữ liệu:
TierEndpointHeader bắt buộc
Tier 1Dữ liệu thị trường công khai (GET /market/**, GET /trading/market/**, GET /trading/securities/**, GET /fund-trading/public/**)X-FH-APIKEY
Tier 2Tài khoản, danh mục, lệnh, PnL của userX-FH-APIKEY + X-FH-TIMESTAMP + X-FH-NONCE + X-FH-SIGNATURE (+ X-FH-BODYHASH khi có body)
Chi tiết thuật toán signing: Authentication.

​
URL Production

https://open-api.fhsc.com.vn

​
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 / FINHAY_API_SECRET.
Bảo mật API key và Secret key là trách nhiệm của bạn.
  • Không commit key vào git, không dán vào client-side code (browser / mobile bundle), không chia sẻ qua chat / email / screenshot.
  • Lưu key trong biến môi trường (.env đã gitignore) hoặc secret manager (AWS Secrets Manager, Vault, GCP Secret Manager, …).
  • Mọi request đi từ key của bạn được xem là do bạn thực hiện — Finhay không chịu trách nhiệm cho thiệt hại phát sinh khi key bị rò rỉ do lỗi phía client.
  • Nếu nghi ngờ key đã rò rỉ → vào trang Quản lý API để revoke ngay và tạo cặp key mới.

​
Tham khảo nhanh

Error codes

Bảng tra cứu mã lỗi và HTTP status mapping.

Rate limits

Giới hạn request và chiến lược retry.