按名称或行业关键词搜索印度股票和基金,返回 NSE 代码、BSE 证券代码、RIC 代码、行业板块和趋势标签
查看 印度股票交易所 API 的全部接口 →按文本关键词搜索印度上市标的,返回由匹配对象组成的 JSON 数组。query 为必填(例如 tata)。接口文档把它描述为在某个行业内搜索;实测调用(query=tata)返回 HTTP 200 和包含 17 个对象的 JSON 数组,每个对象都有相同的十个键:id(内部标识,例如 S0003051)、commonName、stockType、exchangeCodeBse(字符串形式的 BSE 数字证券代码)、exchangeCodeNsi(NSE 代码)、bseRic、nseRic(路透风格代码,例如 TCS.BO 和 TCS.NS)、mgIndustry、mgSector,以及 activeStockTrends——一个包含 shortTermTrends、longTermTrends 和 overallRating 的对象。在实测中,stockType 为 Equity 的有 12 行,Fund(ETF)有 3 行,为 null 的有 2 行;exchangeCodeNsi 有一行为 null,exchangeCodeBse 有一只基金是空字符串。同样在实测中,17 行的 mgIndustry 和 mgSector 全部为 null,三个趋势字段的文本值全是 NA。未经验证的来源示例中这些字段是有值的(例如 Software & Programming、Technology、Bearish 和 Bullish),并且列出的是 TATAMOTORS 和 Tata Motors DVR,而实测返回的是 TMCV 和 TMPV,所以请把示例值仅当作示意。接口没有声明分页或过滤参数,最多返回多少条匹配也未经验证。这些数据仅供参考,不构成投资建议。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/indian-stock-exchange-api/industry-search API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/indian-stock-exchange-api/industry-search?key=<API_KEY>&query=tata'
查询结果
使用场景
- 联想搜索框:用户每输入一个公司名称片段,就返回匹配项的 NSE 代码、BSE 证券代码和 RIC。
- 标识符对照表:把内部 id、NSE 代码、BSE 数字代码和 RIC 导入数据仓库,用来关联不同数据供应商的数据源。
- 同集团公司清单:搜索 tata 这样的集团名称,只保留 Equity 记录,剔除 ETF 和基金条目。
- 详情调用前的预筛选:先读取每条搜索结果上的趋势标签,再决定是否花一次详情查询,跳过标记为 NA 的记录。
- 多类别股份检测:根据名称相近的特点,标出同一集团下的普通股与差异投票权股份。
- 聊天机器人环节:先把用户输入的公司名称转成 NSE 代码,再去调用行情或历史接口。
常见问题
行业搜索接口会返回什么?
返回一个由匹配对象组成的 JSON 数组。在 query=tata 的实测调用中,它返回了 17 个对象,每个都有 id、commonName、stockType、exchangeCodeBse、exchangeCodeNsi、bseRic、nseRic、mgIndustry、mgSector,以及包含 shortTermTrends、longTermTrends 和 overallRating 的 activeStockTrends 对象。
我需要传哪个参数?
只需要 query,且为必填。传入 tata 这样的搜索关键词即可。实测使用的是 query=tata,返回了 HTTP 200。
怎样根据公司名称拿到 NSE 代码和 BSE 代码?
在每个匹配项里,读取 exchangeCodeNsi 得到 NSE 代码,读取 exchangeCodeBse 得到 BSE 数字证券代码。bseRic 和 nseRic 字段给出对应的 RIC 代码,例如实测中 Tata Consultancy Services 那一行的 TCS.BO 和 TCS.NS。
为什么 mgIndustry 和 mgSector 是 null,趋势字段是 NA?
在 tata 的实测中,17 行记录的 mgIndustry 和 mgSector 都是 null,activeStockTrends 的三个字段也都是文本 NA。来源示例里这些字段是有值的,所以请把 null 和 NA 当作正常取值处理,而不是错误。
列表里只有股票吗?
不是。实测还返回了 stockType 为 Fund 的 ETF 记录,以及两条 stockType 为 null 的记录,其中一条的 NSE 代码也是 null。如果你只想要上市公司股票,请过滤 stockType 等于 Equity 的记录。
可以按行业名称而不是公司名称搜索吗?
接口文档把这个搜索描述为查询某个行业,但实测只用了公司名称词干(tata)。software 或 auto 这样的行业关键词尚未验证,所以在依赖它之前,请先测试你要用的关键词。
文档示例里的代码还是最新的吗?
不一定。来源示例列出的是 TATAMOTORS 和 Tata Motors DVR,而实测返回的是 Tata Motors 对应的 TMCV 和 Tata Motors Passenger Vehicles Ltd 对应的 TMPV。当前的代码和证券代码请始终以实时响应为准。