Code Snippets
curl "https://financialdata.net/api/v1/institutional-holdings?identifier=COST&key=API_KEY"import requests
url = 'https://financialdata.net/api/v1/institutional-holdings?identifier=COST&key=API_KEY'
response = requests.get(url)
print(response.json())
const url = 'https://financialdata.net/api/v1/institutional-holdings?identifier=COST&key=API_KEY';
const response = await fetch(url);
const data = await response.json();
console.log(data);
Sample Response
[
{
"investor_name": "Alliance Wealth Advisors, LLC",
"central_index_key": "0001849724",
"period_of_report": "2026-09-30",
"issuer_name": "COSTCO WHOLESALE CORPORATION",
"trading_symbol": "COST",
"cusip_number": "22160K105",
"title_of_security": "COM",
"market_value": 284936.0,
"amount_of_securities": 313,
"price_per_security": 910.338658146965,
"shares_or_principal": "SH",
"put_or_call": "N/A",
"investment_discretion": "SOLE",
"portfolio_weight": 0.000900065653847049
},
...
]Query Parameters
| Name | Type | Description |
|---|---|---|
| identifier | string | The trading symbol or CUSIP number of a security, or the institutional investor's central index key. The latter is assigned to the investor by the US Securities and Exchange Commission. (e.g., MSFT, 594918104, 0001067983) |
| offset | integer | (Optional) The initial position of the record subset, which indicates how many records to skip. Defaults to 0. (e.g., 100) |
| format | string | (Optional) The format of the returned data, either JSON or CSV. Defaults to JSON. (e.g., json, csv) |
Endpoint Overview
Institutional holdings are the securities in an investment portfolio owned by investment or pension funds, insurance companies, investment firms, or other large organizations that manage funds on behalf of others. The API endpoint provides data on institutional investors with holdings of at least $100 million. There is a limit of 100 records per API call.
Company Profile
COSTCO WHOLESALE CORP /NEW
NASDAQ: COST- Market Cap:$451.60B
- ISIN:US22160K1051
- Fiscal Year End:08/30
- CEO:Ron Vachris
- Employees:341000
Costco Wholesale Corporation is an American multinational corporation that operates a chain of membership-only big-box warehouse club retail stores. As of 2025, Costco is the third-largest retailer in the world, and as of August 2024, the world's largest retailer of beef, poultry, organic produce, and wine, with just under a third of American consumers regularly shopping at Costco warehouses. As of 2026, Costco is ranked 12th on the Fortune 500 rankings of the largest United States corporations by total revenue.