Skip to main content
GET
/
users
/
v3
/
users
/
{userId}
/
assets
/
summary
cURL
curl \
  -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  -H "X-FH-TIMESTAMP: $TIMESTAMP_MS" \
  -H "X-FH-NONCE: $NONCE_UUID" \
  -H "X-FH-SIGNATURE: $SIGNATURE_HEX" \
  "https://open-api.fhsc.com.vn/users/v3/users/$USER_ID/assets/summary"
{
  "error_code": "0",
  "message": "success",
  "data": {
    "net_asset_value": 162500000,
    "products": {
      "total": 150000000,
      "stock": 120000000,
      "fund": 20000000,
      "saving": null,
      "bond": 10000000,
      "hay0": 0,
      "hay0_interest": 0,
      "hay0_depositing": 0,
      "hay0_withdrawing": 0
    },
    "money": {
      "total": 12500000,
      "ci_balance": 10000000,
      "ca_receiving": 0,
      "emk_amt": 0,
      "receiving_amt": 0,
      "baldefovd": 12500000
    },
    "debt": {
      "total": 0,
      "secure_amount": 0,
      "advance_amt": 0,
      "sms_fee_amt": 0,
      "cidepo_fee_acr": 0,
      "owe_deposit": 0
    },
    "pnl": {
      "stock": {
        "pnl": 4500000,
        "pnl_rate": 3.9
      },
      "fund": {
        "pnl": 500000,
        "pnl_rate": 2.56
      }
    }
  }
}

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:

{X-FH-TIMESTAMP}\n{METHOD}\n{REQUEST_PATH}[?{QUERY}]\n{BODYHASH}
  • ?{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

Response

Trả về data chứa net_asset_value, breakdown theo products (stock/fund/bond/hay0), money (cash), debt, và pnl cho từng loại sản phẩm.

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

Tổng quan tài sản / số dư của user qua mọi loại sản phẩm (stock, fund, bond, hay0), kèm tiền mặt, dư nợ và PnL.

Với user Level 0 / 1, products.stock, products.fund, products.bond và các entry trong pnl đều trả về 0. products.saving có thể null.

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