越南k線歷史數據、IPO新股股票數據接口文檔

概述

StockTV 提供全面的越南股票市場數據接口，覆蓋胡志明證券交易所（HOSE）、河內證券交易所（HNX）和UPCOM市場所有上市公司。支持實時行情、技術分析、公司信息等多種功能。

交易所信息

胡志明證券交易所 (HOSE): 主要交易所，大型藍籌股
河內證券交易所 (HNX): 中小型企業
UPCOM市場: 未上市公眾公司
交易時間: 河內時間 09:00-11:30, 13:00-14:45
貨幣: 越南盾 (VND)

核心功能接口

1. 實時行情數據

獲取越南股票列表

GET /stock/stocks?countryId=VN&pageSize=50&page=1&key=您的API_KEY

參數說明:

countryId: 越南國家ID (具體值需確認)
pageSize: 每頁數量
page: 頁碼
exchangeId: 交易所ID (HOSE/HNX/UPCOM)

響應示例:

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "records": [
      {
        "id": 55001,
        "symbol": "VIC",
        "name": "Vingroup JSC",
        "last": 45000,
        "chg": 500,
        "chgPct": 1.12,
        "high": 45200,
        "low": 44800,
        "volume": 1250000,
        "open": true,
        "lastPairDecimal": 0,
        "countryNameTranslated": "Vietnam",
        "flag": "VN",
        "exchangeId": 75,
        "time": 1716448222,
        "url": "/equities/vingroup",
        "fundamentalMarketCap": 165000000000000,
        "fundamentalRevenue": "120.5T",
        "performanceDay": 1.12,
        "performanceWeek": 3.45,
        "performanceMonth": 8.67
      }
    ],
    "total": 1600,
    "current": 1,
    "pages": 32
  }
}

2. 主要指數數據

獲取越南主要指數

GET /stock/indices?countryId=VN&key=您的API_KEY

包含的主要指數:

VN-Index (胡志明交易所)
HNX-Index (河內交易所)
VN30-Index (VN30成分股)
HNX30-Index (HNX30成分股)

指數數據示例:

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "id": 18001,
      "name": "VN-Index",
      "symbol": "VNINDEX",
      "last": 1250.45,
      "chg": 15.32,
      "chgPct": 1.24,
      "high": 1255.65,
      "low": 1235.43,
      "isOpen": true,
      "flag": "VN",
      "time": 1716458537
    }
  ]
}

3. 個股查詢功能

查詢特定股票

GET /stock/queryStocks?symbol=VIC&key=您的API_KEY

通過PID查詢股票

GET /stock/queryStocks?id=55001&key=您的API_KEY

批量查詢多個股票

GET /stock/stocksByPids?key=您的API_KEY&pids=55001,55002,55003

熱門越南股票代碼:

VIC: Vingroup (房地產)
VHM: Vinhomes (房地產)
VCB: Vietcombank (銀行)
HPG: Hoa Phat Group (鋼鐵)
FPT: FPT Corporation (科技)
MWG: Mobile World (零售)
SSI: SSI Securities (證券)

4. K線數據（技術分析）

獲取股票K線數據

GET /stock/kline?pid=55001&interval=PT1H&key=您的API_KEY

時間間隔參數:

PT5M - 5分鐘
PT15M - 15分鐘
PT1H - 1小時
P1D - 1天
P1W - 1周
P1M - 1月

K線數據格式:

{
  "time": 1719818400000,
  "open": 44800,
  "high": 45200,
  "low": 44750,
  "close": 45000,
  "volume": 1250000,
  "vo": 56250000000
}

5. 漲跌排行榜

獲取越南市場排行榜

GET /stock/updownList?countryId=VN&type=1&key=您的API_KEY

排行榜類型:

type=1: 漲幅榜
type=2: 跌幅榜
type=3: 成交額榜
type=4: 成交量榜

6. 公司基本信息

獲取越南上市公司信息

GET /stock/companies?countryId=VN&pageSize=20&page=1&key=您的API_KEY

公司信息示例:

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "records": [
      {
        "companyName": "Vingroup Joint Stock Company Profile",
        "description": "Vingroup JSC is a Vietnam-based company engaged in real estate development, retail, and hospitality. The company operates through several segments including Real Estate, Retail, Hospitality, Healthcare, and Education...",
        "industry": "Real Estate",
        "sector": "Real Estate & Construction",
        "employeeCount": 45000,
        "market": "Vietnam",
        "countryId": "VN",
        "url": "/equities/vingroup",
        "id": 201
      }
    ],
    "total": 1600,
    "current": 1,
    "pages": 80
  }
}

