펀드 보유 종목 API 레퍼런스
ETF나 펀드의 보유 내역과 기업을 보유한 펀드, Form N-PORT 기준
개요
Form N-PORT는 미국 등록 펀드(ETF 또는 뮤추얼 펀드)가 보유 내역에 대해 SEC에 제출하는 보고서입니다. 이 경로들은 한 펀드가 보유한 모든 것과 기업을 보유한 펀드를 보고서 하나씩 보여줍니다. 모든 요청에 Bearer 키가 필요하며, REST와 MCP는 하나의 크레딧 잔액을 함께 사용합니다.
경로는 두 개입니다. 첫 번째는 한 펀드의 보유 종목을 금액이 큰 순으로 나열하며, 펀드 합계와 자산군별 구성을 함께 보여줍니다. 두 번째는 기업의 포지션을 보고한 펀드를 나열합니다. 펀드는 시리즈 ID(예: S000002839), VOO나 VFIAX 같은 티커, 또는 ARCX:VOO 같은 종목 ID로 지정합니다. 기업은 공시 API의 ID로 지정하며, 예를 들면 usa:0000320193입니다.
보고서는 분기별입니다. 분기는 달력상의 분기 말이며, 예를 들면 2026-06-30입니다. 보고서는 as_ 날짜가 속한 분기에 놓입니다. 생략하면 최신 보고서를 반환합니다. value_나 currency가 다른 통화를 나타내지 않는 한 금액은 미국 달러입니다.
각 보유 종목에는 as_가 있으며, 이는 펀드 보고서의 날짜입니다. 공시의 filed 날짜보다 몇 주 앞서므로, 보유 종목은 오늘의 포트폴리오가 아닙니다.
미국만 지원합니다. 다른 국가의 기업이나 펀드는 404 not_입니다.
기본 URL: https:/. 아래 각 경로는 같은 매개변수를 가진 별도의 MCP 도구입니다.
기업을 보유한 기관은 다음 페이지에 있습니다: 기관 투자자 보유 페이지. 펀드 가격과 이력은 다음 페이지에 있습니다: 펀드 페이지.
기업 ID는 공시 API 기업 검색이 반환하는 값입니다.
모든 계정에 제공되는 것
| 항목 | 모든 계정 |
|---|---|
| 펀드의 보유 종목 | 포함 |
| 기업을 보유한 펀드 | 포함 |
확인 요금 페이지에서 호출당 비용을 확인할 수 있습니다. 라우트에 별도 안내가 없으면 요청은 해당 API의 가격으로 청구됩니다.
- Companies 가격으로 청구되며 호출 1회당 $0.01(1,000회당 $10)입니다. 성공한 응답은 행 수와 관계없이 호출 1회입니다. 오류는 무료이며, 기업을 보유한 펀드가 없는 경우처럼 데이터가 없는 응답도 무료입니다.
asset_로 남는 보유 종목이 없어도 펀드 페이지는 청구됩니다. 모든 펀드 페이지에 펀드 합계와 구성이 들어 있기 때문입니다.class - 머니마켓펀드는 지원하지 않습니다.
- 식별자가 없는 보유 종목이 있습니다. 보유 종목에
lei,isin,company_가 없을 수 있습니다. 대부분 채권(지방채, 자산유동화증권, 대출)과 파생상품입니다. 이런 보유 종목은 펀드가 보고한 이름으로id issuer와title에 담아 제공합니다. periods는 펀드에 대해 보유한 분기를 나열합니다.- 시리즈 ID가 없는 펀드(일부 트러스트 등)는 등록자 번호(10자리, 예:
0000884394)로 요청합니다. 아직 티커로는 찾을 수 없습니다. - 숫자는 십진 문자열입니다. 값이 없는 필드는 생략하고, 목록은 항상 있으며,
amendment같은 플래그는 true일 때만 보냅니다. - 페이지는
next_로 끝날 수 있습니다. 다른 매개변수는 그대로 두고 이를cursor cursor로 다시 보내세요. 다른 요청의 cursor는 400invalid_입니다.cursor period가 없으면 holdings 경로는 펀드의 최신 보고서를 반환합니다. company 경로는 각 펀드의 최신 보고서를 반환하므로 행이 서로 다른 분기에서 나올 수 있으며, 각 행의as_가 어느 시점인지 알려 줍니다. 한 분기만 읽으려면of period를 보내세요.fund와composition은asset_와class limit로 무엇이 남든 모든 페이지에서 보고서 전체를 나타냅니다.total_는 보고서 전체의 수이고holdings returned는 이 페이지의 행 수입니다. 통째로 제공하기엔 너무 큰 보고서는truncated가 설정되며 가장 큰 보유 종목만 남습니다.- company 경로는 주식 포지션만 나열합니다.
balance와percent_는 펀드가 보고한 그대로입니다.of_ net_ assets balance_은unit balance가 주식 수인지, 원금인지, 금액인지를 알려 줍니다.- 응답 예시는 실제 응답이며, 목록을 줄이고 커서를 잘랐습니다.
엔드포인트
모든 경로는 GET이며, 키를 다음 헤더에 담아 보내야 합니다: Authorization: Bearer 헤더입니다. 예시는 응답의 형태를 보여 줄 뿐이며 실시간 데이터가 아닙니다.
ETF나 펀드의 보유 내역 목록 조회
GET /v1/funds/{fund_id}/holdings
한 ETF 또는 펀드가 Form N-PORT로 보고한 모든 보유 종목을 금액이 큰 순으로 반환하며, 펀드 합계와 자산군별 구성을 함께 담습니다. fund_는 시리즈 ID, 티커 또는 종목 ID입니다. 보고서는 한 번에 하나입니다.
행은 금액이 큰 순입니다. 모든 보유 종목을 읽으려면 next_로 페이지를 넘기세요. fund, composition, 행 위쪽의 수치는 모든 페이지에서 같습니다.
as_는 날짜로 보고서를 고릅니다. 그 분기의 펀드 보고서가 그 날짜 기준일 때만 반환하며, 아니면 404 period_입니다.
MCP: 도구 filings_.
매개변수
| 매개변수 | 위치 | 필수 | 유형 | 의미 |
|---|---|---|---|---|
fund_ | 경로 | 예 | 문자열 | 펀드입니다. S000002839 같은 시리즈 ID, VOO나 VFIAX 같은 티커, ARCX:VOO 같은 종목 ID, 또는 시리즈 ID가 없는 펀드의 경우 등록자의 10자리 번호입니다. 시리즈 ID나 등록자 번호 앞에 usa:를 붙여도 됩니다. |
period | 쿼리 | 아니요 | 날짜 | 달력상의 분기 말입니다. 예: 2026-06-30. 보고서는 as_ 날짜가 속한 분기에 놓입니다. 생략하면 펀드의 최신 보고서입니다. 펀드에 보고서가 없는 분기는 404 period_입니다. |
as_ | 쿼리 | 아니요 | 날짜 | 보고서의 보유 종목 기준일입니다. 예: 2026-06-30. period가 없으면 분기를 고르는 데도 쓰입니다. 그 분기의 펀드 보고서가 그 날짜 기준일 때만 반환하며, 아니면 404 period_입니다. |
asset_ | 쿼리 | 아니요 | one of equity, debt, cash, derivative, other | 보유 종목의 한 종류만 남깁니다: equity, debt, cash, derivative, other. 펀드 합계와 구성은 여전히 보고서 전체를 나타냅니다. |
cursor | 쿼리 | 아니요 | 문자열 | 이전 페이지의 next_. 다른 매개변수는 동일하게 유지합니다. |
limit | 쿼리 | 아니요 | 정수 | 페이지당 행 수입니다. 기본값 100, 최대 500입니다. |
응답 필드
| 필드 | 유형 | 전송 | 의미 |
|---|---|---|---|
id | 문자열 | 항상 | 펀드의 ID이며 usa:에 시리즈 ID를 붙인 것입니다. 시리즈 ID가 없으면 usa:에 등록자 번호를 붙인 것입니다. |
name | 문자열 | 선택 | 펀드의 이름이며 제출한 그대로입니다. 시리즈 이름이 없는 펀드는 등록자의 이름을 씁니다. |
registrant_ | 문자열 | 선택 | 등록자의 ID이며 usa:에 10자리 CIK를 붙인 것입니다. 한 등록자가 여러 펀드에 대해 제출할 수 있습니다. |
registrant | 문자열 | 선택 | 등록자의 이름입니다. 펀드에 대해 제출하는 트러스트 또는 회사입니다. |
tickers | list of string | 항상 | 펀드의 각 클래스 티커입니다. 아직 티커가 없는 펀드는 비어 있습니다. |
listings | list of string | 항상 | 펀드의 티커 중 당사가 가진 종목의 종목 ID입니다. 예: ARCX:VOO. 없으면 비어 있습니다. |
period | 날짜 | 선택 | 반환된 보고서의 달력상 분기 말입니다. |
as_ | 날짜 | 선택 | 펀드 보고서의 기준일입니다. |
periods | list of date | 항상 | 펀드에 보고서가 있는 달력상 분기 말이며 최신순입니다. |
net_ | 문자열 | 선택 | 보고서 기준일의 펀드 순자산이며 currency 단위입니다. |
currency | 문자열 | 선택 | 펀드 수치의 통화입니다. 미국 달러이면 생략합니다. |
built_ | 문자열 | 선택 | 응답의 바탕이 된 파일이 만들어진 시각입니다(UTC). |
total_ | 정수 | 선택 | asset_와 limit로 무엇이 남든, 보고서 전체가 나열하는 보유 종목 수입니다. |
truncated | 불리언 | 선택 | 보고서가 너무 커서 통째로 제공하지 못하고 가장 큰 보유 종목만 가지고 있을 때 true입니다. total_와 composition은 여전히 보고서 전체를 셉니다. |
returned | 정수 | 항상 | 이 페이지가 반환하는 보유 종목 수입니다. |
fund | 객체 | 선택 | 반환된 보고서의 펀드 단위 수치이며 currency 단위입니다. |
fund.total_ | 문자열 | 선택 | 펀드의 총자산입니다. |
fund.total_ | 문자열 | 선택 | 펀드의 총부채입니다. |
fund.net_ | 문자열 | 선택 | 펀드의 순자산입니다. |
fund.borrowings_ | 문자열 | 선택 | 1년 이내에 만기가 돌아오는 차입금입니다. |
fund.borrowings_ | 문자열 | 선택 | 1년 이후에 만기가 돌아오는 차입금입니다. |
fund.delayed_ | 문자열 | 선택 | 지연 인도 방식으로 매수한 투자의 미지급금입니다. |
fund.standby_ | 문자열 | 선택 | 스탠바이 약정의 미지급금입니다. |
fund.liquidation_ | 문자열 | 선택 | 펀드 우선주의 청산 우선권입니다. |
fund.cash_ | 문자열 | 선택 | 펀드가 보유 종목 목록 밖에서 보고하는 현금입니다. |
fund.returns | 객체 목록 | 항상 | 보고서가 다루는 3개월 각각에서의 클래스별 총수익률이며 퍼센트입니다. |
fund.returns[].class_ | 문자열 | 항상 | 클래스 ID입니다. |
fund.returns[].month_ | 문자열 | 선택 | 3개월 중 첫째 달의 총수익률이며 퍼센트입니다. |
fund.returns[].month_ | 문자열 | 선택 | 둘째 달의 총수익률이며 퍼센트입니다. |
fund.returns[].month_ | 문자열 | 선택 | 셋째 달의 총수익률이며 퍼센트입니다. |
fund.interest_ | 객체 목록 | 항상 | 이를 보고하는 펀드의 경우: 금리가 1베이시스포인트, 100베이시스포인트 움직일 때 포트폴리오 가치의 변화이며 통화별입니다. |
fund.interest_ | 문자열 | 항상 | 수치의 통화. |
fund.interest_ | 객체 | 선택 | 금리가 1베이시스포인트 움직일 때 가치의 변화입니다. 만기는 3개월과 1, 5, 10, 30년이며 three_, one_, five_, ten_, thirty_입니다. |
fund.interest_ | 객체 | 선택 | 금리가 100베이시스포인트 움직일 때 가치의 변화이며 다섯 가지 만기는 같습니다. |
fund.credit_ | 객체 | 선택 | 투자 등급 보유 종목의 신용 스프레드 위험이며 펀드가 보고한 그대로입니다. 만기는 3개월과 1, 5, 10, 30년입니다. |
fund.credit_ | 문자열 | 선택 | 3개월 시점의 수치입니다. |
fund.credit_ | 문자열 | 선택 | 1년 시점의 수치입니다. |
fund.credit_ | 문자열 | 선택 | 5년 시점의 수치입니다. |
fund.credit_ | 문자열 | 선택 | 10년 시점의 수치입니다. |
fund.credit_ | 문자열 | 선택 | 30년 시점의 수치입니다. |
fund.credit_ | 객체 | 선택 | 투자 등급 미만 보유 종목의 신용 스프레드 위험이며 펀드가 보고한 그대로입니다. 만기는 3개월과 1, 5, 10, 30년입니다. |
fund.credit_ | 문자열 | 선택 | 3개월 시점의 수치입니다. |
fund.credit_ | 문자열 | 선택 | 1년 시점의 수치입니다. |
fund.credit_ | 문자열 | 선택 | 5년 시점의 수치입니다. |
fund.credit_ | 문자열 | 선택 | 10년 시점의 수치입니다. |
fund.credit_ | 문자열 | 선택 | 30년 시점의 수치입니다. |
fund.securities_ | 객체 목록 | 항상 | 보고서가 이름을 밝힌 펀드 증권의 차입자와, 각 차입자에게 빌려준 가치입니다. |
fund.securities_ | 문자열 | 항상 | 차입자의 이름입니다. |
fund.securities_ | 문자열 | 선택 | 차입자의 법인 식별 코드(LEI)입니다. |
fund.securities_ | 문자열 | 선택 | 이 차입자에게 대여 중인 증권의 가치입니다. |
composition | 객체 목록 | 항상 | 보고서 전체를 자산군별로 나타냅니다. 보유 종목 수, 그 가치, 순자산 대비 비율의 합입니다. asset_로 좁혀지지 않습니다. |
composition[].asset_ | one of equity, debt, cash, derivative, other | 항상 | 자산군: equity, debt, cash, derivative, other. |
composition[].holdings | 정수 | 항상 | 보고서가 이 자산군으로 나열하는 보유 종목 수입니다. |
composition[].value | 문자열 | 선택 | 이 자산군의 가치이며 currency 단위입니다. |
composition[].percent_ | 문자열 | 선택 | 이 자산군 보유 종목의 순자산 대비 비율의 합입니다. |
holdings | 객체 목록 | 항상 | 보유 종목이며 금액이 큰 순입니다. |
holdings[].filing_ | 문자열 | 항상 | 이 행의 출처가 된 N-PORT 공시의 ID입니다. |
holdings[].form | 문자열 | 항상 | 공시의 양식입니다. 예: NPORT-P. |
holdings[].amendment | 항상 true | 선택 | 공시가 이전 공시를 정정하는 것이면 true입니다. |
holdings[].filed | 날짜 | 항상 | 공시가 제출된 날입니다. |
holdings[].as_ | 날짜 | 항상 | 펀드 보고서의 날짜입니다. filed보다 몇 주 앞섭니다. |
holdings[].issuer | 문자열 | 항상 | 발행사의 이름이며 펀드가 보고한 그대로입니다. |
holdings[].title | 문자열 | 선택 | 발행 증권의 명칭이며 펀드가 보고한 그대로입니다. |
holdings[].lei | 문자열 | 선택 | 발행사의 법인 식별 코드(LEI)입니다. 펀드가 제공하지 않았으면 생략합니다. |
holdings[].isin | 문자열 | 선택 | 펀드가 제공한 경우의 ISIN입니다. 미국과 캐나다 증권, 그리고 일부 다른 증권의 ISIN은 보내지 않습니다. |
holdings[].asset_ | one of equity, debt, cash, derivative, other | 항상 | 보유 종목의 자산군: equity, debt, cash, derivative, other. |
holdings[].asset_ | 문자열 | 항상 | 보유 종목에 대한 펀드 자체의 분류: equity_, equity_, debt, asset_, asset_, asset_, asset_, loan, structured_, short_, repurchase_, derivative_, derivative_, derivative_, derivative_, derivative_, derivative_, commodity, real_, other. |
holdings[].issuer_ | 문자열 | 선택 | 발행 주체: corporate, us_, us_, us_, municipal, non_, private_, registered_, other. |
holdings[].restricted | 불리언 | 선택 | 보유 종목이 제한 증권이면 true입니다. |
holdings[].fair_ | one of 1, 2, 3 | 선택 | 펀드가 보유 종목에 부여한 공정가치 수준: 1, 2, 3. |
holdings[].derivative_ | 문자열 | 선택 | 파생상품의 경우 펀드가 보고한 유형입니다. 예: fut. |
holdings[].debt | 객체 | 선택 | 채권 보유 종목의 조건입니다. |
holdings[].debt.maturity_ | 날짜 | 선택 | 만기일입니다. |
holdings[].debt.coupon_ | one of fixed, floating, variable, none | 선택 | fixed, floating, variable, none. |
holdings[].debt.coupon_ | 문자열 | 선택 | 쿠폰 금리이며 퍼센트입니다. |
holdings[].debt.in_ | 불리언 | 선택 | 발행사가 채무불이행 상태이면 true입니다. |
holdings[].debt.interest_ | 불리언 | 선택 | 이자 지급이 연체되었으면 true입니다. |
holdings[].debt.paid_ | 불리언 | 선택 | 이자를 현물로 지급할 수 있으면 true입니다. |
holdings[].debt.mandatory_ | 불리언 | 선택 | 채권이 강제 전환 증권이면 true입니다. |
holdings[].debt.contingent_ | 불리언 | 선택 | 채권이 조건부 전환 증권이면 true입니다. |
holdings[].securities_ | 객체 | 선택 | 보유 종목의 대여, 또는 대여에 대한 현금 담보 보유에 관해 펀드가 보고하는 내용입니다. |
holdings[].securities_ | 불리언 | 선택 | 보유 종목이 대여 중이면 true입니다. |
holdings[].securities_ | 문자열 | 선택 | 대여 중인 보유 종목의 가치입니다. |
holdings[].securities_ | 불리언 | 선택 | 보유 종목이 대여에 대한 현금 담보이면 true입니다. |
holdings[].securities_ | 문자열 | 선택 | 그 현금 담보의 가치입니다. |
holdings[].securities_ | 불리언 | 선택 | 보유 종목의 일부가 대여로 받은 현금 외 담보이기도 하면 true입니다. |
holdings[].position | one of long, short | 선택 | long 또는 short. |
holdings[].balance | 문자열 | 선택 | 보유 수량입니다. balance_이 알려 주는 대로 주식 수, 원금 또는 금액입니다. |
holdings[].balance_ | one of shares, principal, currency | 선택 | shares, principal, currency. |
holdings[].currency | 문자열 | 선택 | balance가 금액일 때의 통화입니다. |
holdings[].exchange_ | 문자열 | 선택 | 보유 종목이 미국 달러가 아닐 때 펀드가 사용한 미국 달러 환율입니다. |
holdings[].value | 문자열 | 선택 | 보유 종목의 가치이며 value_가 다른 통화를 나타내지 않는 한 미국 달러입니다. 공시에 없으면 생략합니다. |
holdings[].value_ | 문자열 | 선택 | value의 통화입니다. 미국 달러이면 생략합니다. |
holdings[].percent_ | 문자열 | 선택 | 보유 종목의 가치가 펀드 순자산에서 차지하는 비율이며 퍼센트입니다. 펀드가 보고한 그대로입니다. |
holdings[].country | 문자열 | 선택 | 보고서가 보유 종목에 기재한 두 글자 국가 코드입니다. |
holdings[].company_ | 문자열 | 선택 | 당사 기업 목록에서의 발행사 ID입니다. 보유 종목이 어떤 기업과도 대응되지 않으면 생략합니다. |
holdings[].company | 문자열 | 선택 | 당사 기업 목록에서의 발행사 이름입니다. |
holdings[].ticker | 문자열 | 선택 | 당사 기업 목록에서의 발행사 티커입니다. |
next_ | 문자열 | 항상 | 다음 페이지를 읽으려면 cursor로 전달합니다. 항상 제공하며 마지막 페이지에서는 null입니다. |
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/funds/VOO/holdings?limit=2"{
"id": "usa:S000002839",
"name": "VANGUARD 500 INDEX FUND",
"registrant_id": "usa:0000036405",
"registrant": "VANGUARD INDEX FUNDS",
"tickers": [
"VFFSX",
"VFIAX",
"VFINX",
"VOO"
],
"listings": [
"ARCX:VOO"
],
"period": "2026-06-30",
"as_of": "2026-06-30",
"periods": [
"2026-06-30",
"2026-03-31",
"2025-12-31",
"2025-09-30"
],
"net_assets": "1671231561960.14",
"built_at": "2026-11-15T23:36:04Z",
"total_holdings": 520,
"returned": 2,
"fund": {
"total_assets": "1673632288919.41",
"total_liabilities": "2400726959.27",
"net_assets": "1671231561960.14",
"borrowings_within_year": "0",
"borrowings_after_year": "0",
"delayed_delivery_payables": "0",
"standby_commitment_payables": "0",
"liquidation_preference": "0",
"cash_not_in_holdings": "0",
"returns": [
{
"class_id": "C000007773",
"month_1": "10.48124793",
"month_2": "5.24963951",
"month_3": "-0.96247233"
},
{
"class_id": "C000007774",
"month_1": "10.49014889",
"month_2": "5.25936275",
"month_3": "-0.95490903"
}
],
"interest_rate_risk": [],
"securities_lending_borrowers": [
{
"name": "Nomura Securities International Inc.",
"lei": "OXTKY6Q8X53C9ILVV871",
"value": "35722130"
},
{
"name": "TD Securities (USA) LLC",
"lei": "SUVUFHICNZMP2WKHG940",
"value": "14321650"
}
]
},
"composition": [
{
"asset_class": "equity",
"holdings": 506,
"value": "1667040888389.89",
"percent_of_net_assets": "99.749246383931"
},
{
"asset_class": "cash",
"holdings": 2,
"value": "5833051440.22",
"percent_of_net_assets": "0.34902712305"
},
{
"asset_class": "derivative",
"holdings": 12,
"value": "-75145091.66",
"percent_of_net_assets": "-0.00449639014"
}
],
"holdings": [
{
"filing_id": "usa:0000036405:0000036405-26-000473",
"form": "NPORT-P",
"filed": "2026-08-28",
"as_of": "2026-06-30",
"issuer": "NVIDIA Corp",
"title": "NVIDIA CORP",
"lei": "549300S4KLFTLO7GSQ80",
"asset_class": "equity",
"asset_category": "equity_common",
"issuer_type": "corporate",
"restricted": false,
"fair_value_level": "1",
"securities_lending": {
"on_loan": false,
"cash_collateral": false,
"non_cash_collateral": false
},
"position": "long",
"balance": "627619094",
"balance_unit": "shares",
"value": "125580304518.46",
"percent_of_net_assets": "7.51423724736",
"country": "US",
"company_id": "usa:0001045810",
"company": "NVIDIA CORP",
"ticker": "NVDA"
},
{
"filing_id": "usa:0000036405:0000036405-26-000473",
"form": "NPORT-P",
"filed": "2026-08-28",
"as_of": "2026-06-30",
"issuer": "Apple Inc",
"title": "APPLE INC",
"lei": "HWUPKR0MPOU8FGXBT394",
"asset_class": "equity",
"asset_category": "equity_common",
"issuer_type": "corporate",
"restricted": false,
"fair_value_level": "1",
"securities_lending": {
"on_loan": false,
"cash_collateral": false,
"non_cash_collateral": false
},
"position": "long",
"balance": "380610709",
"balance_unit": "shares",
"value": "110133514756.24",
"percent_of_net_assets": "6.58996139512",
"country": "US",
"company_id": "usa:0000320193",
"company": "Apple Inc.",
"ticker": "AAPL"
}
],
"next_cursor": "eyJrIjoiMDk5OTk4ODk4NjY0…"
}기업을 보유한 펀드 목록 조회
GET /v1/companies/{company_id}/funds
Form N-PORT에서 기업의 포지션을 보고한 ETF와 펀드를 금액이 큰 순으로 반환합니다. 각 행은 한 펀드의 한 포지션이며 그 펀드의 보고서에서 온 것입니다.
행은 금액이 큰 순입니다. 각 행은 한 펀드의 한 포지션이며 펀드의 ID, 이름, 티커, 순자산을 담습니다. 모든 펀드를 읽으려면 next_로 페이지를 넘기세요.
MCP: 도구 filings_.
매개변수
| 매개변수 | 위치 | 필수 | 유형 | 의미 |
|---|---|---|---|---|
company_ | 경로 | 예 | 문자열 | 기업 ID입니다. 예: usa:0000320193. usa:AAPL 같은 티커 별칭도 사용할 수 있습니다. |
period | 쿼리 | 아니요 | 날짜 | 달력상의 분기 말입니다. 예: 2026-06-30. 생략하면 분기와 관계없이 각 펀드의 최신 보고서입니다. 어떤 펀드도 보고하지 않은 분기는 404 period_입니다. |
cursor | 쿼리 | 아니요 | 문자열 | 이전 페이지의 next_. 다른 매개변수는 동일하게 유지합니다. |
limit | 쿼리 | 아니요 | 정수 | 페이지당 행 수입니다. 기본값 100, 최대 500입니다. |
응답 필드
| 필드 | 유형 | 전송 | 의미 |
|---|---|---|---|
id | 문자열 | 항상 | 기업 ID입니다. |
period | 날짜 | 선택 | 반환된 달력상의 분기 말입니다. 요청에 period가 없으면 보유한 최신 분기입니다. |
periods | list of date | 항상 | 펀드 보고서가 있는 달력상 분기 말이며 최신순입니다. |
built_ | 문자열 | 선택 | 응답의 바탕이 된 파일이 만들어진 시각입니다(UTC). |
funds | 객체 목록 | 항상 | 기업을 보유한 펀드이며 금액이 큰 순입니다. |
funds[].filing_ | 문자열 | 항상 | 이 행의 출처가 된 N-PORT 공시의 ID입니다. |
funds[].form | 문자열 | 항상 | 공시의 양식입니다. 예: NPORT-P. |
funds[].amendment | 항상 true | 선택 | 공시가 이전 공시를 정정하는 것이면 true입니다. |
funds[].filed | 날짜 | 항상 | 공시가 제출된 날입니다. |
funds[].as_ | 날짜 | 항상 | 펀드 보고서의 날짜입니다. filed보다 몇 주 앞섭니다. |
funds[].issuer | 문자열 | 항상 | 발행사의 이름이며 펀드가 보고한 그대로입니다. |
funds[].title | 문자열 | 선택 | 발행 증권의 명칭이며 펀드가 보고한 그대로입니다. |
funds[].lei | 문자열 | 선택 | 발행사의 법인 식별 코드(LEI)입니다. 펀드가 제공하지 않았으면 생략합니다. |
funds[].isin | 문자열 | 선택 | 펀드가 제공한 경우의 ISIN입니다. 미국과 캐나다 증권, 그리고 일부 다른 증권의 ISIN은 보내지 않습니다. |
funds[].asset_ | one of equity, debt, cash, derivative, other | 항상 | 보유 종목의 자산군: equity, debt, cash, derivative, other. |
funds[].asset_ | 문자열 | 항상 | 보유 종목에 대한 펀드 자체의 분류: equity_, equity_, debt, asset_, asset_, asset_, asset_, loan, structured_, short_, repurchase_, derivative_, derivative_, derivative_, derivative_, derivative_, derivative_, commodity, real_, other. |
funds[].issuer_ | 문자열 | 선택 | 발행 주체: corporate, us_, us_, us_, municipal, non_, private_, registered_, other. |
funds[].restricted | 불리언 | 선택 | 보유 종목이 제한 증권이면 true입니다. |
funds[].fair_ | one of 1, 2, 3 | 선택 | 펀드가 보유 종목에 부여한 공정가치 수준: 1, 2, 3. |
funds[].derivative_ | 문자열 | 선택 | 파생상품의 경우 펀드가 보고한 유형입니다. 예: fut. |
funds[].debt | 객체 | 선택 | 채권 보유 종목의 조건입니다. |
funds[].debt.maturity_ | 날짜 | 선택 | 만기일입니다. |
funds[].debt.coupon_ | one of fixed, floating, variable, none | 선택 | fixed, floating, variable, none. |
funds[].debt.coupon_ | 문자열 | 선택 | 쿠폰 금리이며 퍼센트입니다. |
funds[].debt.in_ | 불리언 | 선택 | 발행사가 채무불이행 상태이면 true입니다. |
funds[].debt.interest_ | 불리언 | 선택 | 이자 지급이 연체되었으면 true입니다. |
funds[].debt.paid_ | 불리언 | 선택 | 이자를 현물로 지급할 수 있으면 true입니다. |
funds[].debt.mandatory_ | 불리언 | 선택 | 채권이 강제 전환 증권이면 true입니다. |
funds[].debt.contingent_ | 불리언 | 선택 | 채권이 조건부 전환 증권이면 true입니다. |
funds[].securities_ | 객체 | 선택 | 보유 종목의 대여, 또는 대여에 대한 현금 담보 보유에 관해 펀드가 보고하는 내용입니다. |
funds[].securities_ | 불리언 | 선택 | 보유 종목이 대여 중이면 true입니다. |
funds[].securities_ | 문자열 | 선택 | 대여 중인 보유 종목의 가치입니다. |
funds[].securities_ | 불리언 | 선택 | 보유 종목이 대여에 대한 현금 담보이면 true입니다. |
funds[].securities_ | 문자열 | 선택 | 그 현금 담보의 가치입니다. |
funds[].securities_ | 불리언 | 선택 | 보유 종목의 일부가 대여로 받은 현금 외 담보이기도 하면 true입니다. |
funds[].position | one of long, short | 선택 | long 또는 short. |
funds[].balance | 문자열 | 선택 | 보유 수량입니다. balance_이 알려 주는 대로 주식 수, 원금 또는 금액입니다. |
funds[].balance_ | one of shares, principal, currency | 선택 | shares, principal, currency. |
funds[].currency | 문자열 | 선택 | balance가 금액일 때의 통화입니다. |
funds[].exchange_ | 문자열 | 선택 | 보유 종목이 미국 달러가 아닐 때 펀드가 사용한 미국 달러 환율입니다. |
funds[].value | 문자열 | 선택 | 보유 종목의 가치이며 value_가 다른 통화를 나타내지 않는 한 미국 달러입니다. 공시에 없으면 생략합니다. |
funds[].value_ | 문자열 | 선택 | value의 통화입니다. 미국 달러이면 생략합니다. |
funds[].percent_ | 문자열 | 선택 | 보유 종목의 가치가 펀드 순자산에서 차지하는 비율이며 퍼센트입니다. 펀드가 보고한 그대로입니다. |
funds[].country | 문자열 | 선택 | 보고서가 보유 종목에 기재한 두 글자 국가 코드입니다. |
funds[].fund_ | 문자열 | 항상 | 펀드의 ID이며 usa:에 시리즈 ID를 붙인 것입니다. 시리즈 ID가 없으면 usa:에 등록자 번호를 붙인 것입니다. |
funds[].fund | 문자열 | 선택 | 펀드의 이름이며 제출한 그대로입니다. 시리즈 이름이 없는 펀드는 등록자의 이름을 씁니다. |
funds[].registrant | 문자열 | 선택 | 등록자의 이름입니다. 펀드에 대해 제출하는 트러스트 또는 회사입니다. |
funds[].tickers | list of string | 항상 | 펀드의 각 클래스 티커입니다. 아직 티커가 없는 펀드는 비어 있습니다. |
funds[].net_ | 문자열 | 선택 | 보고서 기준일의 펀드 순자산이며 value_가 다른 통화를 나타내지 않는 한 미국 달러입니다. |
next_ | 문자열 | 항상 | 다음 페이지를 읽으려면 cursor로 전달합니다. 항상 제공하며 마지막 페이지에서는 null입니다. |
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/companies/usa:0000320193/funds?period=2026-06-30&limit=2"{
"id": "usa:0000320193",
"period": "2026-06-30",
"periods": [
"2026-09-30",
"2026-06-30",
"2026-03-31",
"2025-12-31"
],
"built_at": "2026-11-16T17:49:09Z",
"funds": [
{
"filing_id": "usa:0000036405:0000036405-26-000480",
"form": "NPORT-P",
"filed": "2026-08-28",
"as_of": "2026-06-30",
"issuer": "Apple Inc",
"title": "APPLE INC",
"lei": "HWUPKR0MPOU8FGXBT394",
"asset_class": "equity",
"asset_category": "equity_common",
"issuer_type": "corporate",
"restricted": false,
"fair_value_level": "1",
"securities_lending": {
"on_loan": false,
"cash_collateral": false,
"non_cash_collateral": false
},
"position": "long",
"balance": "466272244",
"balance_unit": "shares",
"value": "134920536523.84",
"percent_of_net_assets": "5.871626660176",
"country": "US",
"fund_id": "usa:S000002848",
"fund": "VANGUARD TOTAL STOCK MARKET INDEX FUND",
"registrant": "VANGUARD INDEX FUNDS",
"tickers": [
"VITSX",
"VSMPX",
"VSTSX",
"VTI",
"VTSAX",
"VTSMX"
],
"net_assets": "2297839156547.89"
},
{
"filing_id": "usa:0000036405:0000036405-26-000473",
"form": "NPORT-P",
"filed": "2026-08-28",
"as_of": "2026-06-30",
"issuer": "Apple Inc",
"title": "APPLE INC",
"lei": "HWUPKR0MPOU8FGXBT394",
"asset_class": "equity",
"asset_category": "equity_common",
"issuer_type": "corporate",
"restricted": false,
"fair_value_level": "1",
"securities_lending": {
"on_loan": false,
"cash_collateral": false,
"non_cash_collateral": false
},
"position": "long",
"balance": "380610709",
"balance_unit": "shares",
"value": "110133514756.24",
"percent_of_net_assets": "6.58996139512",
"country": "US",
"fund_id": "usa:S000002839",
"fund": "VANGUARD 500 INDEX FUND",
"registrant": "VANGUARD INDEX FUNDS",
"tickers": [
"VFFSX",
"VFIAX",
"VFINX",
"VOO"
],
"net_assets": "1671231561960.14"
}
],
"next_cursor": "eyJrIjoiMDk5OTk4ODk4NjY0…"
}오류
오류는 공통 문제 형식을 사용하며, 다음 필드를 포함합니다: request_. 확인 API 오류 코드와 크레딧 형식과 크레딧 헤더에 대한 설명이 있습니다. 실패한 요청에는 요금이 부과되지 않습니다.
| 코드 | 상태 | 의미 |
|---|---|---|
invalid_ | 400 | 매개변수가 없거나, 알 수 없거나, 중복되었거나, 범위를 벗어났습니다. |
invalid_ | 400 | 이 요청이 반환한 커서가 아니거나, 다른 요청의 커서입니다. |
fund_ | 404 | 시리즈 ID, 티커, 종목 ID, 등록자 번호와 일치하는 펀드가 없습니다. 시리즈 ID가 없는 펀드는 아직 티커로 찾을 수 없습니다. |
company_ | 404 | ID와 일치하는 기업이 없습니다. |
period_ | 404 | 요청한 분기에 대한 펀드 보유 종목 데이터가 없거나, 그 분기의 펀드 보고서가 요청한 as_of 날짜 기준이 아닙니다. |
not_ | 404 | 해당 시장, 국가 또는 기업은 아직 제공되지 않습니다. |
insufficient_ | 402 | 크레딧 잔액이 요청 비용보다 적습니다. |
company_ | 503 | 이 경로의 근거 공시를 지금은 읽을 수 없습니다. 잠시 후 다시 시도하세요. |
이 페이지가 도움이 되었나요?