GET /api/v1/us/13f-holdings

Returns institutional 13F holdings reported to the SEC.

Request

GET /api/v1/us/13f-holdings

Headers

Header	Value
F-API-KEY	Your API key

Query Parameters

Parameter	Type	Required	Filter	Description
cik	string	No	exact	SEC CIK
ticker	string	No	exact	Stock ticker
filing_type	string	No	exact	Filing type
accession_number	string	No	exact	Accession number
cusip	string	No	exact	CUSIP
manager_name	string	No	like	Manager name (fuzzy match)
limit	integer	No	—	Max rows per page (default 100, max 1000)
offset	integer	No	—	Rows to skip (default 0)
sort	string	No	—	Sort field (default report_period)
order	asc | desc	No	—	Sort direction (default desc)

Example

curl -H "F-API-KEY: fk-xxxxx" \
  "https://finance-api.xp-java.workers.dev/api/v1/us/13f-holdings?ticker=AAPL&limit=10"

Response

{
  "code": 0,
  "message": "ok",
  "data": [
    {
      "cik": "0001067983",
      "ticker": "AAPL",
      "filing_type": "13F-HR",
      "filing_date": "2024-11-14",
      "accession_number": "0001067983-24-000456",
      "url": "https://www.sec.gov/Archives/edgar/data/1067983/000106798324000456/0001067983-24-000456-index.htm",
      "manager_name": "BERKSHIRE HATHAWAY INC",
      "report_period": "2024-09-30",
      "issuer": "APPLE INC",
      "class_title": "COM",
      "cusip": "037833100",
      "shares": 300000000,
      "value": 67500000000,
      "sole_voting": 300000000,
      "shared_voting": 0,
      "non_voting": 0,
      "holding_type": "SH",
      "put_call": null,
      "updated_at": "2024-11-14T00:00:00Z"
    }
  ],
  "meta": {
    "total": 10,
    "limit": 10,
    "offset": 0,
    "has_more": false
  }
}