cURL

curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/market/market-news?topic=stock&page=1&page_size=20"

const options = {method: 'GET', headers: {'X-FH-APIKEY': '<api-key>'}};

fetch('https://open-api.fhsc.com.vn/market/market-news', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://open-api.fhsc.com.vn/market/market-news",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-FH-APIKEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://open-api.fhsc.com.vn/market/market-news"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-FH-APIKEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://open-api.fhsc.com.vn/market/market-news")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-FH-APIKEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "total": 137,
    "current_page": 1,
    "page_size": 20,
    "results": [
      {
        "id": "abc123",
        "title": "<string>",
        "url": "<string>",
        "published_at": "2023-11-07T05:31:56Z",
        "topic": "stock",
        "summary": "<string>",
        "source": "<string>",
        "symbols": [
          "<string>"
        ]
      }
    ],
    "next_page": 2,
    "previous_page": 1,
    "page_total": 7
  },
  "error_code": "0",
  "message": "success"
}

{
  "error_code": "400",
  "message": "Invalid parameter"
}

{
  "error_code": "401",
  "message": "Invalid signature"
}

{
  "error_code": "429",
  "message": "Too many requests"
}

{
  "error_code": "500",
  "message": "Internal server error"
}

Tin tức-sự kiện

Danh sách tin tức thị trường

Dòng tin tức tài chính, gồm cả quốc tế và thị trường Việt Nam, kèm phân trang. Lọc tùy chọn theo topic (forex / hàng hoá / chứng khoán / crypto / vĩ mô); phân trang qua page/page_size. Khi topic=stock, có thể kết hợp tham số symbol để lọc theo mã chứng khoán. Mỗi item là bản tóm tắt (không có toàn văn); dùng id gọi /market/market-news/{id} để lấy nội dung đầy đủ.

GET

market

market-news

cURL

curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/market/market-news?topic=stock&page=1&page_size=20"

const options = {method: 'GET', headers: {'X-FH-APIKEY': '<api-key>'}};

fetch('https://open-api.fhsc.com.vn/market/market-news', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://open-api.fhsc.com.vn/market/market-news",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-FH-APIKEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://open-api.fhsc.com.vn/market/market-news"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-FH-APIKEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://open-api.fhsc.com.vn/market/market-news")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-FH-APIKEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "total": 137,
    "current_page": 1,
    "page_size": 20,
    "results": [
      {
        "id": "abc123",
        "title": "<string>",
        "url": "<string>",
        "published_at": "2023-11-07T05:31:56Z",
        "topic": "stock",
        "summary": "<string>",
        "source": "<string>",
        "symbols": [
          "<string>"
        ]
      }
    ],
    "next_page": 2,
    "previous_page": 1,
    "page_total": 7
  },
  "error_code": "0",
  "message": "success"
}

{
  "error_code": "400",
  "message": "Invalid parameter"
}

{
  "error_code": "401",
  "message": "Invalid signature"
}

{
  "error_code": "429",
  "message": "Too many requests"
}

{
  "error_code": "500",
  "message": "Internal server error"
}

Ủy quyền

X-FH-APIKEY

string

header

bắt buộc

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.

Tham số truy vấn

topic

enum<string>

Lọc theo chủ đề tin tức. Khi topic=stock, có thể kết hợp tham số symbol để lọc theo mã chứng khoán. Chủ đề tin tức thị trường.

Tùy chọn có sẵn:

crypto,

forex,

stock,

commodities,

macro

Ví dụ:

"stock"

symbol

string

Mã chứng khoán cần lọc. Chỉ áp dụng khi topic=stock.

Ví dụ:

"FPT"

page

integer

Trang (bắt đầu từ 1). Mặc định 1.

Phạm vi bắt buộc: x >= 1

Ví dụ:

1

page_size

integer

Số item mỗi trang (1–50). Mặc định 20.

Phạm vi bắt buộc: 1 <= x <= 50

Ví dụ:

20

Phản hồi

data là trang tin tức kèm items và thông tin phân trang.

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

bắt buộc

Metadata phân trang dùng chung cho mọi list API. Dữ liệu của trang nằm ở results.

Show child attributes

error_code

string

"0" khi thành công, khác "0" khi lỗi.

Ví dụ:

"0"

message

string

Thông điệp trạng thái dễ đọc.

Ví dụ:

"success"

Khởi tạo

Kinh tế vĩ mô

Tin tức-sự kiện

Bảng giá thị trường

Phân tích cơ bản

Tiểu khoản

Sổ lệnh

Danh mục đầu tư

Quyền cổ đông

Lãi-lỗ

Phiên giao dịch

Thực thi lệnh

Tổng tài sản

Danh sách tin tức thị trường

Ủy quyền

Tham số truy vấn

Phản hồi