7. 技術指標數據

包含的技術指標:

technicalDay: 日線技術指標
technicalHour: 小時線技術指標
technicalWeek: 周線技術指標
technicalMonth: 月線技術指標

技術指標值:

strong_buy: 強烈買入
buy: 買入
neutral: 中性
sell: 賣出
strong_sell: 強烈賣出

8. 基本面數據

包含的基本面指標:

fundamentalBeta: Beta值
fundamentalMarketCap: 市值 (越南盾)
fundamentalRevenue: 收入
fundamentalRatio: 基本面比率
performanceDay: 當日表現
performanceWeek: 周表現
performanceMonth: 月表現
performanceYtd: 年初至今表現

9. WebSocket 實時數據

連接WebSocket

const wsUri = "wss://ws-api.stocktv.top/connect?key=您的API_KEY";
const websocket = new WebSocket(wsUri);

實時數據格式

{
  "pid": "55001",
  "last_numeric": "45000",
  "bid": "44950",
  "ask": "45050",
  "high": "45200",
  "low": "44800",
  "last_close": "44500",
  "pc": "500",
  "pcp": "1.12",
  "turnover_numeric": "1250000",
  "time": "14:30:25",
  "timestamp": "1717728251",
  "type": 1
}

越南市場特色

1. 交易所分類

胡志明證券交易所 (HOSE)

主要交易所，流動性最強
包含VN30指數成分股
交易單位：10股/手
漲跌幅限制：±7%

河內證券交易所 (HNX)

中小型企業
包含HNX30指數成分股
交易單位：100股/手
漲跌幅限制：±10%

UPCOM市場

未上市公眾公司
監管相對寬松
流動性較低

2. 行業分類

金融業: 銀行、證券、保險
房地產: 開發商、建筑公司
基礎材料: 鋼鐵、水泥、礦業
消費品: 零售、食品飲料
科技: 軟件、電信
工業: 制造、運輸

3. 主要板塊

VN30: 胡志明交易所市值最大的30家公司
HNX30: 河內交易所市值最大的30家公司
銀行板塊: 越南主要商業銀行
房地產板塊: 越南大型開發商

使用示例

獲取VN30成分股

GET /stock/stocks?countryId=VN&pageSize=30&key=您的API_KEY

監控銀行板塊

GET /stock/stocksByPids?key=您的API_KEY&pids=55001,55002,55003,55004,55005

獲取實時指數數據

GET /stock/indicesById?id=18001&key=您的API_KEY

分交易所獲取股票

GET /stock/stocks?countryId=VN&exchangeId=75&pageSize=100&key=您的API_KEY

數據更新頻率

實時行情: 秒級更新
K線數據: 按選擇間隔實時更新
指數數據: 實時更新
公司信息: 每日更新
基本面數據: 實時更新

錯誤處理

{
  "code": 400,
  "message": "參數錯誤",
  "data": null
}

常見錯誤代碼:

200: 操作成功
400: 參數錯誤
401: API Key無效
404: 數據不存在
500: 服務器內部錯誤

最佳實踐

批量查詢: 使用stocksByPids接口批量獲取VN30成分股數據
WebSocket連接: 對于實時監控使用WebSocket連接
交易所過濾: 根據需求過濾特定交易所的股票
本地緩存: 對公司信息等靜態數據實施緩存
數據格式化: 注意越南盾金額的格式化顯示

注意事項

貨幣單位: 所有價格均為越南盾，注意數值較大時的顯示處理
交易時間: 注意河內時區與本地時區的轉換
漲跌幅限制: 不同交易所有不同的漲跌幅限制
交易單位: HOSE為10股/手，HNX為100股/手
數據精度: 價格精確到越南盾，成交量精確到股

越南特色股票

藍籌股

Vingroup (VIC) - 綜合企業
Vietcombank (VCB) - 銀行業
Hoa Phat Group (HPG) - 鋼鐵業
Vinamilk (VNM) - 乳制品
Masan Group (MSN) - 消費品

成長股

FPT Corporation (FPT) - 科技
Mobile World (MWG) - 零售
Novaland (NVL) - 房地產
Techcombank (TCB) - 銀行業

本文檔基于 StockTV API 生成，具體接口參數以最新官方文檔為準。越南國家ID和交易所ID需要向官方確認正確數值。

posted @ 2025-10-15 16:56 CryptoRzz 閱讀(24) 評論(0) 收藏舉報

刷新頁面返回頂部

CryptoRzz

越南k線歷史數據、IPO新股股票數據接口文檔

概述