十大流通股东

基本信息

接口地址

https://api.qixin.com/APIService/qc/getTopTenCirPartnerList

数据格式

JSON

请求方式

GET

请求示例

https://api.qixin.com/APIService/qc/getTopTenCirPartnerList?name=深圳市特力（集团）股份有限公司&date=2022-06-30

描述

上市企业十大流通股东信息，包括前十大流通股东股东名称、股份类型，及持股比例、本期变动比例等

请求参数 (Headers)

参数名	类型	必填	描述
`Auth-Version`	String	是	2.0（参数值），固定传入：2.0
`appkey`	String	是	启信慧眼数据开放平台获取，获取方式：个人中心-安全中心-API 密钥，获取appkey的同时，请完成IP白名单的配置：个人中心-安全中心-API IP白名单设置，如未配置，接口调试会报错“104 未添加IP白名单”
`timestamp`	String	是	UNIX时间戳，精确到毫秒，示例：1656921036000，当前系统时间近10分钟有效
`sign`	String	是	请求认证签名，对appkey+timestamp+secret_key进行md5或者sha256摘要计算的结果，小写字符串（实际加密不带入‘+’）

请求参数 (Query)

参数名	类型	必填	描述
`name`	String	是	企业全名/注册号/统一社会信用代码
`skip`	Number	否	跳过条目数（跳过的条数，默认不填返回前20条，取21到40条的数据，skip=20，以此类推进行取数）
`date`	String	是	发布日期，每个季度最后一天，格式： YYYY-MM-DD

响应参数

参数名	类型	长度	描述
`data` data.data	Object	0	返回查询结果，如果没有匹配记录则返回为空。具体字段含义见下表
`total` data.data.total	Number	0	返回列表中记录总数
`items` data.data.items	Array	0	十大流动股东信息列表
`sharestype` data.data.items.sharestype	String	400	股份类型
`sharehdnum` data.data.items.sharehdnum	String	50	持股数
`changeamountratio` data.data.items.changeamountratio	String	59	本期变动比例
`listsharratio` data.data.items.listsharratio	String	50	占已上市流通股比例
`changeamount` data.data.items.changeamount	String	59	本期变动股数
`sharehdtypecode` data.data.items.sharehdtypecode	String	36	股东类型code
`sharehdcode` data.data.items.sharehdcode	String	36	股东代码eid
`sharehdratio` data.data.items.sharehdratio	String	50	持股比例
`sharehdtype` data.data.items.sharehdtype	String	400	股东类型
`reportdate` data.data.items.reportdate	String	255	报告日期
`sharehdname` data.data.items.sharehdname	String	1600	股东名称
`ifpledge` data.data.items.ifpledge	String	255	是否抵押
`eid` data.data.items.eid	String	36	企业eid
`sign` data.sign	String	32	数据签名
`status` data.status	String	10	返回结果状态
`message` data.message	String	255	返回结果消息

响应示例

JSON

