实时获取印度国家股票数据 API 实操

实时获取印度国家股票数据 API 实操

在金融数据开发中，实时性和稳定性至关重要。本文将带你快速上手一款 不限接口访问次数、支持 WebSocket 实时推送 的印度股票行情 API。通过免费申请的 Key 即可使用，官网地址：https://pao.stocktv.top/

---

一、前置准备

1. 注册并申请 API Key
   访问 https://pao.stocktv.top/，完成邮箱注册后即可免费获得 key。
2. 开发环境
   • Node.js >= 14 或任意支持 curl、WebSocket 的语言环境
   • 网络可访问 api.stocktv.top 和 ws-api.stocktv.top

---

二、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/

希望本文能帮你快速集成并实时获取印度股票数据，有任何问题欢迎在评论区留言交流！