越南k线历史数据、IPO新股股票数据接口文档

概述

StockTV 提供全面的越南股票市场数据接口，覆盖胡志明证券交易所（HOSE）、河内证券交易所（HNX）和UPCOM市场所有上市公司。支持实时行情、技术分析、公司信息等多种功能。

交易所信息

胡志明证券交易所 (HOSE): 主要交易所，大型蓝筹股
河内证券交易所 (HNX): 中小型企业
UPCOM市场: 未上市公众公司
交易时间: 河内时间 09:00-11:30, 13:00-14:45
货币: 越南盾 (VND)

核心功能接口

1. 实时行情数据

获取越南股票列表

http 复制代码

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

参数说明:

countryId: 越南国家ID (具体值需确认)
pageSize: 每页数量
page: 页码
exchangeId: 交易所ID (HOSE/HNX/UPCOM)

响应示例:

json 复制代码

{
  "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. 主要指数数据

获取越南主要指数

http 复制代码

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

包含的主要指数:

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

指数数据示例:

json 复制代码

{
  "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. 个股查询功能

查询特定股票

http 复制代码

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

通过PID查询股票

http 复制代码

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

批量查询多个股票

http 复制代码

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线数据

http 复制代码

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

时间间隔参数:

PT5M - 5分钟
PT15M - 15分钟
PT1H - 1小时
P1D - 1天
P1W - 1周
P1M - 1月

K线数据格式:

json 复制代码

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

5. 涨跌排行榜

获取越南市场排行榜

http 复制代码

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

排行榜类型:

type=1: 涨幅榜
type=2: 跌幅榜
type=3: 成交额榜
type=4: 成交量榜

6. 公司基本信息

获取越南上市公司信息

http 复制代码

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

公司信息示例:

json 复制代码

{
  "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

javascript 复制代码

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

实时数据格式

json 复制代码

{
  "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成分股

http 复制代码

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

监控银行板块

http 复制代码

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

获取实时指数数据

http 复制代码

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

分交易所获取股票

http 复制代码

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

数据更新频率

实时行情: 秒级更新
K线数据: 按选择间隔实时更新
指数数据: 实时更新
公司信息: 每日更新
基本面数据: 实时更新

错误处理

json 复制代码

{
  "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需要向官方确认正确数值。