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