Skip to main content
POST
/
v1
/
stock
/
company-shareholders
Company Shareholders
curl --request POST \
  --url https://api.reportify.cn/v1/stock/company-shareholders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "symbol": "<string>",
  "type": "<string>",
  "limit": 123
}
'
{
  "status": 123,
  "code": 123,
  "message": "<string>",
  "data": {}
}

​
公司股东

URL: /v1/stock/company-shareholders 方法: POST
描述: 获取公司股东信息列表。

​
请求参数

参数名类型必填描述
symbolstr是股票代码，如 HK:00700、US:AAPL。
typestr否类型：shareholders 或 outstanding_shareholders。
limitint否返回数量限制，默认 10。

​
响应参数

参数名类型描述
statusintHTTP 状态码。
codeint响应代码（0 表示成功）。
messagestr响应消息。
dataobject股东数据。
  itemsarray股东列表。
    namestr股东名称。
    holdingsint持股数量。
    percentnumber持股比例。
    datestr数据日期。

​
请求示例

cURL 
curl -X POST https://api.reportify.cn/v1/stock/company-shareholders \
-H "Authorization: Bearer 447460****09c9" \
-H "Content-Type: application/json" \
-d '{
    "symbol": "HK:00700",
    "limit": 5
}'
Python 
import requests

url = "https://api.reportify.cn/v1/stock/company-shareholders"
headers = {
    "Authorization": "Bearer 447460****09c9",
    "Content-Type": "application/json"
}
data = {
    "symbol": "HK:00700",
    "limit": 5
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

​
响应示例

{
  "status": 200,
  "code": 0,
  "message": "",
  "data": {
    "items": [
      {
        "date": "2020-06-12",
        "name": "马化腾",
        "holdings": 804859700,
        "percent": 0.0842
      },
      {
        "date": "2025-07-25",
        "name": "Naspers Limited",
        "holdings": 2105253100,
        "percent": 0.2299
      }
    ]
  }
}

​
错误响应

状态码描述
422请求参数验证失败。

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Input schema for company shareholders

​
symbol
string
required

Stock symbol

​
type
string

Choose 'shareholders' or 'outstanding_shareholders'

​
limit
integer

Limit return number, default 10

Response

Successful Response

Generic response wrapper from stock API

​
status
integer

HTTP status code

​
code
integer

Response code (0 for success)

​
message
string

Response message

​
data
Data · object

Response data (structure varies by endpoint)