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.

X-FH-TIMESTAMP
string
header
required

Unix time hiện tại tính bằng milliseconds, đưới dạng chuỗi số thập phân.

Được tính per-request bởi signing middleware. Không set thủ công — dùng middleware mẫu trong README.

X-FH-NONCE
string
header
required

UUIDv4 duy nhất per-request (ví dụ crypto.randomUUID()). Server cache cặp (apiKey, nonce) trong 5 phút; nếu nonce được reuse với cùng apiKey trong window này, request sẽ bị từ chối với AUTH_NONCE_REUSED (401).

Server chấp nhận chuỗi opaque bất kỳ về mặt kỹ thuật, nhưng nên dùng UUIDv4 để đảm bảo tính unique.

Được tính per-request bởi signing middleware. Không set thủ công — xem middleware mẫu trong tài liệu Authentication.

X-FH-SIGNATURE
string
header
required

HMAC-SHA256 của canonical signing payload, encode hex (lowercase).

Signing payload:

  • ?{QUERY} chỉ nối vào path khi request có query string.
  • {BODYHASH} là chuỗi rỗng khi body rỗng (vẫn không có newline sau đó).

Được tính per-request bởi signing middleware. Không set thủ công — dùng middleware mẫu trong README.

Path Parameters

userId
integer<int64>
required

User ID. Được lấy từ bootstrap flow (GET /users/v1/users/me).

Example:

123456

Query Parameters

type
enum<string>
required

Sản phẩm cần xem lịch sử (xem bảng ở mô tả endpoint).

Available options:
stock,
haybond,
haybond_plus,
hay0,
fund,
child_saving,
ipo
from
string<date>

Ngày bắt đầu (bao gồm), dạng YYYY-MM-DD. Bỏ trống → 3 tháng trước to.

Example:

"2026-01-01"

to
string<date>

Ngày kết thúc (bao gồm), dạng YYYY-MM-DD. Không được trước from; khoảng ngày tối đa 1 năm, bao gồm [from, to], ví dụ from là 2025-10-21 thì to chậm nhất là 2026-10-20. Bỏ trống → hôm nay.

Example:

"2026-03-31"

account
enum<string>

Loại tiểu khoản, chỉ dùng và bắt buộc với type=stock: normal (.1), margin (.6), openapi (.4).

Available options:
normal,
margin,
openapi
symbol
string

Lọc theo một mã chứng khoán, chỉ dùng với type=stock.

Pattern: ^[A-Za-z0-9]{1,20}$
Example:

"FPT"

page
string

Trang cần đọc; truyền đúng next_page của trang trước. Bỏ trống → trang đầu.

Response

Thành công.

Các field chung của envelope trong mọi response của Finhay API.

  • error_code là "0" (string) khi thành công, mã khác "0" khi lỗi.
  • message là thông điệp ngắn từ server.
data
object
required
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"