Khối ngoại theo ngành (phiên gần nhất)

cURL

curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/market/sectors/financials/trading/foreign"

import requests

url = "https://open-api.fhsc.com.vn/market/sectors/{slug}/trading/foreign"

headers = {"X-FH-APIKEY": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://open-api.fhsc.com.vn/market/sectors/{slug}/trading/foreign', 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/sectors/{slug}/trading/foreign",
  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/sectors/{slug}/trading/foreign"

	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/sectors/{slug}/trading/foreign")

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": {
    "sector": "financials",
    "buy": {
      "total": {
        "volume": 12543200,
        "value": 341175200000
      },
      "matched": {
        "volume": 12543200,
        "value": 341175200000
      },
      "put_through": {
        "volume": 12543200,
        "value": 341175200000
      }
    },
    "sell": {
      "total": {
        "volume": 12543200,
        "value": 341175200000
      },
      "matched": {
        "volume": 12543200,
        "value": 341175200000
      },
      "put_through": {
        "volume": 12543200,
        "value": 341175200000
      }
    },
    "net": {
      "total": {
        "volume": 12543200,
        "value": 341175200000
      },
      "matched": {
        "volume": 12543200,
        "value": 341175200000
      },
      "put_through": {
        "volume": 12543200,
        "value": 341175200000
      }
    },
    "date": "2026-08-17",
    "constituent_count": 63,
    "updated_at": "2026-08-17T14:30:15+07:00"
  },
  "error_code": "0",
  "message": "success"
}

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

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

{
  "error_code": "404",
  "message": "Not found"
}

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

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

GET

market

sectors

{slug}

trading

foreign

cURL

curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/market/sectors/financials/trading/foreign"

import requests

url = "https://open-api.fhsc.com.vn/market/sectors/{slug}/trading/foreign"

headers = {"X-FH-APIKEY": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://open-api.fhsc.com.vn/market/sectors/{slug}/trading/foreign', 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/sectors/{slug}/trading/foreign",
  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/sectors/{slug}/trading/foreign"

	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/sectors/{slug}/trading/foreign")

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": {
    "sector": "financials",
    "buy": {
      "total": {
        "volume": 12543200,
        "value": 341175200000
      },
      "matched": {
        "volume": 12543200,
        "value": 341175200000
      },
      "put_through": {
        "volume": 12543200,
        "value": 341175200000
      }
    },
    "sell": {
      "total": {
        "volume": 12543200,
        "value": 341175200000
      },
      "matched": {
        "volume": 12543200,
        "value": 341175200000
      },
      "put_through": {
        "volume": 12543200,
        "value": 341175200000
      }
    },
    "net": {
      "total": {
        "volume": 12543200,
        "value": 341175200000
      },
      "matched": {
        "volume": 12543200,
        "value": 341175200000
      },
      "put_through": {
        "volume": 12543200,
        "value": 341175200000
      }
    },
    "date": "2026-08-17",
    "constituent_count": 63,
    "updated_at": "2026-08-17T14:30:15+07:00"
  },
  "error_code": "0",
  "message": "success"
}

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

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

{
  "error_code": "404",
  "message": "Not found"
}

{
  "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ố đường dẫn

slug

enum<string>

bắt buộc

Slug ngành cấp 1. Tra danh sách hợp lệ qua GET /market/sectors.

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

technology,

telecommunications,

healthcare,

financials,

real-estate,

consumer-discretionary,

consumer-staples,

industrials,

basic-materials,

energy,

utilities

Ví dụ:

"financials"

Phản hồi

data là dòng tiền khối ngoại cộng dồn của ngành trong phiê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

bắt buộc

Tổng giao dịch khối ngoại của cả một ngành trong một phiên.

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ô

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

Tin tức-sự kiện

Dữ liệu giao dịch

Khối ngoại theo ngành (phiên gần nhất)

Ủy quyền

Tham số đường dẫn

Phản hồi