1. 获取越南股票市场列表(包含VN30成分股)
http
GET https://api.stocktv.top/stock/stocks?countryId={越南国家ID}&pageSize=50&page=1&key=您的API_KEY
参数说明:
countryId
: 越南的国家ID(需要从API提供商获取具体值)pageSize
: 每页显示数量page
: 页码key
: 您的API密钥
2. 获取越南指数数据(包含VN30)
http
GET https://api.stocktv.top/stock/indices?countryId={越南国家ID}&key=您的API_KEY
这个接口会返回越南的所有指数数据,包括VN30指数。
3. 通过ID查询特定指数(VN30)
http
GET https://api.stocktv.top/stock/indicesById?id={VN30的PID}&key=您的API_KEY
返回数据示例(VN30指数):
json
{
"id": 17940,
"name": "VN30",
"symbol": "VN30",
"last": 1290.45,
"high": 1305.20,
"low": 1285.30,
"chg": 15.25,
"chgPct": 1.20,
"isOpen": true,
"flag": "VN",
"time": 1716458537
}
4. 获取VN30的K线数据
http
GET https://api.stocktv.top/stock/kline?pid={VN30的PID}&interval=P1D&key=您的API_KEY
时间间隔参数:
PT5M
- 5分钟PT15M
- 15分钟PT1H
- 1小时P1D
- 1天P1W
- 1周P1M
- 1月
5. WebSocket实时数据(推荐)
javascript
// WebSocket连接
const ws = new WebSocket("wss://ws-api.stocktv.top/connect?key=您的API_KEY");
// 订阅VN30指数实时数据
ws.onopen = function() {
// 发送订阅消息(具体格式需咨询API提供商)
ws.send(JSON.stringify({
action: "subscribe",
symbol: "VN30",
type: "index"
}));
};
// 接收实时数据
ws.onmessage = function(event) {
const data = JSON.parse(event.data);
console.log("VN30实时数据:", data);
};
使用步骤:
- 获取API密钥:联系API提供商获取有效的key
- 确定越南国家ID:咨询提供商获取越南的国家ID值
- 获取VN30的PID:先调用指数列表接口找到VN30对应的id
- 开始对接:使用上述接口获取实时数据、历史K线等
注意事项:
- 所有请求都需要有效的API密钥
- 越南市场交易时间与越南时区相关
- WebSocket连接需要保持心跳以维持连接
- 建议先测试获取指数列表,确认VN30的数据格式和字段含义
如果您需要更具体的实现代码或遇到具体的技术问题,请提供更多详细信息。