引言：为什么关注印度BSE交易所？

文章大纲

1. 引言：为什么关注印度BSE交易所？
2. 准备工作：获取API密钥与理解关键参数
3. 核心API接口详解
   • 获取BSE股票列表
   • 查询特定股票实时行情
   • 获取指数数据（如S&P BSE SENSEX）
   • 获取K线数据
4. 高级功能与实时数据
   • IPO新股日历
   • 涨跌排行榜
   • WebSocket实时推送
5. 实战代码示例（Python）
6. 注意事项与最佳实践
   • 频率限制
   • 时区处理
   • 错误处理
7. 结语

引言：为什么关注印度BSE交易所？

印度孟买证券交易所（BSE）是亚洲最古老的证券交易所，也是印度两大主要证券交易市场之一。随着印度经济的快速增长，BSE市场吸引了大量全球投资者的目光。对于开发者而言，能够便捷地获取BSE的实时股票数据，是构建量化交易系统、投资分析平台或金融看板应用的关键第一步。

本文将基于 StockTV 提供的 API，详细讲解如何快速、稳定地对接印度BSE交易所的股票数据接口，涵盖从获取API密钥、查询实时行情到订阅实时推送的全流程，并提供完整的Python代码示例。

准备工作：获取API密钥与理解关键参数

在开始调用API之前，需要完成两项准备：

1. 获取API Key：所有接口调用都需要在请求参数中携带有效的API Key进行身份验证。你可以通过官方提供的联系方式（如Telegram）申请密钥。密钥格式通常类似 MY4b781f618e3f43c4b055f25fa61941ad。
2. 理解关键参数：对接印度BSE市场，以下两个参数至关重要：
   • countryId=14：这代表印度市场，是几乎所有接口的必填参数。
   • exchangeId=74：这是BSE（孟买证券交易所）在系统中的唯一标识符。另一个主要交易所NSE的ID是46。

API基础地址为：https://api.stocktv.top。

核心API接口详解

1. 获取BSE股票列表

这是获取数据的第一步，目的是得到BSE上市公司的基本信息和唯一标识符（id或pid），后续查询详细行情都需要用到它。

• 接口地址：GET /stock/stocks

• 请求参数：
  | 参数名 | 必填 | 说明 |
  | :--- | :--- | :--- |
  | countryId | 是 | 印度市场ID，固定为 14 |
  | exchangeId | 否 | BSE交易所ID，此处应填 74 |
  | pageSize | 否 | 每页数量 |
  | page | 否 | 页码 |
  | key | 是 | 你的API密钥 |

• 返回示例：返回的JSON数据中，data.records数组包含了股票列表，每个股票对象都有 id（后续接口中的pid）、symbol（股票代码）、name（公司名称）、last（最新价）、chgPct（涨跌幅）等关键字段。

2. 查询特定股票实时行情

在已知股票ID (pid)、代码 (symbol) 或名称 (name) 的情况下，可以直接查询其最新行情。

• 接口地址：GET /stock/queryStocks
• 请求参数：可使用 id、symbol、name 中的一个或多个进行查询。

3. 获取指数数据（如S&P BSE SENSEX）

S&P BSE SENSEX（敏感30指数）是BSE市场的风向标。通过此接口可以获取其实时点位和涨跌幅。

• 接口地址：GET /stock/indices
• 请求参数：countryId=14。
• 返回示例：从返回的指数列表中，可以找到 name 为 "S&P BSE SENSEX" 的指数数据。

4. 获取K线数据

这是绘制图表进行技术分析的核心接口，支持从1分钟到月线等多种时间粒度。

• 接口地址：GET /stock/kline

• 请求参数：
  | 参数名 | 必填 | 说明 |
  | :--- | :--- | :--- |
  | pid | 是 | 股票的唯一ID |
  | interval | 是 | 时间间隔，例如 PT15M(15分钟), P1D(日线) |
  | key | 是 | 你的API密钥 |

• 返回示例：接口返回指定时间周期的K线数据数组，每条数据包含时间戳 (time)、开盘价 (open)、最高价 (high)、最低价 (low)、收盘价 (close) 和成交量 (volume)。

高级功能与实时数据

IPO新股日历

印度IPO市场活跃，此接口可用于获取已上市或即将上市的新股信息。