{
    "status": "200",
    "message": "操作成功",
    "sign": "4afd3e656dbcc20552541fd0790b5cb0",
    "data": {
        "items": [
            {
                "sharehdcode": "c92f9ecb-5752-466b-b5e0-60f8fe841643",
                "sharehdratio": "49.086500",
                "sharehdname": "深圳市特发集团有限公司",
                "changeamountratio": "",
                "reportdate": "2022-03-31",
                "listsharratio": "53.8705",
                "sharehdtypecode": "019",
                "sharehdtype": "其它",
                "ifpledge": false,
                "changeamount": "-",
                "sharestype": "A股",
                "eid": "9bf76b5a-a3e8-4caf-8936-4c14be888a78",
                "sharehdnum": "211591621"
            },
            {
                "sharehdcode": "f7c8e771-d614-434e-89f7-66485839147f",
                "sharehdratio": "11.885600",
                "sharehdname": "深圳远致富海珠宝产业投资企业(有限合伙)",
                "changeamountratio": "-7.760426",
                "reportdate": "2022-03-31",
                "listsharratio": "13.044",
                "sharehdtypecode": "014",
                "sharehdtype": "投资公司",
                "ifpledge": false,
                "changeamount": "-4310485",
                "sharestype": "A股",
                "eid": "9bf76b5a-a3e8-4caf-8936-4c14be888a78",
                "sharehdnum": "51233952"
            },
            {
                "sharehdcode": "1eb3cdfe-be29-11e6-b0ed-00163e014a2c",
                "sharehdratio": "0.408700",
                "sharehdname": "GUOTAI JUNAN SECURITIES(HONGKONG) LIMITED",
                "changeamountratio": "-5.098446",
                "reportdate": "2022-03-31",
                "listsharratio": "-",
                "sharehdtypecode": "017",
                "sharehdtype": "证券公司",
                "ifpledge": false,
                "changeamount": "-94655",
                "sharestype": "B股",
                "eid": "9bf76b5a-a3e8-4caf-8936-4c14be888a78",
                "sharehdnum": "1761891"
            },
            {
                "sharehdcode": "",
                "sharehdratio": "0.226400",
                "sharehdname": "中国建设银行股份有限公司-广发中证全指汽车指数型发起式证券投资基金",
                "changeamountratio": "2.953530",
                "reportdate": "2022-03-31",
                "listsharratio": "0.2485",
                "sharehdtypecode": "018",
                "sharehdtype": "证券投资基金",
                "ifpledge": false,
                "changeamount": "28000",
                "sharestype": "A股",
                "eid": "9bf76b5a-a3e8-4caf-8936-4c14be888a78",
                "sharehdnum": "976018"
            },
            {
                "sharehdcode": "",
                "sharehdratio": "0.199700",
                "sharehdname": "石秀民",
                "changeamountratio": "100.000000",
                "reportdate": "2022-03-31",
                "listsharratio": "0.2191",
                "sharehdtypecode": "006",
                "sharehdtype": "个人",
                "ifpledge": false,
                "changeamount": "860635",
                "sharestype": "A股",
                "eid": "9bf76b5a-a3e8-4caf-8936-4c14be888a78",
                "sharehdnum": "860635"
            },
            {
                "sharehdcode": "",
                "sharehdratio": "0.165800",
                "sharehdname": "黄清双",
                "changeamountratio": "100.000000",
                "reportdate": "2022-03-31",
                "listsharratio": "0.182",
                "sharehdtypecode": "006",
                "sharehdtype": "个人",
                "ifpledge": false,
                "changeamount": "714700",
                "sharestype": "A股",
                "eid": "9bf76b5a-a3e8-4caf-8936-4c14be888a78",
                "sharehdnum": "714700"
            },
            {
                "sharehdcode": "",
                "sharehdratio": "0.154600",
                "sharehdname": "李国勇",
                "changeamountratio": "100.000000",
                "reportdate": "2022-03-31",
                "listsharratio": "0.1697",
                "sharehdtypecode": "006",
                "sharehdtype": "个人",
                "ifpledge": false,
                "changeamount": "666400",
                "sharestype": "A股",
                "eid": "9bf76b5a-a3e8-4caf-8936-4c14be888a78",
                "sharehdnum": "666400"
            },
            {
                "sharehdcode": "",
                "sharehdratio": "0.133800",
                "sharehdname": "徐菲蓉",
                "changeamountratio": "-0.121259",
                "reportdate": "2022-03-31",
                "listsharratio": "0.1468",
                "sharehdtypecode": "006",
                "sharehdtype": "个人",
                "ifpledge": false,
                "changeamount": "-700",
                "sharestype": "A股",
                "eid": "9bf76b5a-a3e8-4caf-8936-4c14be888a78",
                "sharehdnum": "576578"
            },
            {
                "sharehdcode": "",
                "sharehdratio": "0.133100",
                "sharehdname": "杨建锋",
                "changeamountratio": "13.791154",
                "reportdate": "2022-03-31",
                "listsharratio": "0.1461",
                "sharehdtypecode": "006",
                "sharehdtype": "个人",
                "ifpledge": false,
                "changeamount": "69535",
                "sharestype": "A股",
                "eid": "9bf76b5a-a3e8-4caf-8936-4c14be888a78",
                "sharehdnum": "573735"
            },
            {
                "sharehdcode": "",
                "sharehdratio": "0.132900",
                "sharehdname": "肖桥月",
                "changeamountratio": "100.000000",
                "reportdate": "2022-03-31",
                "listsharratio": "0.1458",
                "sharehdtypecode": "006",
                "sharehdtype": "个人",
                "ifpledge": false,
                "changeamount": "572848",
                "sharestype": "A股",
                "eid": "9bf76b5a-a3e8-4caf-8936-4c14be888a78",
                "sharehdnum": "572848"
            }
        ],
        "total": 10,
        "date": "2022-03-31"
    }
}

