股本变动 - API文档

基本信息

接口地址

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

数据格式

JSON

请求方式

GET

请求示例

https://api.qixin.com/APIService/qc/getStockChangeList?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条

响应参数

参数名	类型	长度	描述
`data` data.data	Object	0	返回查询结果，如果没有匹配记录则返回为空。具体字段含义见下表
`total` data.data.total	Number	0	返回列表中记录总数
`items` data.data.items	Array	0	十大股东持股信息列表
`dnpsharer` data.data.items.dnpsharer	String	50	限售境内自然人持股（万股）
`bshare` data.data.items.bshare	String	50	已上市流通B股（万股）
`statesharer` data.data.items.statesharer	String	50	限售国家持股（万股）
`statelpsharer` data.data.items.statelpsharer	String	50	限售国家法人持股（万股）
`urshare` data.data.items.urshare	String	50	已流通股份（万股）
`changedate` data.data.items.changedate	String	50	变动日期
`noticedate` data.data.items.noticedate	String	50	公告日期
`ashare` data.data.items.ashare	String	50	已上市流通A股（万股）
`otherdsharer` data.data.items.otherdsharer	String	50	限售其他内资持股（万股）
`foreignlpsharer` data.data.items.foreignlpsharer	String	50	限售境外法人持股（万股）
`ncshare` data.data.items.ncshare	String	50	未流通股份（万股）
`foreigncapitalsharer` data.data.items.foreigncapitalsharer	String	50	限售外资持股（万股）
`othercirculatedshare` data.data.items.othercirculatedshare	String	50	其他已流通股份（万股）
`changereason` data.data.items.changereason	String	50	股本变动原因
`dnotstatelpsharer` data.data.items.dnotstatelpsharer	String	50	限售境内非国有法人持股（万股）
`rshare` data.data.items.rshare	String	50	流通受限股份（万股）
`totalshare` data.data.items.totalshare	String	50	总股本（万股）
`hshare` data.data.items.hshare	String	50	已上市流通H股（万股）
`foreignnpsharer` data.data.items.foreignnpsharer	String	50	限售境外法人持股（万股）
`sign` data.sign	String	32	数据签名
`status` data.status	String	10	返回结果状态
`message` data.message	String	255	返回结果消息

响应示例

JSON

{
    "status": "200",
    "message": "操作成功",
    "sign": "3d5a9739464fa91977dcd9a46b66ee8d",
    "data": {
        "items": [
            {
                "hshare": "--",
                "changereason": "转增股上市",
                "urshare": "12533.12",
                "changedate": "2022-06-08",
                "ashare": "12533.12",
                "ncshare": "--",
                "othercirculatedshare": "--",
                "noticedate": "2022-05-31",
                "foreigncapitalsharer": "--",
                "statelpsharer": "--",
                "foreignlpsharer": "--",
                "statesharer": "--",
                "bshare": "--",
                "foreignnpsharer": "--",
                "dnpsharer": "--",
                "rshare": "536.16",
                "totalshare": "13069.28",
                "dnotstatelpsharer": "--",
                "otherdsharer": "--"
            },
            {
                "hshare": "--",
                "changereason": "转增股上市",
                "urshare": "8952.23",
                "changedate": "2021-10-13",
                "ashare": "8952.23",
                "ncshare": "--",
                "othercirculatedshare": "--",
                "noticedate": "2021-09-28",
                "foreigncapitalsharer": "--",
                "statelpsharer": "--",
                "foreignlpsharer": "--",
                "statesharer": "--",
                "bshare": "--",
                "foreignnpsharer": "--",
                "dnpsharer": "--",
                "rshare": "382.97",
                "totalshare": "9335.20",
                "dnotstatelpsharer": "--",
                "otherdsharer": "--"
            },
            {
                "hshare": "--",
                "changereason": "高管股份变动",
                "urshare": "6394.45",
                "changedate": "2021-06-30",
                "ashare": "6394.45",
                "ncshare": "--",
                "othercirculatedshare": "--",
                "noticedate": "2021-08-31",
                "foreigncapitalsharer": "--",
                "statelpsharer": "--",
                "foreignlpsharer": "--",
                "statesharer": "--",
                "bshare": "--",
                "foreignnpsharer": "--",
                "dnpsharer": "--",
                "rshare": "273.55",
                "totalshare": "6668.00",
                "dnotstatelpsharer": "--",
                "otherdsharer": "--"
            },
            {
                "hshare": "--",
                "changereason": "首发限售股份上市",
                "urshare": "6668.00",
                "changedate": "2017-09-13",
                "ashare": "6668.00",
                "ncshare": "--",
                "othercirculatedshare": "--",
                "noticedate": "2017-09-11",
                "foreigncapitalsharer": "--",
                "statelpsharer": "--",
                "foreignlpsharer": "--",
                "statesharer": "--",
                "bshare": "--",
                "foreignnpsharer": "--",
                "dnpsharer": "--",
                "rshare": "--",
                "totalshare": "6668.00",
                "dnotstatelpsharer": "--",
                "otherdsharer": "--"
            },
            {
                "hshare": "--",
                "changereason": "首发限售股份上市",
                "urshare": "1768.00",
                "changedate": "2015-09-14",
                "ashare": "1768.00",
                "ncshare": "--",
                "othercirculatedshare": "--",
                "noticedate": "2015-09-09",
                "foreigncapitalsharer": "4900.00",
                "statelpsharer": "--",
                "foreignlpsharer": "4900.00",
                "statesharer": "--",
                "bshare": "--",
                "foreignnpsharer": "--",
                "dnpsharer": "--",
                "rshare": "4900.00",
                "totalshare": "6668.00",
                "dnotstatelpsharer": "--",
                "otherdsharer": "--"
            },
            {
                "hshare": "--",
                "changereason": "首发A股上市",
                "urshare": "1668.00",
                "changedate": "2014-08-28",
                "ashare": "1668.00",
                "ncshare": "--",
                "othercirculatedshare": "--",
                "noticedate": "2014-09-11",
                "foreigncapitalsharer": "4900.00",
                "statelpsharer": "--",
                "foreignlpsharer": "4900.00",
                "statesharer": "--",
                "bshare": "--",
                "foreignnpsharer": "--",
                "dnpsharer": "--",
                "rshare": "5000.00",
                "totalshare": "6668.00",
                "dnotstatelpsharer": "100.00",
                "otherdsharer": "100.00"
            },
            {
                "hshare": "--",
                "changereason": "上市前股本",
                "urshare": "--",
                "changedate": "2014-04-30",
                "ashare": "--",
                "ncshare": "--",
                "othercirculatedshare": "--",
                "noticedate": "2014-04-30",
                "foreigncapitalsharer": "4900.00",
                "statelpsharer": "--",
                "foreignlpsharer": "4900.00",
                "statesharer": "--",
                "bshare": "--",
                "foreignnpsharer": "--",
                "dnpsharer": "--",
                "rshare": "5000.00",
                "totalshare": "5000.00",
                "dnotstatelpsharer": "100.00",
                "otherdsharer": "100.00"
            }
        ],
        "total": 7
    }
}

代码示例

javascript

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

let baseUrl = 'https://api.qixin.com/APIService/qc/getStockChangeList';
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/getStockChangeList";
        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/getStockChangeList";
            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/getStockChangeList'
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.7-股本变动.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