Skip to main content
GET
/
stocks
/
{stockKey}
Get stock holders and history
curl --request GET \
  --url https://mkk.celebi.me/api/stocks/{stockKey}
{
  "stock": {
    "key": "<string>",
    "security": "<string>",
    "issuer": "<string>",
    "isin": "<string>",
    "sections": [
      "<string>"
    ],
    "entry_count": 123,
    "document_count": 123,
    "fund_count": 123,
    "latest_holder_count": 123,
    "latest_market_value": 123,
    "average_weight": 123,
    "max_weight": 123,
    "latest_period": "<string>"
  },
  "holders": [
    {
      "fund_code": "<string>",
      "fund_title": "<string>",
      "document_id": 123,
      "disclosure_index": "<string>",
      "file_name": "<string>",
      "period": "<string>",
      "report_date": "<string>",
      "pdf_url": "<string>",
      "kap_file_url": "<string>",
      "kap_url": "<string>",
      "section": "<string>",
      "security": "<string>",
      "issuer": "<string>",
      "isin": "<string>",
      "currency": "<string>",
      "entries_count": 123,
      "market_value": "<string>",
      "numeric_market_value": 123,
      "nominal_value": "<string>",
      "numeric_nominal_value": 123,
      "portfolio_weight": 123,
      "weight_source": "<string>"
    }
  ],
  "holder_limit": 123,
  "holder_total": 123,
  "history": [
    {
      "period": "<string>",
      "report_date": "<string>",
      "disclosure_index": "<string>",
      "fund_count": 123,
      "document_count": 123,
      "market_value": 123,
      "average_weight": 123,
      "max_weight": 123
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.mkk.celebi.me/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

stockKey
string
required

URL-safe stock key from the stocks list, usually the normalized ticker/security.

Query Parameters

limit
integer

Maximum number of rows to return.

Required range: 1 <= x <= 500

Response

Stock detail with latest fund holders and aggregate history.

stock
object
required
holders
object[]
required
holder_limit
integer
required
holder_total
integer
required
history
object[]
required