기관 투자자 보유 API 레퍼런스
기업을 보유한 기관과 각 기관의 보유 내역, Form 13F 기준
개요
Form 13F는 1억 달러 이상을 운용하는 기관 투자 운용사가 보유한 미국 주식과 옵션 포지션에 대한 분기 보고서입니다. 이 경로들은 어떤 기관이 기업을 보유하고 있는지, 한 기관이 무엇을 보유하고 있는지를 보고 분기 하나씩 보여줍니다. 모든 요청에 Bearer 키가 필요하며, REST와 MCP는 하나의 크레딧 잔액을 함께 사용합니다.
경로는 네 개입니다. 첫 번째는 기업을 보유한 기관을 나열합니다. 두 번째는 한 기관이 보유한 것을 나열합니다. 세 번째는 이름으로 기관을 찾습니다. 네 번째는 한 기관의 13F 공시를 각 표지의 수치와 함께 나열합니다. 기업은 공시 API의 ID로 지정하며, 예를 들면 usa:0000320193입니다. 기관은 자체 CIK로 지정하며, 그 investor_는 usa:에 10자리로 앞을 0으로 채운 CIK를 붙인 것입니다.
분기는 보고 분기 말이며, 예를 들면 2026-06-30입니다. 생략하면 최신 분기를 반환합니다. 각 행은 포지션 하나이며 분기와 출처 공시를 나타냅니다. 공시가 어떤 단위를 썼든 금액은 미국 달러입니다.
이력은 2021년 9월 30일에 끝나는 보고 분기부터 시작합니다. periods는 보유한 분기를 나열합니다. 그보다 앞서 나열된 분기는 일부만 읽은 것이므로 보유 기관 수는 부분적이며 보유 기관의 전체 목록이 아닙니다.
미국만 지원합니다. 다른 국가의 기업은 404 not_입니다.
기본 URL: https:/. 아래 각 경로는 같은 매개변수를 가진 별도의 MCP 도구입니다.
5%를 넘는 보유자는 다음 페이지에 있습니다: 대량 보유자 페이지, 내부자는 다음 페이지에 있습니다: 내부자 거래 페이지.
기업 ID는 공시 API 기업 검색이 반환하는 값입니다.
모든 계정에 제공되는 것
| 항목 | 모든 계정 |
|---|---|
| 기업의 기관 보유자 | 포함 |
| 기관의 보유 내역 | 포함 |
| 이름 검색과 공시 목록 | 포함 |
확인 요금 페이지에서 호출당 비용을 확인할 수 있습니다. 라우트에 별도 안내가 없으면 요청은 해당 API의 가격으로 청구됩니다.
- Companies 가격으로 청구되며 호출 1,000회당 $10입니다. 성공한 응답은 행 수와 관계없이 호출 1회입니다. 빈 페이지, 결과가 없는 검색, 오류는 무료입니다. 행과
next_가 있는 페이지는 청구되며, 다음 페이지가 비어 있으면 무료입니다.cursor - 숫자는 십진 문자열입니다. 값이 없는 필드는 생략하고, 목록은 항상 있으며,
new_같은 플래그는 true일 때만 보냅니다.position - 페이지는
next_로 끝날 수 있습니다. 다른 매개변수는 그대로 두고 이를cursor cursor로 다시 보내세요. 다른 요청의 cursor는 400invalid_입니다.cursor period가 없으면 institutions 경로는 최신 분기를 반환하며, 최신 보고서가 더 이전 분기에 있는 기관도 그 분기를period에 넣어 함께 나열합니다. 한 분기만 읽으려면period를 보내세요.reported_는 공시에 적힌price value를shares로 나눈 값입니다. 공시가 금액을 달러로 기재하기 시작한 2023년 1월 3일 이후의 공시에서 보내며, 원금과 주식 수가 없는 포지션에서는 생략합니다. 그 이전 공시는 금액을 천 단위로 기재했으며, Narwhal은 이를 달러로 보냅니다.shares_은 주식이면type SH, 원금이면PRN입니다.put_은 옵션 포지션에 보냅니다.call other_는 그 포지션을 공유하는, 포함된 다른 운용사의 번호입니다. 이름은 filings 경로의managers other_에 있습니다.included_ managers shares_와change new_은 기관의 직전 분기와 비교한 값이며 holdings 경로가 보냅니다.position table_은 제출자가 표지에 신고한 수입니다. 공시 100건 중 약 2건에서 틀리므로 정확한 수가 필요하면 행을 세세요.entry_ total
엔드포인트
모든 경로는 GET이며, 키를 다음 헤더에 담아 보내야 합니다: Authorization: Bearer 헤더입니다. 예시는 응답의 형태를 보여 줄 뿐이며 실시간 데이터가 아닙니다.
기업을 보유한 기관 목록 조회
GET /v1/companies/{company_id}/institutions
Form 13F에서 기업의 포지션을 보고한 기관을 금액이 큰 순으로 나열합니다. 각 행은 한 기관의 한 포지션이며 보고 분기 하나에 해당합니다.
행은 금액이 큰 순입니다. 모든 기관을 읽으려면 next_로 페이지를 넘기세요.
MCP: 도구 filings_.
매개변수
| 매개변수 | 위치 | 필수 | 유형 | 의미 |
|---|---|---|---|---|
company_ | 경로 | 예 | 문자열 | 기업 ID입니다. 예: usa:0000320193. usa:AAPL 같은 티커 별칭도 사용할 수 있습니다. |
period | 쿼리 | 아니요 | 날짜 | 보고 분기 말입니다. 예: 2026-06-30. 생략하면 최신 분기입니다. 데이터가 없는 분기는 404 period_입니다. |
cursor | 쿼리 | 아니요 | 문자열 | 이전 페이지의 next_. 다른 매개변수는 동일하게 유지합니다. |
limit | 쿼리 | 아니요 | 정수 | 페이지당 행 수입니다. 기본값 100, 최대 500입니다. |
응답 필드
| 필드 | 유형 | 전송 | 의미 |
|---|---|---|---|
id | 문자열 | 항상 | 기업 ID입니다. |
period | 날짜 | 선택 | 반환된 보고 분기 말입니다. holdings 경로에 분기 범위를 지정하면 생략합니다. |
periods | list of date | 항상 | 보유한 보고 분기 말이며 최신순입니다. |
built_ | 문자열 | 선택 | 응답의 바탕이 된 파일이 만들어진 시각입니다(UTC). |
holders | 객체 목록 | 항상 | 기업을 보유한 기관이며 금액이 큰 순입니다. |
holders[].investor_ | 문자열 | 항상 | 기관의 ID이며 usa:에 10자리로 앞을 0으로 채운 CIK를 붙인 것입니다. |
holders[].investor | 문자열 | 선택 | 기관의 이름이며 제출한 그대로입니다. |
holders[].filing_ | 문자열 | 항상 | 이 행의 출처가 된 13F 공시의 ID입니다. |
holders[].form | 문자열 | 항상 | 공시의 양식입니다. 예: 13F-HR. |
holders[].report | always "combination" | 선택 | 공시가 복합 보고서일 때는 combination입니다. 다른 운용사의 포지션을 포함합니다. |
holders[].amendment | one of restatement, new_holdings, unstated | 선택 | 정정 공시가 원래 공시에 하는 일: restatement, new_, unstated. |
holders[].filed | 날짜 | 항상 | 공시가 제출된 날입니다. |
holders[].issuer | 문자열 | 항상 | 발행사의 이름이며 공시에 인쇄된 그대로입니다. |
holders[].class | 문자열 | 선택 | 증권 종류의 명칭입니다. 예: COM. |
holders[].value | 문자열 | 항상 | 포지션의 가치이며 미국 달러입니다. |
holders[].shares | 문자열 | 항상 | 주식 수입니다. shares_이 PRN이면 원금입니다. |
holders[].shares_ | one of SH, PRN | 선택 | 주식은 SH, 원금은 PRN입니다. |
holders[].put_ | one of Put, Call | 선택 | 옵션 포지션에서는 Put 또는 Call입니다. 다른 포지션에서는 생략합니다. |
holders[].discretion | 문자열 | 선택 | 공시에 기재된 투자 재량: SOLE, DFND(공동, 정의됨), OTR(공동, 기타). |
holders[].voting | 객체 | 항상 | 의결권이며 주식 수 기준입니다. |
holders[].voting.sole | 문자열 | 항상 | 단독 의결권이 있는 주식 수입니다. |
holders[].voting.shared | 문자열 | 항상 | 공동 의결권이 있는 주식 수입니다. |
holders[].voting.none | 문자열 | 항상 | 의결권이 없는 주식 수입니다. |
holders[].period | 날짜 | 항상 | 이 포지션의 보고 분기 말입니다. |
holders[].percent_ | 문자열 | 선택 | 포지션의 가치가 공시의 table_에서 차지하는 비율(퍼센트)입니다. |
holders[].reported_ | 문자열 | 선택 | value와 shares로 계산한 주당 가격입니다. 위의 제한 사항을 참고하세요. |
holders[].other_ | list of string | 항상 | 그 포지션을 공유하는, 포함된 다른 운용사의 번호입니다. |
holders[].percent_ | 문자열 | 선택 | 포지션이 기업의 발행 주식 수에서 차지하는 비율(퍼센트)입니다. 일반 주식 포지션만 해당합니다. |
holders[].outstanding_ | 날짜 | 선택 | percent_의 바탕이 된 주식 수의 날짜입니다. |
holders[].confidential_ | 항상 true | 선택 | 제출자가 SEC에 기밀 처리를 요청한 포지션을 뺀 경우 true입니다. |
next_ | 문자열 | 항상 | 다음 페이지를 읽으려면 cursor로 전달합니다. 항상 제공하며 마지막 페이지에서는 null입니다. |
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/companies/usa:0000320193/institutions?period=2026-09-30&limit=2"{
"id": "usa:0000320193",
"period": "2026-09-30",
"periods": [
"2026-09-30",
"2026-06-30",
"2026-03-31",
"2025-12-31"
],
"built_at": "2026-11-16T03:09:01Z",
"holders": [
{
"investor_id": "usa:0002012383",
"investor": "BlackRock, Inc.",
"filing_id": "usa:0002012383:0002012383-26-003985",
"form": "13F-HR",
"report": "combination",
"filed": "2026-11-13",
"issuer": "APPLE INC",
"class": "COM",
"value": "385329896040",
"shares": "1157077341",
"shares_type": "SH",
"discretion": "SOLE",
"voting": {
"sole": "1037578760",
"shared": "0",
"none": "119498580"
},
"period": "2026-09-30",
"percent_of_portfolio": "5.6736",
"reported_price": "333.02",
"other_managers": [
"2",
"3",
"4"
]
},
{
"investor_id": "usa:0002100119",
"investor": "VANGUARD CAPITAL MANAGEMENT LLC",
"filing_id": "usa:0002100119:0002100119-26-001711",
"form": "13F-HR",
"filed": "2026-11-13",
"issuer": "APPLE INC",
"class": "COM",
"value": "318109956628",
"shares": "955227784",
"shares_type": "SH",
"discretion": "DFND",
"voting": {
"sole": "0",
"shared": "0",
"none": "955227784"
},
"period": "2026-09-30",
"percent_of_portfolio": "6.6794",
"reported_price": "333.02",
"other_managers": []
}
],
"next_cursor": "eyJrIjoidUdkUmJZRS1vV0Mw…"
}기관의 보유 내역 조회
GET /v1/investors/{cik}/holdings
한 기관이 Form 13F에서 보고한 내용을 금액이 큰 순으로 나열합니다. 분기 하나 또는 분기 범위를 지정할 수 있습니다. cik는 기관 자체의 CIK입니다.
report_, report_, report_, report_로 한 번의 호출에서 여러 분기를 읽습니다. 최신 분기가 먼저이고 분기 안에서는 금액이 큰 순입니다. 이때 period는 보내지 않습니다. period와 범위를 함께 요청하면 400 invalid_입니다.
MCP: 도구 filings_.
매개변수
| 매개변수 | 위치 | 필수 | 유형 | 의미 |
|---|---|---|---|---|
cik | 경로 | 예 | 문자열 | 기관의 CIK이며 1자리에서 10자리입니다. 또는 기관의 investor_(usa:와 1자리에서 10자리 숫자)입니다. 앞의 0은 생략해도 됩니다. |
period | 쿼리 | 아니요 | 날짜 | 보고 분기 말 하나입니다. 생략하면 최신 분기입니다. 범위 매개변수와 함께 쓸 수 없습니다. |
report_ | 쿼리 | 아니요 | 날짜 | 이 날짜 당일 또는 그 이후에 끝나는 분기만입니다(YYYY-MM-DD). |
report_ | 쿼리 | 아니요 | 날짜 | 이 날짜 이후(당일 제외)에 끝나는 분기만입니다. |
report_ | 쿼리 | 아니요 | 날짜 | 이 날짜 당일 또는 그 이전에 끝나는 분기만입니다. |
report_ | 쿼리 | 아니요 | 날짜 | 이 날짜 이전(당일 제외)에 끝나는 분기만입니다. |
cursor | 쿼리 | 아니요 | 문자열 | 이전 페이지의 next_. 다른 매개변수는 동일하게 유지합니다. |
limit | 쿼리 | 아니요 | 정수 | 페이지당 행 수입니다. 기본값 100, 최대 500입니다. |
응답 필드
| 필드 | 유형 | 전송 | 의미 |
|---|---|---|---|
id | 문자열 | 항상 | 기관의 ID이며 usa:에 10자리로 앞을 0으로 채운 CIK를 붙인 것입니다. |
investor | 문자열 | 선택 | 기관의 이름이며 제출한 그대로입니다. |
period | 날짜 | 선택 | 반환된 보고 분기 말입니다. holdings 경로에 분기 범위를 지정하면 생략합니다. |
periods | list of date | 항상 | 보유한 보고 분기 말이며 최신순입니다. |
built_ | 문자열 | 선택 | 응답의 바탕이 된 파일이 만들어진 시각입니다(UTC). |
holdings | 객체 목록 | 항상 | 포지션이며 금액이 큰 순입니다. 분기 범위를 지정하면 최신 분기가 먼저입니다. |
holdings[].company_ | 문자열 | 선택 | 당사 기업 목록에서의 발행사 ID입니다. 발행사가 기업과 연결되지 않았으면 생략합니다. |
holdings[].company | 문자열 | 선택 | 당사 기업 목록에서의 발행사 이름입니다. |
holdings[].ticker | 문자열 | 선택 | 당사 기업 목록에서의 발행사 티커입니다. |
holdings[].filing_ | 문자열 | 항상 | 이 행의 출처가 된 13F 공시의 ID입니다. |
holdings[].form | 문자열 | 항상 | 공시의 양식입니다. 예: 13F-HR. |
holdings[].report | always "combination" | 선택 | 공시가 복합 보고서일 때는 combination입니다. 다른 운용사의 포지션을 포함합니다. |
holdings[].amendment | one of restatement, new_holdings, unstated | 선택 | 정정 공시가 원래 공시에 하는 일: restatement, new_, unstated. |
holdings[].filed | 날짜 | 항상 | 공시가 제출된 날입니다. |
holdings[].issuer | 문자열 | 항상 | 발행사의 이름이며 공시에 인쇄된 그대로입니다. |
holdings[].class | 문자열 | 선택 | 증권 종류의 명칭입니다. 예: COM. |
holdings[].value | 문자열 | 항상 | 포지션의 가치이며 미국 달러입니다. |
holdings[].shares | 문자열 | 항상 | 주식 수입니다. shares_이 PRN이면 원금입니다. |
holdings[].shares_ | one of SH, PRN | 선택 | 주식은 SH, 원금은 PRN입니다. |
holdings[].put_ | one of Put, Call | 선택 | 옵션 포지션에서는 Put 또는 Call입니다. 다른 포지션에서는 생략합니다. |
holdings[].discretion | 문자열 | 선택 | 공시에 기재된 투자 재량: SOLE, DFND(공동, 정의됨), OTR(공동, 기타). |
holdings[].voting | 객체 | 항상 | 의결권이며 주식 수 기준입니다. |
holdings[].voting.sole | 문자열 | 항상 | 단독 의결권이 있는 주식 수입니다. |
holdings[].voting.shared | 문자열 | 항상 | 공동 의결권이 있는 주식 수입니다. |
holdings[].voting.none | 문자열 | 항상 | 의결권이 없는 주식 수입니다. |
holdings[].period | 날짜 | 항상 | 이 포지션의 보고 분기 말입니다. |
holdings[].percent_ | 문자열 | 선택 | 포지션의 가치가 공시의 table_에서 차지하는 비율(퍼센트)입니다. |
holdings[].reported_ | 문자열 | 선택 | value와 shares로 계산한 주당 가격입니다. 위의 제한 사항을 참고하세요. |
holdings[].other_ | list of string | 항상 | 그 포지션을 공유하는, 포함된 다른 운용사의 번호입니다. |
holdings[].shares_ | 문자열 | 선택 | 기관의 직전 분기 이후 shares의 변화입니다. 매도했으면 음수입니다. |
holdings[].new_ | 항상 true | 선택 | 기관이 직전 분기에 해당 종목을 전혀 보유하지 않았으면 true입니다. |
holdings[].confidential_ | 항상 true | 선택 | 제출자가 SEC에 기밀 처리를 요청한 포지션을 뺀 경우 true입니다. |
next_ | 문자열 | 항상 | 다음 페이지를 읽으려면 cursor로 전달합니다. 항상 제공하며 마지막 페이지에서는 null입니다. |
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/investors/1067983/holdings?limit=2"{
"id": "usa:0001067983",
"investor": "Berkshire Hathaway Inc",
"period": "2026-06-30",
"periods": [
"2026-06-30",
"2026-03-31",
"2025-12-31",
"2025-09-30"
],
"built_at": "2026-11-14T14:10:32Z",
"holdings": [
{
"company_id": "usa:0000320193",
"company": "Apple Inc.",
"ticker": "AAPL",
"filing_id": "usa:0001067983:0001193125-26-352200",
"form": "13F-HR",
"filed": "2026-08-14",
"issuer": "APPLE INC",
"class": "COM",
"value": "65950296923",
"shares": "227917808",
"shares_type": "SH",
"discretion": "DFND",
"voting": {
"sole": "227917808",
"shared": "0",
"none": "0"
},
"period": "2026-06-30",
"percent_of_portfolio": "22.0383",
"reported_price": "289.36",
"other_managers": [
"1",
"2",
"4"
],
"shares_change": "0"
},
{
"company_id": "usa:0000004962",
"company": "AMERICAN EXPRESS CO",
"ticker": "AXP",
"filing_id": "usa:0001067983:0001193125-26-352200",
"form": "13F-HR",
"filed": "2026-08-14",
"issuer": "AMERICAN EXPRESS CO",
"class": "COM",
"value": "51282319275",
"shares": "151610700",
"shares_type": "SH",
"discretion": "DFND",
"voting": {
"sole": "151610700",
"shared": "0",
"none": "0"
},
"period": "2026-06-30",
"percent_of_portfolio": "17.1367",
"reported_price": "338.25",
"other_managers": [
"4",
"11",
"13"
],
"shares_change": "0"
}
],
"next_cursor": "eyJrIjoiT3BDSFhISGJ0Y25T…"
}이름으로 기관 검색
GET /v1/investors
이름의 일부로 Form 13F를 제출하는 기관을 찾습니다. investor_를 반환하며, 이는 다른 경로의 cik로 그대로 쓸 수 있습니다.
investor_ 또는 그 숫자 부분만을 다른 경로의 cik로 전달합니다.
MCP: 도구 filings_.
매개변수
| 매개변수 | 위치 | 필수 | 유형 | 의미 |
|---|---|---|---|---|
name | 쿼리 | 예 | 문자열 | 기관 이름의 일부이며 대소문자는 구분하지 않고 2자에서 100자입니다. |
cursor | 쿼리 | 아니요 | 문자열 | 이전 페이지의 next_. 다른 매개변수는 동일하게 유지합니다. |
limit | 쿼리 | 아니요 | 정수 | 페이지당 행 수입니다. 기본값 100, 최대 500입니다. |
응답 필드
| 필드 | 유형 | 전송 | 의미 |
|---|---|---|---|
investors | 객체 목록 | 항상 | 이름에 해당 텍스트가 들어 있는 기관입니다. |
investors[].investor_ | 문자열 | 항상 | 기관의 ID이며 usa:에 10자리로 앞을 0으로 채운 CIK를 붙인 것입니다. |
investors[].name | 문자열 | 항상 | 기관의 이름이며 제출한 그대로입니다. |
investors[].latest_ | 날짜 | 항상 | 기관의 최신 공시의 보고 분기 말입니다. |
next_ | 문자열 | 항상 | 다음 페이지를 읽으려면 cursor로 전달합니다. 항상 제공하며 마지막 페이지에서는 null입니다. |
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/investors?name=berkshire&limit=2"{
"investors": [
{
"investor_id": "usa:0000949012",
"name": "BERKSHIRE ASSET MANAGEMENT LLC/PA",
"latest_period": "2026-09-30"
},
{
"investor_id": "usa:0001133742",
"name": "BERKSHIRE CAPITAL HOLDINGS INC",
"latest_period": "2026-09-30"
}
],
"next_cursor": "eyJrIjoiajJwemRIcXJfZnNn…"
}기관의 13F 공시 목록 조회
GET /v1/investors/{cik}/filings
기관이 낸 각 13F 공시의 표지를 보고 분기가 최신인 순으로 나열합니다. 양식, 보고서 유형, 제출일, 항목 수, 금액 합계, 포함된 다른 운용사입니다.
form으로 한 양식만 남기고(예: 13F-HR), 범위 매개변수로 일부 분기만 남깁니다.
MCP: 도구 filings_.
매개변수
| 매개변수 | 위치 | 필수 | 유형 | 의미 |
|---|---|---|---|---|
cik | 경로 | 예 | 문자열 | 기관의 CIK이며 1자리에서 10자리입니다. 또는 기관의 investor_(usa:와 1자리에서 10자리 숫자)입니다. 앞의 0은 생략해도 됩니다. |
report_ | 쿼리 | 아니요 | 날짜 | 이 날짜 당일 또는 그 이후에 끝나는 분기만입니다(YYYY-MM-DD). |
report_ | 쿼리 | 아니요 | 날짜 | 이 날짜 이후(당일 제외)에 끝나는 분기만입니다. |
report_ | 쿼리 | 아니요 | 날짜 | 이 날짜 당일 또는 그 이전에 끝나는 분기만입니다. |
report_ | 쿼리 | 아니요 | 날짜 | 이 날짜 이전(당일 제외)에 끝나는 분기만입니다. |
form | 쿼리 | 아니요 | 문자열 | 이 양식의 공시만: 13F-HR, 13F-HR/, 13F-NT, 13F-NT/, 13F-CTR. |
cursor | 쿼리 | 아니요 | 문자열 | 이전 페이지의 next_. 다른 매개변수는 동일하게 유지합니다. |
limit | 쿼리 | 아니요 | 정수 | 페이지당 행 수입니다. 기본값 100, 최대 500입니다. |
응답 필드
| 필드 | 유형 | 전송 | 의미 |
|---|---|---|---|
id | 문자열 | 항상 | 기관의 ID이며 usa:에 10자리로 앞을 0으로 채운 CIK를 붙인 것입니다. |
investor | 문자열 | 선택 | 기관의 이름이며 제출한 그대로입니다. |
filings | 객체 목록 | 항상 | 13F 공시이며 보고 분기가 최신인 순입니다. |
filings[].filing_ | 문자열 | 항상 | 이 행의 출처가 된 13F 공시의 ID입니다. |
filings[].form | 문자열 | 항상 | 공시의 양식입니다. 예: 13F-HR. |
filings[].period | 날짜 | 항상 | 공시가 다루는 보고 분기 말입니다. |
filings[].filed | 날짜 | 항상 | 공시가 제출된 날입니다. |
filings[].report_ | 문자열 | 선택 | 표지에 인쇄된 보고서 유형입니다. 예: 13F HOLDINGS REPORT. |
filings[].amendment | one of restatement, new_holdings, unstated | 선택 | 정정 공시가 원래 공시에 하는 일: restatement, new_, unstated. |
filings[].amendment_ | 문자열 | 선택 | 표지에 인쇄된 정정 번호입니다. |
filings[].file_ | 문자열 | 선택 | 표지에 인쇄된 SEC 파일 번호입니다. |
filings[].crd | 문자열 | 선택 | 표지에 인쇄된 CRD 번호입니다. |
filings[].table_ | 정수 | 선택 | 제출자가 표에 신고한 항목 수입니다. |
filings[].table_ | 문자열 | 선택 | 제출자가 표에 신고한 총 금액이며 미국 달러입니다. |
filings[].other_ | 정수 | 선택 | 제출자가 신고한, 포함된 다른 운용사의 수입니다. |
filings[].other_ | 객체 목록 | 항상 | 공시가 포지션을 포함하는 다른 운용사입니다. |
filings[].other_ | 정수 | 항상 | 운용사의 번호입니다. 포지션의 other_가 이를 가리킵니다. |
filings[].other_ | 문자열 | 선택 | 운용사의 ID이며, 자체 13F를 제출하는 경우에 있습니다. |
filings[].other_ | 문자열 | 선택 | 운용사의 이름입니다. |
filings[].other_ | 문자열 | 선택 | 운용사의 SEC 파일 번호입니다. |
filings[].other_ | 문자열 | 선택 | 운용사의 CRD 번호입니다. |
filings[].confidential_ | 항상 true | 선택 | 제출자가 SEC에 기밀 처리를 요청한 포지션을 뺀 경우 true입니다. |
filings[].notice | 항상 true | 선택 | 자체 포지션을 나열하지 않는 통지 보고서이면 true입니다. |
next_ | 문자열 | 항상 | 다음 페이지를 읽으려면 cursor로 전달합니다. 항상 제공하며 마지막 페이지에서는 null입니다. |
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/investors/1067983/filings?limit=1"{
"id": "usa:0001067983",
"investor": "Berkshire Hathaway Inc",
"filings": [
{
"filing_id": "usa:0001067983:0001193125-26-352200",
"form": "13F-HR",
"period": "2026-06-30",
"filed": "2026-08-14",
"report_type": "13F HOLDINGS REPORT",
"file_number": "028-04545",
"table_entry_total": 89,
"table_value_total": "299253556246",
"other_included_managers_count": 14,
"other_included_managers": [
{
"sequence": 1,
"name": "Berkshire Hathaway Homestate Insurance Co.",
"file_number": "28-2226"
},
{
"sequence": 2,
"name": "Berkshire Hathaway Life Insurance Co of Nebraska",
"file_number": "28-5678"
}
]
}
],
"next_cursor": "eyJrIjoiYzZtVkdUQVZ1TFJB…"
}오류
오류는 공통 문제 형식을 사용하며, 다음 필드를 포함합니다: request_. 확인 API 오류 코드와 크레딧 형식과 크레딧 헤더에 대한 설명이 있습니다. 실패한 요청에는 요금이 부과되지 않습니다.
| 코드 | 상태 | 의미 |
|---|---|---|
invalid_ | 400 | 매개변수가 없거나, 알 수 없거나, 중복되었거나, 범위를 벗어났습니다. |
invalid_ | 400 | 이 요청이 반환한 커서가 아니거나, 다른 요청의 커서입니다. |
company_ | 404 | ID와 일치하는 기업이 없습니다. |
investor_ | 404 | CIK와 일치하는 13F 제출자가 없습니다. |
period_ | 404 | 요청한 분기의 13F 데이터를 보유하고 있지 않습니다. |
not_ | 404 | 해당 시장, 국가 또는 기업은 아직 제공되지 않습니다. |
insufficient_ | 402 | 크레딧 잔액이 요청 비용보다 적습니다. |
company_ | 503 | 이 경로의 근거 공시를 지금은 읽을 수 없습니다. 잠시 후 다시 시도하세요. |
이 페이지가 도움이 되었나요?