代码示例

javascript

let request = require('request');
let urlEncode = require('urlencode');
let crypto = require('crypto');

let baseUrl = 'https://api.qixin.com/APIService/qc/getTopTenCirPartnerList';
let appkey = '正式appkey';
let secretKey = '正式secret_key';
let timeStamp = new Date().getTime();
const hash = crypto.createHash('md5');
let sign = hash.update(appkey + timeStamp + secretKey).digest('hex');

let urlParams = {
    name: 'name的值',
    skip: 'skip的值',
    date: 'date的值'
}

let concatParams = []
for (let key in urlParams) {
    concatParams.push(key + '=' + urlParams[key]);
}

let options = {
    'method': 'GET',
    'url': baseUrl + '?' + concatParams.join('&'),
    'headers': {
        'Connection': 'keep-alive',
        'Auth-version': '2.0',
        'appkey': appkey,
        'timestamp': timeStamp,
        'sign': sign
    }
};

request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});

java

import com.mashape.unirest.http.*;
import java.nio.charset.StandardCharsets;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.security.MessageDigest;
import java.util.Calendar;
import java.net.URLEncoder;

public class main {
    // 获取字符串的md5值
    public static String getMD5Str(String str) {
        byte[] digest = null;
        try {
            MessageDigest md = MessageDigest.getInstance("MD5");
            md.update(str.getBytes(StandardCharsets.UTF_8));
            digest = md.digest();

            StringBuilder sb = new StringBuilder();
            for (byte b : digest) {
                String s = String.format("%02x", b);
                sb.append(s);
            }
            return sb.toString();
        } catch (Exception e) {
            e.printStackTrace();
        }

        return null;
    }

