按名称或行业关键词搜索印度股票和基金,返回 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 功能

每条匹配都带全部标识符 每个匹配项都有内部 id、NSE 代码(exchangeCodeNsi)、BSE 证券代码(exchangeCodeBse)以及 bseRic 和 nseRic,一次调用就能把一个名称解析成所有这些标识。
股票与基金出现在同一个列表 搜索 tata 的实测结果里混有 12 条 Equity、3 条 Fund(ETF)以及 2 条 stockType 为 null 的记录,客户端只需按 stockType 过滤,就能保留或排除某类标的。
每行都有行业与板块字段 mgIndustry 和 mgSector 出现在每个匹配项中。它们在 17 条实测记录里都是 null,所以应视为可选字段;来源示例中则有 Software & Programming 和 Technology 这样的值。
搜索结果自带趋势标签 activeStockTrends 以文本形式返回 shortTermTrends、longTermTrends 和 overallRating。实测中每一行的三个字段都是 NA;来源示例里则有 Bullish 和 Moderately Bearish 等标签。
只需要一个自由文本关键词 query 是唯一的输入,接受 tata 这样的普通文本。没有分页或过滤参数需要配置,因此联想搜索框的接入工作量非常小。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

行业搜索接口会返回什么?

返回一个由匹配对象组成的 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。当前的代码和证券代码请始终以实时响应为准。

相关接口

相关指南

查看订阅方案 →