Skip to main content
GET
/
market
/
financial-data
/
global-news
cURL
curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/market/financial-data/global-news?category=stock-market&page=1&page_size=20"
{
  "error_code": "0",
  "message": "success",
  "data": {
    "results": [
      {
        "id": 12,
        "title": "Fed signals rate hold at next meeting",
        "url": "https://example.com/news/fed-rate-hold",
        "description": "Fed officials signaled the federal funds rate will likely remain unchanged…",
        "provider": "Reuters",
        "published_at": "2026-04-22T08:30:00Z",
        "category": "economic-indicators"
      },
      {
        "id": 13,
        "title": "Gold hits record high on safe-haven demand",
        "url": "https://example.com/news/gold-record",
        "description": "Spot gold surged past $2,400/oz overnight…",
        "provider": "Bloomberg",
        "published_at": "2026-04-22T07:15:00Z",
        "category": "commodities"
      }
    ],
    "page_total": 20,
    "total": 1234,
    "current_page": 1,
    "next_page": 2,
    "previous_page": null
  }
}

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

category
enum<string>

Lọc theo phân loại tin tức. Bỏ qua để lấy mọi category. Phân loại tin tức tài chính toàn cầu (/market/financial-data/global-news).

Giá trịÝ nghĩa
forexNgoại hối / tỷ giá
commoditiesHàng hoá (vàng, bạc, dầu, …)
economic-indicatorsChỉ số kinh tế (CPI, GDP, PMI, …)
stock-marketThị trường chứng khoán toàn cầu
cryptocurrencyTiền số
Available options:
forex,
commodities,
economic-indicators,
stock-market,
cryptocurrency
page
integer
default:1

Số trang cần lấy (1-indexed). Mặc định 1.

Required range: x >= 1
Example:

1

page_size
integer
default:20

Số item / trang. Mặc định 20, tối đa 50.

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

20

Response

Trả về data là wrapper trang chứa results[] cộng metadata phân trang.

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

  • error_code"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

Wrapper trang cho danh sách tin tức tài chính toàn cầu. Chứa results[] cộng các field phân trang.

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"