实时获取印度国家股票数据 API 实操
实时获取印度国家股票数据 API 实操
在金融数据开发中，实时性和稳定性至关重要。本文将带你快速上手一款 不限接口访问次数、支持 WebSocket 实时推送 的印度股票行情 API。通过免费申请的 Key 即可使用，官网地址：https://pao.stocktv.top/
一、前置准备
- 注册并申请 API Key
访问 https://pao.stocktv.top/，完成邮箱注册后即可免费获得key。 - 开发环境
- Node.js >= 14 或任意支持
curl、WebSocket的语言环境 - 网络可访问
api.stocktv.top和ws-api.stocktv.top
- Node.js >= 14 或任意支持
二、REST API 系列
注意：所有 REST 接口均需在请求 URL 中带上
key，且参数countryId=14用于指定“印度”市场 :contentReference[oaicite:0]{index=0}。
1. 市场列表（Stocks List）
- 地址
GET https://api.stocktv.top/stock/stocks
- **参数**
| 参数 | 必选 | 描述 |
| ---------- | ---- | --------------------------- |
| countryId | 是 | 国家 ID，印度传 `14` |
| pageSize | 否 | 每页条数，默认 `10` |
| page | 否 | 页码，默认 `1` |
| key | 是 | 申请的 API Key |
- **示例**
```bash
curl "https://api.stocktv.top/stock/stocks?countryId=14&pageSize=20&page=1&key=YOUR_KEY"
2. 查询单只股票（Query Stock）
-
地址
GET https://api.stocktv.top/stock/queryStocks -
参数
参数 必选 描述 id 否 股票 pid key 是 API Key -
示例
curl "https://api.stocktv.top/stock/queryStocks?id=7310&key=YOUR_KEY"
3. 指数列表（Indices）
-
地址
GET https://api.stocktv.top/stock/indices -
参数
参数 必选 描述 countryId 是 国家 ID = 14 key 是 API Key -
示例
curl "https://api.stocktv.top/stock/indices?countryId=14&key=YOUR_KEY"
4. K 线数据（K-Line）
-
地址
GET https://api.stocktv.top/stock/kline -
参数
参数 必选 描述 pid 是 产品 ID（从市场列表接口获取） interval 是 PT5M/PT15M/PT1H/…（5 分钟、15 分钟、1 小时 等） key 是 API Key -
示例
curl "https://api.stocktv.top/stock/kline?pid=7310&interval=PT15M&key=YOUR_KEY"
5. IPO 新股日历（IPO Calendar）
-
地址
GET https://api.stocktv.top/stock/getIpo -
参数
参数 必选 描述 countryId 是 国家 ID = 14 key 是 API Key -
示例
curl "https://api.stocktv.top/stock/getIpo?countryId=14&key=YOUR_KEY"
6. 涨跌排行榜（Top Gainers & Losers）
-
地址
GET https://api.stocktv.top/stock/updownList -
参数
参数 必选 描述 countryId 是 国家 ID = 14 type 否 1=涨幅榜 2=跌幅榜 …（默认前 50 条） key 是 API Key -
示例
curl "https://api.stocktv.top/stock/updownList?countryId=14&type=1&key=YOUR_KEY"
7. 公司信息（Companies）
-
地址
GET https://api.stocktv.top/stock/companies -
参数
参数 必选 描述 countryId 是 国家 ID = 14 pageSize 否 每页条数 page 否 页码 key 是 API Key -
示例
curl "https://api.stocktv.top/stock/companies?countryId=14&pageSize=10&page=1&key=YOUR_KEY"
8. 国际新闻（News）
-
地址
GET https://api.stocktv.top/stock/news -
参数
参数 必选 描述 pageSize 否 每页条数 page 否 页码 key 是 API Key -
示例
curl "https://api.stocktv.top/stock/news?pageSize=5&page=1&key=YOUR_KEY"
三、WebSocket 实时推送
特点：持久连接、支持心跳、实时接收“买卖盘”、“最新价”、“涨跌幅”等。
// 前端示例（JavaScript）
const ws = new WebSocket("wss://ws-api.stocktv.top/connect?key=YOUR_KEY");// 连接成功
ws.onopen = () => console.log("WS 已连接");// 接收数据
ws.onmessage = (evt) => {const data = JSON.parse(evt.data);console.log("实时数据:", data);
};// 连接关闭
ws.onclose = () => console.log("WS 已断开");// 异常处理
ws.onerror = (err) => console.error("WS 错误", err);// 可选：发送心跳
setInterval(() => {ws.send(JSON.stringify({ type: "ping" }));
}, 30000);
返回字段示例
| 字段 | 含义 |
|---|---|
| pid | 产品 ID |
| last_numeric | 最新成交价 |
| bid / ask | 买一 / 卖一价格 |
| high / low | 当日最高 / 最低 |
| pc / pcp | 涨跌额 / 涨跌幅 |
| turnover_numeric | 成交额 |
| time / timestamp | 时间 / 时间戳 |
四、总结
- 无限次数访问，无需担心 QPS 限制
- REST + WebSocket 双重支持，满足不同场景
- 免费申请，即刻上手：https://pao.stocktv.top/
希望本文能帮你快速集成并实时获取印度股票数据，有任何问题欢迎在评论区留言交流！