SFI External API — Báo cáo phân tích

X-Api-Key: {api_key_được_SFI_cấp}

{
  "success": true,
  "message": "Thành công!",
  "data": [ ... ],
  "svr": "srv-01"
}

Danh mục báo cáo, danh mục sản phẩm, danh sách và chi tiết báo cáo phân tích. Nguồn dữ liệu là kho báo cáo của SFI, đồng bộ tự động từ website.

1 · Danh mục báo cáo

Trả về mọi danh mục đang có báo cáo, kèm số báo cáo, sắp xếp theo tên. Dùng để dựng danh sách chọn cho bộ lọc cate. Danh mục chưa gắn với báo cáo nào sẽ không xuất hiện.

Không có tham số.

Request

curl 'https://a.sfi.com.vn/ekyc/ex_api?cmd=news_categories' \
  -H 'X-Api-Key: YOUR_API_KEY'

Response

{
  "success": true,
  "message": "Thành công",
  "data": [
    { "id": 71, "slug": "duong",               "name": "Đường",                "count": 128 },
    { "id": 88, "slug": "kim-loai-quy",        "name": "Kim loại quý",         "count": 54  },
    { "id": 63, "slug": "phan-tich-chuyen-sau","name": "Phân tích chuyên sâu", "count": 316 }
  ],
  "svr": "srv-01"
}

Khóa categories trong mỗi báo cáo

Mỗi báo cáo được gán vào một hoặc nhiều danh mục trên hệ thống nội dung của SFI (ví dụ Phân tích chuyên sâu, Vĩ mô, Đường, Kim loại quý). Danh sách này trả về ở khóa categories của cả API danh sách lẫn API chi tiết, theo đúng thứ tự đã cấu hình:

"categories": [
  { "id": 63, "slug": "phan-tich-chuyen-sau", "name": "Phân tích chuyên sâu" },
  { "id": 71, "slug": "duong",                "name": "Đường" }
]

Lọc theo danh mục

Tham số cate nhận một hoặc nhiều slug ngăn cách bằng dấu phẩy. Nhiều slug hiểu theo HOẶC:

# một danh mục
?cmd=news&cate=vi-mo

# hai danh mục — báo cáo thuộc BẤT KỲ danh mục nào trong hai
?cmd=news&cate=phan-tich-chuyen-sau,vi-mo

# kết hợp với các bộ lọc khác: giữa các THAM SỐ là VÀ
?cmd=news&cate=kim-loai-quy&productslug=bac&modified=08-2026

Nói cách khác: trong cate là HOẶC, giữa cate với productslug / modified là VÀ. Hiện chưa hỗ trợ yêu cầu "báo cáo phải thuộc đủ nhiều danh mục" (VÀ trong cùng cate) — cần thì báo SFI.

2 · Danh sách sản phẩm (bộ lọc)

Trả về bản đồ sản phẩm SFI dùng để gắn sản phẩm cho báo cáo. Kết quả dùng để dựng danh sách chọn cho tham số productslug ở API danh sách báo cáo.

Request

curl 'https://a.sfi.com.vn/ekyc/ex_api?cmd=news_products' \
  -H 'X-Api-Key: YOUR_API_KEY'

Response

{
  "success": true,
  "message": "Thành công",
  "data": [
    {
      "name": "Kim loại",
      "subs": [
        { "slug": "bac", "name": "Bạc" },
        { "slug": "bach-kim", "name": "Bạch kim" },
        { "slug": "dong-lme", "name": "Đồng LME" }
      ]
    },
    {
      "name": "Năng lượng",
      "subs": [
        { "slug": "dau-brent", "name": "Dầu Brent" }
      ]
    }
  ],
  "svr": "srv-01"
}

3 · Danh sách báo cáo

Trả về danh sách báo cáo theo trang, sắp xếp mới nhất trước. Trường content không có trong danh sách — gọi API chi tiết để lấy nội dung.

Tham số truy vấn

Request

# Mới nhất, trang 1, 20 bản ghi
curl 'https://a.sfi.com.vn/ekyc/ex_api?cmd=news&page=1&size=20' \
  -H 'X-Api-Key: YOUR_API_KEY'

# Sản phẩm "bac" trong tháng 08/2026
curl 'https://a.sfi.com.vn/ekyc/ex_api?cmd=news&productslug=bac&modified=08-2026' \
  -H 'X-Api-Key: YOUR_API_KEY'

# Báo cáo thuộc danh mục "phan-tich-chuyen-sau" HOẶC "vi-mo"
curl 'https://a.sfi.com.vn/ekyc/ex_api?cmd=news&cate=phan-tich-chuyen-sau,vi-mo&size=20' \
  -H 'X-Api-Key: YOUR_API_KEY'

