三、财务信息
3.10 板块 / 行业成分股
GET
/api/sector_stock_listGET
/api/sector_quote_list某个板块或行业的全部成分股;sector_quote_list 是成分股的实时行情。
请求
请求头 Authorization:你的密钥(必填)。
| 参数 | 是否必填 | 说明 |
|---|---|---|
| country | 必填 | 国家,如 america;全部取值见「国家与市场参数」 |
| type | 必填 | sector 板块 / industry 行业 |
| name | 必填 | 板块或行业名称,取自「板块清单」,需要 URL 编码 |
说明
sector_stock_list每条:market、symbol、name、category 类型、sector、industry。sector_quote_list参数相同,每条是 market、symbol、price、up、change、volume、tick,按成交量从大到小排列(没有名称,名称用 sector_stock_list 取)。- 名称不存在时
data是空数组。
返回
统一外壳 {status, message, data, total, page, market, symbol, code, interval},数据在 data 里。出错时 HTTP 状态码仍是 200,status 为 500,message 是原因。
错误
| HTTP | 返回 | 情况 |
|---|---|---|
| 200 | {"Cmd":"api","State":-1,"Msg":"没有订阅产品权限"} | 没带 country |
| 200 | status=500 Type(sector|industry) is required | type 写错 |
示例:sector_stock_list
GET
/sector_stock_list?country=america&type=sector&name=Electronic%20technology请求头 Authorization: 你的密钥 · HTTP 200
{
"status": 0, // 0 成功,500 失败
"message": "SUCCESS", // 成功为 SUCCESS,失败时是原因
"data": [ // 每个成分股一条
{
"market": "NASDAQ", // 市场代码
"symbol": "AAPL", // 产品代码
"name": "Apple Inc.", // 名称
"category": "stock", // 类型
"sector": "Electronic technology", // 板块
"industry": "Telecommunications equipment" // 行业
},
{
"market": "NASDAQ", // 市场代码
"symbol": "NVDA", // 产品代码
"name": "NVIDIA Corporation", // 名称
"category": "stock", // 类型
"sector": "Electronic technology", // 板块
"industry": "Semiconductors" // 行业
}
],
"total": 0, // 总条数,分页的接口才有值
"page": 0, // 当前页,分页的接口才有值
"market": null, // 市场代码
"symbol": null, // 产品代码
"code": null, // 产品代码
"interval": null // K 线周期,这类接口不用
}共 360 条,示例只列出其中 AAPL、NVDA 这 2 条。
示例:sector_quote_list
GET
/sector_quote_list?country=america&type=sector&name=Electronic%20technology请求头 Authorization: 你的密钥 · HTTP 200
{
"status": 0, // 0 成功,500 失败
"message": "SUCCESS", // 成功为 SUCCESS,失败时是原因
"data": [ // 每个成分股一条,按成交量从大到小
{
"market": "NASDAQ", // 市场代码
"symbol": "AAPL", // 产品代码
"price": 333.69, // 最新价
"up": 1.02, // 涨跌幅(%)
"change": 3.37, // 涨跌
"volume": 68359.326131, // 成交量
"tick": 1791196790 // 时间,Unix 秒
},
{
"market": "NASDAQ", // 市场代码
"symbol": "NVDA", // 产品代码
"price": 233.95, // 最新价
"up": 1.338, // 涨跌幅(%)
"change": 3.09, // 涨跌
"volume": 729704.76748, // 成交量
"tick": 1791196792 // 时间,Unix 秒
}
],
"total": 0, // 总条数,分页的接口才有值
"page": 0, // 当前页,分页的接口才有值
"market": null, // 市场代码
"symbol": null, // 产品代码
"code": null, // 产品代码
"interval": null // K 线周期,这类接口不用
}共 360 条,示例只列出其中 AAPL、NVDA 这 2 条。