Skip to main content
GET
/
market
/
financial-data
/
market
cURL
curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/market/financial-data/market?type=SP500&limit=50"
{
  "error_code": "0",
  "message": "success",
  "data": [
    {
      "type": "SP500",
      "country": "US",
      "date": "2026-04-22",
      "year": 2026,
      "month": 4,
      "value": 5234.18
    },
    {
      "type": "SP500",
      "country": "US",
      "date": "2026-04-21",
      "year": 2026,
      "month": 4,
      "value": 5210.55
    }
  ]
}

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

​
type
enum<string>
required

Mã instrument cần lấy lịch sử. Mã instrument cho dữ liệu thị trường toàn cầu (chỉ số / cổ phiếu Mag7 / hàng hoá / tỷ giá ngoại hối). Dùng cho /market/financial-data/market.

US Indices

Giá trịÝ nghĩa
SP500S&P 500
DOW_JONESDow Jones
NASDAQNasdaq Composite
RUSSELL2000Russell 2000
VIXChỉ số biến động VIX
DXYUS Dollar Index

Asian Indices

Giá trịÝ nghĩa
KOSPIHàn Quốc — KOSPI
HANGSENGHong Kong — Hang Seng
SHANGHAITrung Quốc — Shanghai Composite
NIKKEINhật Bản — Nikkei 225

Big-tech stocks (Mag7)

Giá trịÝ nghĩa
APPLEApple (AAPL)
MICROSOFTMicrosoft (MSFT)
ALPHABETAlphabet / Google (GOOGL)
AMAZONAmazon (AMZN)
METAMeta Platforms (META)
NVIDIANVIDIA (NVDA)
TESLATesla (TSLA)

Commodities

Giá trịÝ nghĩa
GOLDVàng (USD/oz)
SILVERBạc (USD/oz)
COPPERĐồng
CRUDE_OILDầu thô WTI
BRENT_OILDầu Brent
NATURAL_GASKhí tự nhiên

Forex

Giá trịÝ nghĩa
EURUSDEUR/USD
USDJPYUSD/JPY
GBPUSDGBP/USD
Available options:
SP500,
DOW_JONES,
NASDAQ,
RUSSELL2000,
VIX,
DXY,
KOSPI,
HANGSENG,
SHANGHAI,
NIKKEI,
APPLE,
MICROSOFT,
ALPHABET,
AMAZON,
META,
NVIDIA,
TESLA,
GOLD,
SILVER,
COPPER,
CRUDE_OIL,
BRENT_OIL,
NATURAL_GAS,
EURUSD,
USDJPY,
GBPUSD
​
limit
integer
default:50

Số điểm dữ liệu cần lấy (mặc định 50, tối đa 500).

Required range: 1 <= x <= 500
Example:

50

Response

Trả về data mảng các điểm dữ liệu lịch sử của instrument, sort theo date giảm dần.

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"