• 接口地址：GET /stock/getIpo
• 请求参数：countryId=14，type=1（未上市）或 type=2（已上市）。

涨跌排行榜

快速发现市场中的热点股票。

• 接口地址：GET /stock/updownList
• 请求参数：countryId=14，type 参数可指定榜单类型（1=涨幅榜，2=跌幅榜，3=涨停榜，4=跌停榜）。

WebSocket实时推送

对于需要低延迟实时数据的应用（如交易终端），WebSocket是比反复轮询REST API更高效的选择。

• 连接地址：wss://ws-api.stocktv.top/connect?key=YOUR_KEY。
• 使用流程：建立连接后，发送订阅消息指定要关注的股票ID (pids)，服务器便会持续推送这些股票的实时行情变动。需要定期发送心跳消息（如"ping"）以保持连接。

实战代码示例（Python）

以下是一个完整的Python示例，演示如何获取BSE股票列表和SENSEX指数数据。

import requests

# 配置信息
API_KEY = "YOUR_API_KEY"  # 请替换为你的真实API Key
BASE_URL = "https://api.stocktv.top"
COUNTRY_ID = 14  # 印度
BSE_EXCHANGE_ID = 74  # BSE交易所

def get_bse_stocks(page_size=20):
    """
    获取BSE股票列表
    """
    url = f"{BASE_URL}/stock/stocks"
    params = {
   
        "countryId": COUNTRY_ID,
        "exchangeId": BSE_EXCHANGE_ID,
        "pageSize": page_size,
        "page": 1,
        "key": API_KEY
    }
    try:
        response = requests.get(url, params=params)
        response.raise_for_status()  # 如果请求失败会抛出HTTPError异常
        data = response.json()

        if data.get('code') == 200:
            stocks = data['data']['records']
            print("BSE股票列表（前{}条）:".format(page_size))
            for stock in stocks:
                print(f"股票代码: {stock['symbol']}, 名称: {stock['name']}, 最新价: {stock['last']}, 涨跌幅: {stock['chgPct']}%")
            return stocks
        else:
            print("请求失败:", data.get('message'))
            return None
    except requests.exceptions.RequestException as e:
        print("网络请求错误:", e)
        return None

def get_sensex_index():
    """
    获取S&P BSE SENSEX指数数据
    """
    url = f"{BASE_URL}/stock/indices"
    params = {
   
        "countryId": COUNTRY_ID,
        "key": API_KEY
    }
    try:
        response = requests.get(url, params=params)
        data = response.json()

        if data.get('code') == 200:
            indices = data['data']
            for index in indices:
                if index['name'] == 'S&P BSE SENSEX':
                    print(f"\nS&P BSE SENSEX 指数:")
                    print(f"最新点位: {index['last']}")
                    print(f"涨跌: {index['chg']}")
                    print(f"涨跌幅: {index['chgPct']}%")
                    return index
            print("未找到SENSEX指数数据")
            return None
        else:
            print("请求指数数据失败:", data.get('message'))
            return None
    except Exception as e:
        print("获取指数数据时发生错误:", e)
        return None

# 执行示例
if __name__ == "__main__":
    stocks = get_bse_stocks()
    sensex_data = get_sensex_index()

注意事项与最佳实践

1. 频率限制：REST API通常有调用频率限制（例如每分钟不超过10次请求），需合理安排请求间隔，避免触发限流。
2. 时区处理：印度标准时间（IST）为UTC+5:30，在处理时间戳数据时需要注意时区转换。
3. 错误处理：健壮的程序必须包含错误处理逻辑，检查HTTP状态码和响应体中的code字段（200表示成功，非200需处理错误）。
4. 数据缓存：对于不经常变动的数据（如股票列表、公司信息），可以考虑在本地实现缓存机制，以减少API调用次数。

结语

通过 StockTV API，我们可以以标准化的方式高效接入印度BSE交易所的丰富数据，从基础的实时行情到深度的K线和基本面信息。本文介绍的接口和代码示例为开发者提供了一个坚实的起点，助力快速构建面向印度市场的金融应用。

希望这篇指南对你有所帮助！如果在对接过程中遇到任何技术问题，建议查阅官方文档或与API提供方的技术支持团队联系。