概述
StockTV 提供全面的印度股票市场数据接口，覆盖印度国家证券交易所（NSE）和孟买证券交易所（BSE）所有上市公司。支持实时行情、技术分析、公司信息、IPO数据等多种功能。
基础信息
- 基础URL:
https://api.stocktv.top - WebSocket URL:
wss://ws-api.stocktv.top/connect - 数据格式: JSON
- 印度国家ID:
14 - 交易所ID:
- NSE:
46 - BSE:
74
- NSE:
快速开始
1. 获取 API Key
请联系官方获取有效的 API Key，所有接口调用都需要在参数中携带 key。
2. 基础请求示例
GET /stock/stocks?countryId=14&pageSize=10&page=1&key=您的API_KEY
核心功能接口
1. 股票市场列表
获取印度股票列表
GET /stock/stocks?countryId=14&pageSize=50&page=1&key=您的API_KEY
参数说明:
countryId: 国家ID，印度为14pageSize: 每页显示数量，默认10page: 页码，默认1exchangeId: 交易所ID（可选：46-NSE, 74-BSE）
响应示例:
{"code": 200,"message": "操作成功","data": {"records": [{"id": 7310,"symbol": "RELIANCE","name": "Reliance Industries Ltd","last": 2456.75,"chg": 12.50,"chgPct": 0.51,"high": 2468.20,"low": 2442.10,"volume": 4521890,"open": false,"exchangeId": 46,"countryId": 14,"countryNameTranslated": "India","flag": "IN","fundamentalMarketCap": 16500000000000,"fundamentalRevenue": "8.3T","technicalDay": "buy","performanceDay": 0.51,"performanceWeek": 2.15,"performanceMonth": 5.32,"time": 1716448222,"url": "/equities/reliance-industries-ltd"}],"total": 5000,"size": 50,"current": 1,"pages": 100}
}
2. 个股查询
查询单个股票
GET /stock/queryStocks?id=7310&key=您的API_KEY
查询参数（可单独或组合使用）:
id: 股票PIDsymbol: 股票代码name: 股票名称url: 详情页链接
批量查询多个股票
GET /stock/stocksByPids?key=您的API_KEY&pids=7310,17976,8923
热门印度股票代码:
RELIANCE: Reliance IndustriesTCS: Tata Consultancy ServicesHDFCBANK: HDFC BankINFY: InfosysHINDUNILVR: Hindustan UnileverITC: ITC LimitedSBIN: State Bank of India
3. 指数数据
获取印度主要指数
GET /stock/indices?countryId=14&key=您的API_KEY
包含的主要指数:
- Nifty 50
- Nifty Bank
- BSE Sensex
- Nifty IT
- Nifty Pharma
响应示例:
{"code": 200,"message": "操作成功","data": [{"id": 17940,"name": "Nifty 50","symbol": "NSEI","last": 22967.65,"chg": 369.85,"chgPct": 1.64,"high": 22993.6,"low": 22577.45,"isOpen": false,"flag": "IN","url": "/indices/s-p-cnx-nifty","time": 1716458537}]
}
通过ID查询特定指数
GET /stock/indicesById?id=17940&key=您的API_KEY
4. K线数据
获取股票K线数据
GET /stock/kline?pid=7310&interval=PT15M&key=您的API_KEY
时间间隔参数:
PT5M: 5分钟PT15M: 15分钟PT1H: 1小时PT5H: 5小时P1D: 1天P1W: 1周P1M: 1月
响应示例:
{"code": 200,"message": "操作成功","data": [{"time": 1719818400000,"open": 239.42,"high": 239.6,"low": 239.42,"close": 239.6,"volume": 0,"vo": 0}]
}
5. IPO新股日历
获取印度IPO信息
GET /stock/getIpo?key=您的API_KEY&countryId=14&type=1
参数说明:
type: 1-未上市, 2-已上市
响应示例:
{"code": 200,"message": "操作成功","data": [{"id": 19,"ipoListing": 1724112000,"country": "India","company": "Saraswati Saree Depot Ltd(SARW)","exchange": "NSE","ipoValue": "1.6B","ipoPrice": "160.00","last": "158.23","symbol": "SARW","url": "/equities/saraswati-saree-depot","date": "2024-08-20","pid": 1218991}]
}
6. 涨跌排行榜
获取印度市场排行榜
GET /stock/updownList?countryId=14&type=1&key=您的API_KEY
排行榜类型:
type=1: 涨幅榜type=2: 跌幅榜type=3: 涨停榜type=4: 跌停榜
7. 公司信息
获取印度上市公司列表
GET /stock/companies?countryId=14&pageSize=20&page=1&key=您的API_KEY
通过URL查询详细公司信息
GET /stock/companyUrl?url=/equities/reliance-industries&key=您的API_KEY
响应示例:
{"code": 200,"message": "操作成功","data": {"companyName": "Reliance Industries Ltd Company Profile","description": "Reliance Industries Limited is engaged in hydrocarbon exploration and production, petroleum refining and marketing, petrochemicals, retail, and digital services...","industry": "Oil & Gas","sector": "Energy","employeeCount": 236820,"market": "India","countryId": 14,"url": "/equities/reliance-industries-ltd","id": 101}
}
8. 新闻数据
获取国际新闻（包含印度相关）
GET /stock/news?pageSize=10&page=1&key=您的API_KEY&type=2
WebSocket 实时数据
连接WebSocket服务器
const wsUri = "wss://ws-api.stocktv.top/connect?key=您的API_KEY";
const websocket = new WebSocket(wsUri);
WebSocket数据格式
{"pid": "7310","last_numeric": "2456.75","bid": "2456.50","ask": "2457.00","high": "2468.20","low": "2442.10","last_close": "2444.25","pc": "12.50","pcp": "0.51","pc_col": "greenFont","turnover_numeric": "4521890","time": "15:30:25","timestamp": "1717728251","type": 1
}
WebSocket字段说明
pid: 产品IDlast_numeric: 最新价格bid: 买入价ask: 卖出价high: 最高价low: 最低价last_close: 前收盘价pc: 价格变化pcp: 涨跌幅百分比pc_col: 价格变化颜色turnover_numeric: 成交量time: 交易时间timestamp: 时间戳type: 类型（1-股票, 2-指数）
技术指标数据
技术分析指标
股票数据中包含以下技术指标：
技术指标字段:
technicalDay: 日线技术指标technicalHour: 小时线技术指标technicalWeek: 周线技术指标technicalMonth: 月线技术指标
技术指标值:
strong_buy: 强烈买入buy: 买入neutral: 中性sell: 卖出strong_sell: 强烈卖出
基本面数据
财务指标
fundamentalBeta: Beta值fundamentalMarketCap: 市值fundamentalRevenue: 收入fundamentalRatio: 基本面比率
业绩表现
performanceDay: 当日表现performanceWeek: 周表现performanceMonth: 月表现performanceYear: 年度表现performanceYtd: 年初至今表现performance3Year: 3年表现
使用示例
获取Nifty 50成分股
GET /stock/stocks?countryId=14&pageSize=50&key=您的API_KEY
查询Reliance Industries
GET /stock/queryStocks?symbol=RELIANCE&key=您的API_KEY
获取实时指数
GET /stock/indices?countryId=14&key=您的API_KEY
批量查询银行股
GET /stock/stocksByPids?key=您的API_KEY&pids=7310,17976,8923,11567,12894
获取日K线数据
GET /stock/kline?pid=7310&interval=P1D&key=您的API_KEY
数据字段详细说明
股票数据字段
| 字段名 | 说明 | 数据类型 |
|---|---|---|
| id | 股票PID | Long |
| symbol | 股票代码 | String |
| name | 股票名称 | String |
| last | 最新价格 | BigDecimal |
| chg | 涨跌额 | BigDecimal |
| chgPct | 涨跌幅百分比 | BigDecimal |
| high | 最高价 | BigDecimal |
| low | 最低价 | BigDecimal |
| volume | 成交量 | Long |
| open | 是否开市 | Boolean |
| exchangeId | 交易所ID | Integer |
| countryId | 国家ID | Integer |
| time | 时间戳 | Long |
| fundamentalMarketCap | 市值 | BigDecimal |
| fundamentalRevenue | 收入 | String |
| technicalDay | 日线技术指标 | String |
K线数据字段
| 字段名 | 说明 | 数据类型 |
|---|---|---|
| time | 时间戳 | Long |
| open | 开盘价 | BigDecimal |
| high | 最高价 | BigDecimal |
| low | 最低价 | BigDecimal |
| close | 收盘价 | BigDecimal |
| volume | 成交量 | Long |
| vo | 成交额 | BigDecimal |
错误处理
错误响应格式
{"code": 400,"message": "参数错误","data": null
}
常见错误代码
200: 操作成功400: 参数错误401: API Key无效404: 数据不存在500: 服务器内部错误
最佳实践
1. 批量数据获取
使用 stocksByPids 接口批量获取数据，减少API调用次数。
2. 实时数据监控
对于实时性要求高的场景，使用WebSocket连接。
3. 缓存策略
对公司信息等不经常变化的数据实施缓存。
4. 错误处理
实现适当的错误重试机制。
5. 频率控制
注意API调用频率限制，避免过度请求。
注意事项
交易时间
- NSE/BSE: 印度时间 09:15-15:30
- 时区: IST (UTC+5:30)
货币单位
所有价格均为印度卢比 (INR)。
