股东持仓详情

股东持仓详情

curl --request GET \
  --url https://api.tickdb.ai/v1/fundamentals/shareholders/detail \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.tickdb.ai/v1/fundamentals/shareholders/detail', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tickdb.ai/v1/fundamentals/shareholders/detail",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tickdb.ai/v1/fundamentals/shareholders/detail"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tickdb.ai/v1/fundamentals/shareholders/detail")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "code": 0,
  "data": {
    "symbol": "<string>",
    "object_id": "<string>",
    "name": "<string>",
    "holding_summary": [
      {
        "accum_buy": "<string>",
        "accum_sell": "<string>",
        "percent_stock_price_changed": "<string>",
        "period": "<string>",
        "stock_price": "<string>"
      }
    ],
    "holding_periods": [
      "<string>"
    ],
    "holding_details": [
      {
        "filing_date": "<string>",
        "name": "<string>",
        "object_id": "<string>",
        "percent_shares_changed": "<string>",
        "percent_shares_held": "<string>",
        "period": "<string>",
        "shares_changed": "<string>",
        "shares_held": "<string>"
      }
    ],
    "trading_periods": [
      "<string>"
    ],
    "tradings": [
      {
        "accum_buy": "<string>",
        "accum_sell": "<string>",
        "net_buy": "<string>",
        "period": "<string>",
        "trading_details": [
          {}
        ]
      }
    ],
    "title": "<string>"
  }
}

GET

fundamentals

shareholders

detail

股东持仓详情

curl --request GET \
  --url https://api.tickdb.ai/v1/fundamentals/shareholders/detail \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.tickdb.ai/v1/fundamentals/shareholders/detail', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tickdb.ai/v1/fundamentals/shareholders/detail",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tickdb.ai/v1/fundamentals/shareholders/detail"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tickdb.ai/v1/fundamentals/shareholders/detail")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "code": 0,
  "data": {
    "symbol": "<string>",
    "object_id": "<string>",
    "name": "<string>",
    "holding_summary": [
      {
        "accum_buy": "<string>",
        "accum_sell": "<string>",
        "percent_stock_price_changed": "<string>",
        "period": "<string>",
        "stock_price": "<string>"
      }
    ],
    "holding_periods": [
      "<string>"
    ],
    "holding_details": [
      {
        "filing_date": "<string>",
        "name": "<string>",
        "object_id": "<string>",
        "percent_shares_changed": "<string>",
        "percent_shares_held": "<string>",
        "period": "<string>",
        "shares_changed": "<string>",
        "shares_held": "<string>"
      }
    ],
    "trading_periods": [
      "<string>"
    ],
    "tradings": [
      {
        "accum_buy": "<string>",
        "accum_sell": "<string>",
        "net_buy": "<string>",
        "period": "<string>",
        "trading_details": [
          {}
        ]
      }
    ],
    "title": "<string>"
  }
}

套餐权限

套餐	可用
免费版	❌
基础版	❌
专业版	✅
全量套餐（A 股、港股、美股）	✅
企业版	✅

注意事项

object_id 应取自股东持仓接口中 detail_available=true 的记录；否则可能返回 404。

支持的市场

市场	示例
美股	AAPL.US
港股	700.HK
A股	600519.SH

请求参数

参数	是否必须	说明
`symbol`	是	股票代码
`type`	否	产品类型，当前支持 `stock`
`object_id`	是	来自股东持仓接口且 `detail_available=true` 的对象 ID

请求示例

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.tickdb.ai/v1/fundamentals/shareholders/detail?symbol=AAPL&type=stock&object_id=452583"

返回字段说明

以下列出 data 中的字段；外层 code=0 表示成功。

字段	说明
symbol	股票代码。
object_id	股东对象 ID。
name	股东名称。
title	股东或机构标题。
holding_summary	分报告期的持仓汇总。
└─ accum_buy	该报告期累计买入数量。
└─ accum_sell	该报告期累计卖出数量。
└─ percent_stock_price_changed	该报告期股价变化比例，包含百分号。
└─ period	报告期。
└─ stock_price	该报告期对应股价。
holding_periods	可用持仓报告期列表。
holding_details	逐报告期持仓明细。
└─ filing_date	原始申报日期文本，例如 `2026/05/07`。
└─ name	股东名称。
└─ object_id	股东对象 ID。
└─ percent_shares_changed	持股比例变化，包含百分号。
└─ percent_shares_held	持股比例，包含百分号。
└─ period	报告期。
└─ shares_changed	股份变动数量。
└─ shares_held	持股数量。
trading_periods	可用交易统计期间。
tradings	分期间交易汇总。
└─ accum_buy	该期间累计买入数量。
└─ accum_sell	该期间累计卖出数量。
└─ net_buy	该期间净买入数量。
└─ period	交易统计期间。
└─ trading_details	该期间的交易明细列表。

返回股东持仓汇总、持仓期间、持仓明细、交易期间和交易汇总。没有可用详情时可能返回结构化 404。

授权

X-API-Key

string

header

必填

查询参数

symbol

string

必填

股票代码

示例:

"AAPL"

"700"

"600519"

"AAPL.US"

"700.HK"

"600519.SH"

type

enum<string>

产品类型，当前支持 stock

可用选项:

stock

object_id

string

必填

来自股东持仓接口且 detail_available=true 的对象 ID

响应

股东持仓详情响应。

code

integer

必填

业务状态码，成功为 0。

data

object

必填

Show child attributes

介绍

入门指南

REST API

WebSocket 文档

参考

套餐权限

注意事项

支持的市场

请求参数

请求示例

返回字段说明

授权

查询参数

响应

​套餐权限

​注意事项

​支持的市场

​请求参数

​请求示例

​返回字段说明

授权

查询参数

响应

套餐权限

注意事项

支持的市场

请求参数

请求示例

返回字段说明