Response — báo cáo không gắn sản phẩm

{
  "success": true,
  "message": "Thành công!",
  "data": [
    {
      "id": 60730,
      "title": "LƯỢNG MÍA NGHIỀN CUỐI THÁNG 7 TẠI BRAZIL SUY GIẢM",
      "thumb": "https://img.saigonfutures.com/2026/08/ava-chiu-1808.jpg",
      "excerpt": "I. ĐƯỜNG 1. Diễn biến thị trường phiên giao dịch ngày 17/08/2026 ...",
      "created": "2026-08-18T11:23:17",
      "modified": "18/08/2026 11:23",
      "categories": [
        { "id": 63, "slug": "phan-tich-chuyen-sau", "name": "Phân tích chuyên sâu" },
        { "id": 71, "slug": "duong", "name": "Đường" }
      ]
    }
  ],
  "svr": "srv-01"
}

Response — báo cáo gắn sản phẩm

{
  "success": true,
  "message": "Thành công!",
  "data": [
    {
      "id": 60727,
      "title": "PHÂN TÍCH HỢP ĐỒNG TƯƠNG LAI BẠCH KIM KỲ HẠN THÁNG 5/2026",
      "thumb": "https://img.saigonfutures.com/2026/08/pl188.png",
      "excerpt": "NHẬN ĐỊNH XU HƯỚNG: Xu hướng Trung hạn: Tăng. ...",
      "created": "2026-08-18T09:59:13",
      "modified": "18/08/2026 09:59",
      "product": "Bạch kim",
      "productslug": "bach-kim",
      "productcode": "PLEV26",
      "productgroup": "Kim loại",
      "categories": [
        { "id": 88, "slug": "kim-loai-quy", "name": "Kim loại quý" }
      ]
    }
  ],
  "svr": "srv-01"
}

4 · Chi tiết báo cáo

Cùng cmd=news; khi có tham số id khác rỗng, API chuyển sang chế độ chi tiết và bỏ qua mọi tham số lọc / phân trang. Gửi id= rỗng thì API vẫn trả về danh sách như bình thường.

Request

curl 'https://a.sfi.com.vn/ekyc/ex_api?cmd=news&id=40231' \
  -H 'X-Api-Key: YOUR_API_KEY'

Response

{
  "success": true,
  "message": "Thành công!",
  "data": {
    "id": 60730,
    "title": "LƯỢNG MÍA NGHIỀN CUỐI THÁNG 7 TẠI BRAZIL SUY GIẢM",
    "thumb": "https://img.saigonfutures.com/2026/08/ava-chiu-1808.jpg",
    "content": "<h2><span><strong>I. ĐƯỜNG</strong></span></h2> <p>1. Diễn biến thị trường ...</p> ...",
    "excerpt": "I. ĐƯỜNG 1. Diễn biến thị trường phiên giao dịch ngày 17/08/2026 ...",
    "created": "2026-08-18T11:23:17",
    "modified": "18/08/2026 11:23",
    "product": "",
    "productslug": "",
    "productcode": "",
    "productgroup": "",
    "categories": [
      { "id": 63, "slug": "phan-tich-chuyen-sau", "name": "Phân tích chuyên sâu" },
      { "id": 71, "slug": "duong", "name": "Đường" }
    ]
  },
  "svr": "srv-01"
}

5 · Trường dữ liệu báo cáo

Mã lỗi riêng của nhóm

const BASE = 'https://a.sfi.com.vn/ekyc/ex_api';
const HEADERS = { 'X-Api-Key': process.env.SFI_API_KEY };

async function call(params) {
  const qs  = new URLSearchParams(params);
  const res = await fetch(`${BASE}?${qs}`, { headers: HEADERS });
  const body = await res.json();
  if (!body.success) throw new Error(body.message);
  return body.data;
}

// Danh mục sản phẩm (cache lại, ít thay đổi)
const products = await call({ cmd: 'news_products' });

// Danh sách báo cáo + chi tiết
const list   = await call({ cmd: 'news', cate: 'kim-loai-quy', page: 1, size: 20 });
const detail = await call({ cmd: 'news', id: list[0].id });

function sfiCall(array $params) {
    $url = 'https://a.sfi.com.vn/ekyc/ex_api?' . http_build_query($params);

    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER     => ['X-Api-Key: ' . getenv('SFI_API_KEY')],
        CURLOPT_TIMEOUT        => 10,
    ]);
    $body = json_decode(curl_exec($ch), true);
    curl_close($ch);

    if (empty($body['success'])) {
        throw new RuntimeException($body['message'] ?? 'SFI API error');
    }
    return $body['data'];
}

$news = sfiCall(['cmd' => 'news', 'cate' => 'phan-tich-chuyen-sau', 'page' => 1, 'size' => 10]);