股東持倉詳情

股東持倉詳情

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 文檔

參考

套餐權限

注意事項

支持的市場

請求參數

請求示例

返回字段說明

授權

查詢參數

回應

​套餐權限

​注意事項

​支持的市場

​請求參數

​請求示例

​返回字段說明

授權

查詢參數

回應

套餐權限

注意事項

支持的市場

請求參數

請求示例

返回字段說明