    public static void main(String[] args) throws Exception {
        String baseUrl = "https://api.qixin.com/APIService/qc/getTopTenCirPartnerList";
        String appkey = "正式appkey";
        String secretKey = "正式secret_key";
        Calendar calendar = Calendar.getInstance();
        Long timestamp = calendar.getTime().getTime();
        String sign = getMD5Str(appkey + timestamp + secretKey);

        // 设置url参数
        Map<String, String> urlParams = new HashMap<String, String>();
        urlParams.put("name", "name的值");
        urlParams.put("skip", "skip的值");
        urlParams.put("date", "date的值");

        List<String> concatParams = new ArrayList<String>();
        for (String s : urlParams.keySet()) {
            concatParams.add(s + "=" + URLEncoder.encode(urlParams.get(s), StandardCharsets.UTF_8));
        }

        Unirest.setTimeouts(0, 2000);
        try {
            // 发送get请求，得到响应
            HttpResponse<String> response = Unirest.get(baseUrl + "?" + String.join("&", concatParams))
                    .header("Auth-version", "2.0")
                    .header("appkey", appkey)
                    .header("timestamp", timestamp + "")
                    .header("sign", sign)
                    .header("Content-Type", "application/json")
                    .asString();

            System.out.println(response.getBody());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

csharp

using System;
using System.Net.Http;
using System.Collections.Generic;
using System.Text;
using System.Text.Encodings.Web;
using System.Security.Cryptography;

namespace csharp
{
    class Program
    {
        public static string GetMD5Str(string str)
        {
            MD5 md5 = MD5.Create();
            byte[] buffer = Encoding.Default.GetBytes(str);
            byte[] MD5Buffer = md5.ComputeHash(buffer);

            //将字节数组转换成字符串
            string strResult = "";
            for (int i = 0; i < MD5Buffer.Length; i++)
            {
                strResult += MD5Buffer[i].ToString("x2");
            }

            return strResult;
        }

        static void Main(string[] args)
        {
            var baseUrl = "https://api.qixin.com/APIService/qc/getTopTenCirPartnerList";
            var appkey = "正式appkey";
            var secretKey = "正式secret_key";
            TimeSpan ts = DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, 0);
            var timeStamp = Convert.ToInt64(ts.TotalMilliseconds).ToString();  // 当前utc时间戳
            var sign = GetMD5Str(appkey + timeStamp + secretKey);              // 请求签名  

            // 设置url参数
            Dictionary<string, string> urlParams = new Dictionary<string, string>();
            urlParams.Add("name", "name的值");,
    urlParams.Add("skip", "skip的值");,
    urlParams.Add("date", "date的值");

            UrlEncoder ins = UrlEncoder.Create();
            List<string> concatParams = new List<string>();
            foreach (KeyValuePair<string, string> param in urlParams)
            {
                concatParams.Add(param.Key + "=" + ins.Encode(param.Value));
            }

            // 发送GET请求
            HttpClient httpClient = new HttpClient();
            httpClient.DefaultRequestHeaders.Add("Auth-version", "2.0");
            httpClient.DefaultRequestHeaders.Add("appkey", appkey);
            httpClient.DefaultRequestHeaders.Add("timestamp", timeStamp);
            httpClient.DefaultRequestHeaders.Add("sign", sign);
            httpClient.DefaultRequestHeaders.Add("Connection", "keep-alive");
            var urlWithParams = baseUrl + "?" + string.Join("&", concatParams.ToArray());
            var get = httpClient.GetAsync(urlWithParams);

            // 输出响应
            Console.WriteLine(get.Result.Content.ReadAsStringAsync().Result);
        }
    }
}

python

# -*- coding:utf-8 -*-

import requests
import json
import time
import hashlib
from urllib.parse import urlencode


def md5Encode(srcStr):
    '''计算字符串的md5值'''
    m = hashlib.md5()
    m.update(srcStr.encode('utf-8'))
    return m.hexdigest()


# 接口信息
baseUrl = 'https://api.qixin.com/APIService/qc/getTopTenCirPartnerList'
appkey = '正式appkey'
secretKey = '正式secret_key'
timeStamp = int(time.time()) * 1000

# 设置请求头部信息
headers = {
    'Auth-version': '2.0',              # 指定接口验证版本
    'appkey': appkey,
    'timestamp': str(timeStamp),
    'sign': md5Encode(appkey + str(timeStamp) + secretKey),
    'Connection': 'keep-alive'
}

# 请求参数
urlParams = {
    'name': 'name的值',
    'skip': 'skip的值',
    'date': 'date的值'
}

# 构造url
url = '{}?{}'.format(baseUrl, urlencode(urlParams))
print(url)

# 调用接口
response = requests.get(url, headers=headers)

# 处理响应数据
jsonContent = json.dumps(str(response.content, encoding='utf-8'))
rspResult = jsonContent.encode('utf-8').decode('unicode-escape')
print(rspResult)

文档下载

68.4-十大流通股东.pdf

PDF接口文档

证券信息 - 相关接口

股票信息 43.3 上市公司概况 68.1 股东人数 68.2 十大股东 68.3 十大流通股东 68.4 上市公司高管 68.5 股本结构 68.6 股本变动 68.7 十大股东持股变动 68.8 上市公司公告 68.9 上市公司员工构成 68.10 对外担保 68.11 违规处理 68.12 分红情况 68.13 增发情况 68.14 配股情况 68.15 财务主要指标 68.17 现金流量表 68.20 利润表 68.18 资产负债表 68.19