股东人数 - API文档

基本信息

接口地址

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

数据格式

JSON

请求方式

GET

请求示例

https://api.qixin.com/APIService/qc/getShareholderNumList?name=深圳市宇顺电子股份有限公司

描述

上市企业股东人数信息，包括前十大股东（流通股东）持股合计，股东总户数、人均已流通股、及变化等信息

请求参数 (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，以此类推进行取数）

响应参数

参数名	类型	长度	描述
`data` data.data	Object	0	返回查询结果，如果没有匹配记录则返回为空。具体字段含义见下表
`total` data.data.total	Number	0	返回列表中记录总数
`items` data.data.items	Array	0	股东信息列表
`totsharehdratio` data.data.items.totsharehdratio	String	255	前十大股东持股合计
`totcirholdratio` data.data.items.totcirholdratio	String	255	前十大流通股东持股合计
`totalsh` data.data.items.totalsh	String	50	股东总户数
`avgurshareradio` data.data.items.avgurshareradio	String	255	人均已流通股较上期变化
`totalshchangeradio` data.data.items.totalshchangeradio	String	255	股东户数较上期变化
`enddate` data.data.items.enddate	String	50	截止日期
`avgurshare` data.data.items.avgurshare	String	255	人均已流通股
`sign` data.sign	String	32	数据签名
`status` data.status	String	10	返回结果状态
`message` data.message	String	255	返回结果消息

响应示例

JSON

{
    "status": "200",
    "message": "操作成功",
    "sign": "238c40c486310da5a58c186c28b0df06",
    "data": {
        "items": [
            {
                "totcirholdratio": "42.9785",
                "totsharehdratio": "48.52",
                "enddate": "2022-06-30",
                "avgurshare": "14677.735167",
                "totalsh": "18000",
                "avgurshareradio": "-27.777778",
                "totalshchangeradio": "38.461538"
            },
            {
                "totcirholdratio": "42.9785",
                "totsharehdratio": "48.52",
                "enddate": "2022-06-20",
                "avgurshare": "20323.017923",
                "totalsh": "13000",
                "avgurshareradio": "-",
                "totalshchangeradio": "0"
            },
            {
                "totcirholdratio": "42.9785",
                "totsharehdratio": "48.52",
                "enddate": "2022-06-10",
                "avgurshare": "20323.017923",
                "totalsh": "13000",
                "avgurshareradio": "7.692308",
                "totalshchangeradio": "-7.142857"
            },
            {
                "totcirholdratio": "42.9785",
                "totsharehdratio": "48.52",
                "enddate": "2022-05-31",
                "avgurshare": "18871.373786",
                "totalsh": "14000",
                "avgurshareradio": "14.285714",
                "totalshchangeradio": "-12.5"
            },
            {
                "totcirholdratio": "42.9785",
                "totsharehdratio": "48.52",
                "enddate": "2022-05-20",
                "avgurshare": "16512.452063",
                "totalsh": "16000",
                "avgurshareradio": "-18.75",
                "totalshchangeradio": "23.076923"
            },
            {
                "totcirholdratio": "42.9785",
                "totsharehdratio": "48.52",
                "enddate": "2022-05-10",
                "avgurshare": "20323.017923",
                "totalsh": "13000",
                "avgurshareradio": "7.692308",
                "totalshchangeradio": "-7.142857"
            },
            {
                "totcirholdratio": "42.8919",
                "totsharehdratio": "48.43",
                "enddate": "2022-04-08",
                "avgurshare": "18871.373786",
                "totalsh": "14000",
                "avgurshareradio": "0.971429",
                "totalshchangeradio": "-0.962083"
            },
            {
                "totcirholdratio": "42.8919",
                "totsharehdratio": "48.43",
                "enddate": "2022-03-31",
                "avgurshare": "18689.815577",
                "totalsh": "14136",
                "avgurshareradio": "-0.962083",
                "totalshchangeradio": "0.971429"
            },
            {
                "totcirholdratio": "42.8919",
                "totsharehdratio": "48.43",
                "enddate": "2022-03-10",
                "avgurshare": "18871.373786",
                "totalsh": "14000",
                "avgurshareradio": "-7.142857",
                "totalshchangeradio": "7.692308"
            },
            {
                "totcirholdratio": "42.8919",
                "totsharehdratio": "48.43",
                "enddate": "2022-02-28",
                "avgurshare": "20323.017923",
                "totalsh": "13000",
                "avgurshareradio": "7.692308",
                "totalshchangeradio": "-7.142857"
            },
            {
                "totcirholdratio": "42.8919",
                "totsharehdratio": "48.43",
                "enddate": "2022-02-18",
                "avgurshare": "18871.373786",
                "totalsh": "14000",
                "avgurshareradio": "-7.142857",
                "totalshchangeradio": "7.692308"
            },
            {
                "totcirholdratio": "44.0289",
                "totsharehdratio": "49.57",
                "enddate": "2022-02-10",
                "avgurshare": "20340.325615",
                "totalsh": "13000",
                "avgurshareradio": "-",
                "totalshchangeradio": "0"
            },
            {
                "totcirholdratio": "44.0289",
                "totsharehdratio": "49.57",
                "enddate": "2022-01-28",
                "avgurshare": "20340.325615",
                "totalsh": "13000",
                "avgurshareradio": "7.692308",
                "totalshchangeradio": "-7.142857"
            },
            {
                "totcirholdratio": "44.0289",
                "totsharehdratio": "49.57",
                "enddate": "2022-01-20",
                "avgurshare": "18887.445214",
                "totalsh": "14000",
                "avgurshareradio": "-",
                "totalshchangeradio": "0"
            },
            {
                "totcirholdratio": "44.0289",
                "totsharehdratio": "49.57",
                "enddate": "2022-01-10",
                "avgurshare": "18887.445214",
                "totalsh": "14000",
                "avgurshareradio": "-",
                "totalshchangeradio": "0"
            },
            {
                "totcirholdratio": "44.0289",
                "totsharehdratio": "49.57",
                "enddate": "2021-12-31",
                "avgurshare": "17089.396562",
                "totalsh": "15473",
                "avgurshareradio": "-9.519809",
                "totalshchangeradio": "10.521429"
            },
            {
                "totcirholdratio": "44.0289",
                "totsharehdratio": "49.57",
                "enddate": "2021-12-20",
                "avgurshare": "18887.445214",
                "totalsh": "14000",
                "avgurshareradio": "7.142857",
                "totalshchangeradio": "-6.666667"
            },
            {
                "totcirholdratio": "44.0289",
                "totsharehdratio": "49.57",
                "enddate": "2021-12-10",
                "avgurshare": "17628.2822",
                "totalsh": "15000",
                "avgurshareradio": "-6.666667",
                "totalshchangeradio": "7.142857"
            },
            {
                "totcirholdratio": "44.0289",
                "totsharehdratio": "49.57",
                "enddate": "2021-11-10",
                "avgurshare": "18887.445214",
                "totalsh": "14000",
                "avgurshareradio": "-14.285714",
                "totalshchangeradio": "16.666667"
            },
            {
                "totcirholdratio": "44.0289",
                "totsharehdratio": "49.57",
                "enddate": "2021-10-29",
                "avgurshare": "22035.35275",
                "totalsh": "12000",
                "avgurshareradio": "-",
                "totalshchangeradio": "0"
            }
        ],
        "total": 165
    }
}

代码示例

javascript

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

let baseUrl = 'https://api.qixin.com/APIService/qc/getShareholderNumList';
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的值'
}

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/getShareholderNumList";
        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的值");

        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/getShareholderNumList";
            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的值");

            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/getShareholderNumList'
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的值'
}

# 构造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.2-股东人数.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