Skip to main content
GET
/
market
/
financial-data
/
gold-chart
cURL
curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/market/financial-data/gold-chart?days=30"
{
  "error_code": "0",
  "message": "success",
  "data": [
    {
      "date": "2026-03-23",
      "gold_bar": 16600,
      "gold_ring": 16370,
      "gold_global": 13944
    },
    {
      "date": "2026-03-24",
      "gold_bar": 17020,
      "gold_ring": 17020,
      "gold_global": 14060
    },
    {
      "date": "2026-03-25",
      "gold_bar": 17350,
      "gold_ring": 17350,
      "gold_global": 14486
    },
    {
      "date": "2026-03-26",
      "gold_bar": 17150,
      "gold_ring": 17150,
      "gold_global": 13948
    },
    {
      "date": "2026-03-27",
      "gold_bar": 17160,
      "gold_ring": 17160,
      "gold_global": 14343
    },
    {
      "date": "2026-03-28",
      "gold_bar": 17280,
      "gold_ring": 17280,
      "gold_global": 14283
    }
  ],
  "traceId": "29a6c22e-bf57-4c1d-8fcd-0cac7ff229cb"
}

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.

Query Parameters

​
days
integer
default:30

Số ngày lịch sử cần lấy. Mặc định 30.

Example:

30

Response

Trả về data mảng điểm chart, mỗi item gồm date + gold_bar / gold_ring / gold_global. Có kèm traceId.

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"

​
traceId
string<uuid>

Request trace ID do server sinh, dùng để debug và đối chiếu log.

Example:

"29a6c22e-bf57-4c1d-8fcd-0cac7ff229cb"