전체 문서 탐색

내부자 거래 API 레퍼런스

SEC Form 3, 4, 5의 기업 내부자 거래와 보유 현황

개요

내부자 거래는 SEC 소유 보고 양식에서 가져옵니다. Form 3(최초 보유), Form 4(변동), Form 5(연간 보완 보고)이며 정정본도 포함합니다. 미국 상장 기업의 임원, 이사, 10% 보유자를 대상으로 합니다. 모든 요청에 Bearer 키가 필요하며, REST와 MCP는 하나의 크레딧 잔액을 함께 사용합니다.

8개 경로가 한 기업의 거래, 보유 현황, 보유 현황 보고서, 내부자, 내부자 한 명의 기업 전체 거래, 모든 기업의 거래 피드, 일별 매수·매도 합계, 거래 코드 목록을 다룹니다. 기업은 공시 API의 ID로 지정합니다. 예: usa:0000320193. 내부자는 본인의 CIK로 지정합니다.

이력은 2021년 10월 공시부터 시작합니다. 새 공시는 SEC에서 2분마다 읽습니다.

미국만 지원합니다. 다른 국가는 404 not_covered입니다.

기본 URL: https://api.narwhalapi.com. 아래 각 경로는 같은 매개변수를 가진 별도의 MCP 도구입니다.

5%를 넘는 보유자는 다음 페이지에 있습니다: 대량 보유자 페이지.

기업 ID는 공시 API 기업 검색이 반환하는 값입니다.

모든 계정에 제공되는 것

항목모든 계정
내부자 거래, 7개 경로포함
거래 코드 목록포함, 무료

확인 요금 페이지에서 호출당 비용을 확인할 수 있습니다. 라우트에 별도 안내가 없으면 요청은 해당 API의 가격으로 청구됩니다.

  • Companies 가격으로 청구됩니다. 성공한 응답은 행 수와 관계없이 호출 1회이며, 빈 페이지도 청구됩니다. 오류는 청구되지 않습니다. 거래 코드 목록은 무료입니다.
  • 숫자는 소수 문자열입니다. 값이 없는 필드는 생략하고, 목록은 항상 있으며, officer 같은 플래그는 true일 때만 보냅니다.
  • 거래 가격은 주당 가격이며 공시에 없으면 생략합니다. transaction_value와 shares_owned_before는 공시에 근거 수치가 있을 때만 계산합니다.
  • Rule 10b5-1 칸은 양식 전체에 대해 한 번 체크합니다. plan_10b5_1은 그런 양식의 모든 거래에서 true이며, 제출자가 계획에 따라 하지 않은 거래도 포함합니다.
  • 원본 하나와 정확히 일치한 정정 공시는 amends에 그 원본을 적습니다. 찾지 못한 원본을 가리키면 amends_unmatched가 true이며 두 행 모두 목록에 남습니다.
  • 부모 회사 같은 다른 법인을 통해서만 보고하는 보유자는 주식 합계 없이 나열합니다. 주식 수가 없으면 ownership_pct는 비어 있습니다.
  • 피드에 있지만 기업 목록에 없는 기업은 기업 경로에서 404를 반환합니다.
  • 보유 자료가 없는 내부자 CIK는 내부자 경로에서 빈 페이지를 반환하며 요금이 청구됩니다.

엔드포인트

모든 경로는 GET이며, 키를 다음 헤더에 담아 보내야 합니다: Authorization: Bearer 헤더입니다. 예시는 응답의 형태를 보여 줄 뿐이며 실시간 데이터가 아닙니다.

기업의 내부자 거래 목록

GET /v1/companies/{company_id}/insider-trades

Form 4와 Form 5에서 임원, 이사, 10% 보유자가 보고한 해당 기업 주식의 모든 거래를 최신 공시순으로 반환합니다. 파생 거래(옵션, 워런트, 전환증권)도 포함하며 derivative가 표시됩니다.

거래는 Form 4와 Form 5에서 가져옵니다. form_type이 3 또는 3/A이면 빈 목록을 반환합니다.

기본 정렬은 공시일 기준 최신순입니다. 거래 순서로 읽으려면 sort=transaction_date.asc 값을 보내세요.

MCP: 도구 filings_list_insider_trades.

매개변수

매개변수위치필수유형의미
company_id경로예문자열기업 ID입니다. 예: usa:0000320193. usa:AAPL 같은 티커 별칭도 사용할 수 있습니다.
filed_from쿼리아니요날짜조회 시작 공시일입니다(해당 일 포함, YYYY-MM-DD).
filed_to쿼리아니요날짜조회 종료 공시일입니다(해당 일 포함).
filing_date쿼리아니요날짜이 날 제출된 공시만 반환합니다.
filing_date_gt쿼리아니요날짜이 날 이후에 제출된 공시만 반환합니다.
filing_date_lt쿼리아니요날짜이 날 이전에 제출된 공시만 반환합니다.
transaction_date쿼리아니요날짜이 날 이루어진 거래만 반환합니다.
transaction_date_gt쿼리아니요날짜이 날 이후에 이루어진 거래만 반환합니다.
transaction_date_gte쿼리아니요날짜이 날 또는 그 이후에 이루어진 거래만 반환합니다.
transaction_date_lt쿼리아니요날짜이 날 이전에 이루어진 거래만 반환합니다.
transaction_date_lte쿼리아니요날짜이 날 또는 그 이전에 이루어진 거래만 반환합니다.
owner_cik쿼리아니요문자열이 CIK를 가진 소유자의 공시만 반환합니다. 앞의 0은 생략할 수 있습니다.
name쿼리아니요문자열이름에 이 텍스트가 포함된 소유자만 반환합니다. 대소문자를 구분하지 않으며 2~100자입니다.
transaction_code쿼리아니요문자열SEC 거래 코드가 이 한 글자인 거래만 반환합니다. 예: P 또는 S.
form_type쿼리아니요one of 3, 3/A, 4, 4/A, 5, 5/A이 양식의 거래만 반환합니다. 거래는 Form 4와 Form 5에서 가져옵니다.
sort쿼리아니요one of filing_date.desc, filing_date.asc, transaction_date.desc, transaction_date.asc목록의 정렬 순서입니다. 기본값은 filing_date.desc입니다.
cursor쿼리아니요문자열이전 페이지의 next_cursor. 다른 매개변수는 동일하게 유지합니다.
limit쿼리아니요정수페이지당 행 수입니다. 기본값 50, 최대 200입니다.

응답 필드

필드유형전송의미
id문자열항상기업 ID입니다. 내부자 한 명의 거래에서는 usa: 뒤에 내부자의 CIK를 붙인 값입니다.
filed_from날짜선택이 계정이 읽을 수 있는 가장 이른 공시일입니다. 그보다 이른 날이 가려져 있지 않으면 생략합니다.
trades객체 목록항상요청한 순서대로 나열한 거래입니다.
trades[].derivative항상 true선택옵션, 워런트, 전환증권 같은 파생 증권이면 true입니다.
trades[].security문자열선택공시에 적힌 증권 명칭입니다. 예: Common Stock.
trades[].ownershipone of D, I선택D는 직접 보유, I는 간접 보유입니다.
trades[].nature문자열선택간접 보유 방식이며, 공시에 적힌 그대로입니다.
trades[].underlying문자열선택파생 증권인 경우 전환 대상이 되는 증권입니다.
trades[].underlying_shares문자열선택파생 증권인 경우 기초 주식 수입니다.
trades[].exercise_price문자열선택파생 증권인 경우 행사가격 또는 전환가격입니다.
trades[].exercise_date날짜선택파생 증권인 경우 처음 행사할 수 있는 날짜입니다.
trades[].expiration_date날짜선택파생 증권인 경우 만료일입니다.
trades[].filing_id문자열항상이 행의 출처가 된 공시의 ID입니다.
trades[].formone of 3, 3/A, 4, 4/A, 5, 5/A항상행이 보고된 양식입니다. 3, 4, 5이며 정정이면 /A가 붙습니다.
trades[].filed날짜항상공시가 제출된 날입니다.
trades[].period날짜선택공시 의무를 발생시킨 사건의 날짜입니다.
trades[].owners객체 목록항상공시의 보고 소유자입니다. 공동 공시에는 여러 명이 나열됩니다.
trades[].owners[].cik문자열선택소유자의 SEC Central Index Key입니다.
trades[].owners[].id문자열선택등록처 접두어가 붙은 소유자 ID입니다. 예: usa:0001780525.
trades[].owners[].name문자열항상공시에 적힌 소유자 이름입니다.
trades[].owners[].title문자열선택공시에 적힌 임원 직함 또는 기타 관계입니다.
trades[].owners[].director항상 true선택소유자가 이사이면 true입니다.
trades[].owners[].officer항상 true선택소유자가 임원이면 true입니다.
trades[].owners[].ten_percent항상 true선택소유자가 주식의 10%를 넘게 보유하면 true입니다.
trades[].owners[].other항상 true선택소유자가 기업과 다른 관계가 있으면 true입니다.
trades[].plan_10b5_1항상 true선택양식에 Rule 10b5-1 칸이 체크되어 있으면 true입니다.
trades[].transaction_date날짜선택거래일입니다.
trades[].code문자열선택SEC 거래 코드입니다. 예: P 매수, S 매도, A 부여, M 옵션 행사, F 세금 원천징수, G 증여.
trades[].acquired_disposedone of A, D선택소유자가 주식을 취득하면 A, 처분하면 D입니다.
trades[].shares문자열선택거래된 주식 수입니다.
trades[].price문자열선택주당 가격입니다. 공시에 가격이 없으면 생략합니다.
trades[].currency문자열선택가격과 금액의 통화입니다. 생략하면 미국 달러입니다.
trades[].owned_after문자열선택거래 후 보유 주식 수입니다.
trades[].equity_swap항상 true선택제출자가 이 거래를 주식 스왑 또는 유사 상품으로 표시하면 true입니다.
trades[].amends문자열선택이 공시가 원본 하나와 정확히 일치하는 정정 공시일 때, 이 공시가 대체하는 공시입니다.
trades[].amends_unmatched항상 true선택정정 공시가 찾지 못한 원본을 가리키면 true입니다.
trades[].transaction_value문자열선택shares와 price의 곱입니다. 공시에 둘 다 있지 않으면 생략합니다.
trades[].shares_owned_before문자열선택거래 전 보유 주식 수입니다. 해당 포지션에 대한 공시 행들의 잔액이 서로 이어질 때만 제공합니다.
trades[].deemed_execution_date날짜선택거래가 실행된 것으로 간주되는 날짜이며, 공시에 있을 때만 제공합니다.
trades[].timelinessone of E, L선택제출자가 보고를 조기로 표시하면 E, 지연으로 표시하면 L입니다.
trades[].not_subject_to_section_16항상 true선택제출자가 이 거래를 Section 16 적용 대상이 아닌 것으로 표시하면 true입니다.
trades[].remarks문자열선택제출자가 양식에 적은 비고입니다.
trades[].footnoteslist of string항상행의 각주입니다. 없으면 비어 있습니다.
trades[].company_id문자열선택주식이 거래된 기업의 ID입니다. 한 기업에 한정되지 않은 목록에서 제공합니다.
trades[].issuer문자열선택주식이 거래된 기업의 이름입니다.
trades[].ticker문자열선택기업의 티커입니다.
next_cursor문자열항상다음 페이지를 읽으려면 cursor로 전달합니다. 항상 제공하며 마지막 페이지에서는 null입니다.
요청
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/companies/usa:0000320193/insider-trades?transaction_code=S&limit=1"
응답 예시
{
  "id": "usa:0000320193",
  "trades": [
    {
      "security": "Common Stock",
      "ownership": "D",
      "filing_id": "usa:0000320193:0001140361-26-042149",
      "form": "4",
      "filed": "2026-11-05",
      "period": "2026-11-03",
      "owners": [
        {
          "cik": "0001780525",
          "name": "Newstead Jennifer",
          "title": "SVP, GC and Government Affairs",
          "officer": true
        }
      ],
      "plan_10b5_1": true,
      "transaction_date": "2026-11-03",
      "code": "S",
      "acquired_disposed": "D",
      "shares": "2399",
      "price": "325.75",
      "owned_after": "29997",
      "transaction_value": "781474.25",
      "shares_owned_before": "32396",
      "footnotes": [
        "This transaction was made pursuant to a Rule 10b5-1 trading plan adopted by the reporting person on May 5, 2026."
      ]
    }
  ],
  "next_cursor": "eyJrIjoiNzk3Mzg4OTQ5OTk4…"
}

기업의 내부자 보유 현황 목록

GET /v1/companies/{company_id}/insider-ownership

내부자별, 증권별 가장 최근에 보고된 보유량입니다. 가장 최근 거래 후 잔액, 또는 Form 3 또는 연간 보유 보고 중 나중에 제출된 것입니다.

소유자와 증권마다 행 하나이며 가장 최근 잔액입니다. shares는 보유 수량이며, 공시가 주식 수 대신 금액을 주는 경우에는 value입니다. as_of는 그 거래일 또는 해당 보유 공시의 제출일입니다.

MCP: 도구 filings_list_insider_ownership.

매개변수

매개변수위치필수유형의미
company_id경로예문자열기업 ID입니다. 예: usa:0000320193. usa:AAPL 같은 티커 별칭도 사용할 수 있습니다.
filed_from쿼리아니요날짜조회 시작 공시일입니다(해당 일 포함, YYYY-MM-DD).
filed_to쿼리아니요날짜조회 종료 공시일입니다(해당 일 포함).
filing_date쿼리아니요날짜이 날 제출된 공시만 반환합니다.
filing_date_gt쿼리아니요날짜이 날 이후에 제출된 공시만 반환합니다.
filing_date_lt쿼리아니요날짜이 날 이전에 제출된 공시만 반환합니다.
owner_cik쿼리아니요문자열이 CIK를 가진 소유자의 공시만 반환합니다. 앞의 0은 생략할 수 있습니다.
name쿼리아니요문자열이름에 이 텍스트가 포함된 소유자만 반환합니다. 대소문자를 구분하지 않으며 2~100자입니다.
form_type쿼리아니요one of 3, 3/A, 4, 4/A, 5, 5/A이 양식의 공시만 반환합니다.
cursor쿼리아니요문자열이전 페이지의 next_cursor. 다른 매개변수는 동일하게 유지합니다.
limit쿼리아니요정수페이지당 행 수입니다. 기본값 100, 최대 500입니다.

응답 필드

필드유형전송의미
id문자열항상기업 ID입니다. 내부자 한 명의 거래에서는 usa: 뒤에 내부자의 CIK를 붙인 값입니다.
filed_from날짜선택이 계정이 읽을 수 있는 가장 이른 공시일입니다. 그보다 이른 날이 가려져 있지 않으면 생략합니다.
positions객체 목록항상소유자별, 증권별 가장 최근 보유량입니다.
positions[].derivative항상 true선택옵션, 워런트, 전환증권 같은 파생 증권이면 true입니다.
positions[].security문자열선택공시에 적힌 증권 명칭입니다. 예: Common Stock.
positions[].ownershipone of D, I선택D는 직접 보유, I는 간접 보유입니다.
positions[].nature문자열선택간접 보유 방식이며, 공시에 적힌 그대로입니다.
positions[].underlying문자열선택파생 증권인 경우 전환 대상이 되는 증권입니다.
positions[].underlying_shares문자열선택파생 증권인 경우 기초 주식 수입니다.
positions[].exercise_price문자열선택파생 증권인 경우 행사가격 또는 전환가격입니다.
positions[].exercise_date날짜선택파생 증권인 경우 처음 행사할 수 있는 날짜입니다.
positions[].expiration_date날짜선택파생 증권인 경우 만료일입니다.
positions[].filing_id문자열항상이 행의 출처가 된 공시의 ID입니다.
positions[].formone of 3, 3/A, 4, 4/A, 5, 5/A항상행이 보고된 양식입니다. 3, 4, 5이며 정정이면 /A가 붙습니다.
positions[].filed날짜항상공시가 제출된 날입니다.
positions[].owners객체 목록항상공시의 보고 소유자입니다. 공동 공시에는 여러 명이 나열됩니다.
positions[].owners[].cik문자열선택소유자의 SEC Central Index Key입니다.
positions[].owners[].id문자열선택등록처 접두어가 붙은 소유자 ID입니다. 예: usa:0001780525.
positions[].owners[].name문자열항상공시에 적힌 소유자 이름입니다.
positions[].owners[].title문자열선택공시에 적힌 임원 직함 또는 기타 관계입니다.
positions[].owners[].director항상 true선택소유자가 이사이면 true입니다.
positions[].owners[].officer항상 true선택소유자가 임원이면 true입니다.
positions[].owners[].ten_percent항상 true선택소유자가 주식의 10%를 넘게 보유하면 true입니다.
positions[].owners[].other항상 true선택소유자가 기업과 다른 관계가 있으면 true입니다.
positions[].as_of날짜항상이 잔액의 근거가 된 거래일 또는 보유 공시의 제출일입니다.
positions[].shares문자열선택보유 주식 수입니다.
positions[].value문자열선택공시가 주식 수 대신 금액을 보고할 때의 보유 금액(달러)입니다.
positions[].currency문자열선택가격과 금액의 통화입니다. 생략하면 미국 달러입니다.
next_cursor문자열항상다음 페이지를 읽으려면 cursor로 전달합니다. 항상 제공하며 마지막 페이지에서는 null입니다.
요청
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/companies/usa:0000320193/insider-ownership?limit=1"
응답 예시
{
  "id": "usa:0000320193",
  "positions": [
    {
      "security": "Common Stock",
      "ownership": "D",
      "filing_id": "usa:0000320193:0001140361-26-042149",
      "form": "4",
      "filed": "2026-11-05",
      "owners": [
        {
          "cik": "0001780525",
          "name": "Newstead Jennifer",
          "title": "SVP, GC and Government Affairs",
          "officer": true
        }
      ],
      "as_of": "2026-11-03",
      "shares": "29997"
    }
  ],
  "next_cursor": "eyJrIjoiNzk3Mzg4OTQ5OTk4…"
}

기업의 보유 현황 보고서 목록

GET /v1/companies/{company_id}/insider-ownership/statements

Form 3, Form 5 보유 현황 보고서와 그 정정본을 제출된 그대로 최신순으로 반환합니다. 최신 잔액만이 아닙니다.

보고서는 Form 3, Form 5와 그 정정본이며 제출된 그대로입니다. form_type에는 3, 3/A, 5, 5/A를 쓸 수 있고, 다른 양식은 400 invalid_query입니다.

MCP: 도구 filings_list_insider_statements.

매개변수

매개변수위치필수유형의미
company_id경로예문자열기업 ID입니다. 예: usa:0000320193. usa:AAPL 같은 티커 별칭도 사용할 수 있습니다.
filed_from쿼리아니요날짜조회 시작 공시일입니다(해당 일 포함, YYYY-MM-DD).
filed_to쿼리아니요날짜조회 종료 공시일입니다(해당 일 포함).
filing_date쿼리아니요날짜이 날 제출된 공시만 반환합니다.
filing_date_gt쿼리아니요날짜이 날 이후에 제출된 공시만 반환합니다.
filing_date_lt쿼리아니요날짜이 날 이전에 제출된 공시만 반환합니다.
owner_cik쿼리아니요문자열이 CIK를 가진 소유자의 공시만 반환합니다. 앞의 0은 생략할 수 있습니다.
name쿼리아니요문자열이름에 이 텍스트가 포함된 소유자만 반환합니다. 대소문자를 구분하지 않으며 2~100자입니다.
form_type쿼리아니요one of 3, 3/A, 4, 4/A, 5, 5/A이 양식의 보고서만 반환합니다: 3, 3/A, 5 또는 5/A.
cursor쿼리아니요문자열이전 페이지의 next_cursor. 다른 매개변수는 동일하게 유지합니다.
limit쿼리아니요정수페이지당 행 수입니다. 기본값 100, 최대 500입니다.

응답 필드

필드유형전송의미
id문자열항상기업 ID입니다. 내부자 한 명의 거래에서는 usa: 뒤에 내부자의 CIK를 붙인 값입니다.
statements객체 목록항상보고서를 최신순으로 나열합니다.
statements[].derivative항상 true선택옵션, 워런트, 전환증권 같은 파생 증권이면 true입니다.
statements[].security문자열선택공시에 적힌 증권 명칭입니다. 예: Common Stock.
statements[].ownershipone of D, I선택D는 직접 보유, I는 간접 보유입니다.
statements[].nature문자열선택간접 보유 방식이며, 공시에 적힌 그대로입니다.
statements[].underlying문자열선택파생 증권인 경우 전환 대상이 되는 증권입니다.
statements[].underlying_shares문자열선택파생 증권인 경우 기초 주식 수입니다.
statements[].exercise_price문자열선택파생 증권인 경우 행사가격 또는 전환가격입니다.
statements[].exercise_date날짜선택파생 증권인 경우 처음 행사할 수 있는 날짜입니다.
statements[].expiration_date날짜선택파생 증권인 경우 만료일입니다.
statements[].filing_id문자열항상이 행의 출처가 된 공시의 ID입니다.
statements[].formone of 3, 3/A, 4, 4/A, 5, 5/A항상행이 보고된 양식입니다. 3, 4, 5이며 정정이면 /A가 붙습니다.
statements[].filed날짜항상공시가 제출된 날입니다.
statements[].owners객체 목록항상공시의 보고 소유자입니다. 공동 공시에는 여러 명이 나열됩니다.
statements[].owners[].cik문자열선택소유자의 SEC Central Index Key입니다.
statements[].owners[].id문자열선택등록처 접두어가 붙은 소유자 ID입니다. 예: usa:0001780525.
statements[].owners[].name문자열항상공시에 적힌 소유자 이름입니다.
statements[].owners[].title문자열선택공시에 적힌 임원 직함 또는 기타 관계입니다.
statements[].owners[].director항상 true선택소유자가 이사이면 true입니다.
statements[].owners[].officer항상 true선택소유자가 임원이면 true입니다.
statements[].owners[].ten_percent항상 true선택소유자가 주식의 10%를 넘게 보유하면 true입니다.
statements[].owners[].other항상 true선택소유자가 기업과 다른 관계가 있으면 true입니다.
statements[].as_of날짜항상이 잔액의 근거가 된 거래일 또는 보유 공시의 제출일입니다.
statements[].shares문자열선택보유 주식 수입니다.
statements[].value문자열선택공시가 주식 수 대신 금액을 보고할 때의 보유 금액(달러)입니다.
statements[].currency문자열선택가격과 금액의 통화입니다. 생략하면 미국 달러입니다.
next_cursor문자열항상다음 페이지를 읽으려면 cursor로 전달합니다. 항상 제공하며 마지막 페이지에서는 null입니다.
요청
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/companies/usa:0000320193/insider-ownership/statements?limit=1"
응답 예시
{
  "id": "usa:0000320193",
  "statements": [
    {
      "security": "Common Stock",
      "ownership": "D",
      "filing_id": "usa:0000320193:0001140361-26-035359",
      "form": "3",
      "filed": "2026-09-01",
      "owners": [
        {
          "cik": "0002148403",
          "name": "Ternus John",
          "title": "CEO",
          "director": true,
          "officer": true
        }
      ],
      "as_of": "2026-09-01",
      "shares": "34155"
    }
  ],
  "next_cursor": "eyJrIjoiNzk3MzkwOTg5OTk4…"
}

기업의 내부자 목록

GET /v1/companies/{company_id}/insiders

기업에 대해 Form 3, 4, 5로 보고한 모든 사람과 그들의 역할, 제출 횟수, 현재 보유량입니다.

shares_owned_direct와 shares_owned_indirect는 일반 주식 포지션별 가장 최근 잔액을 더한 값입니다. 파생 증권은 제외합니다. 여러 소유자가 함께 보고하는 포지션은 각 소유자에게 모두 계산됩니다.

MCP: 도구 filings_list_company_insiders.

매개변수

매개변수위치필수유형의미
company_id경로예문자열기업 ID입니다. 예: usa:0000320193. usa:AAPL 같은 티커 별칭도 사용할 수 있습니다.
name쿼리아니요문자열이름에 이 텍스트가 포함된 소유자만 반환합니다. 대소문자를 구분하지 않으며 2~100자입니다.
cursor쿼리아니요문자열이전 페이지의 next_cursor. 다른 매개변수는 동일하게 유지합니다.
limit쿼리아니요정수페이지당 행 수입니다. 기본값 100, 최대 500입니다.

응답 필드

필드유형전송의미
id문자열항상기업 ID입니다. 내부자 한 명의 거래에서는 usa: 뒤에 내부자의 CIK를 붙인 값입니다.
insiders객체 목록항상기업의 내부자입니다.
insiders[].owner_cik문자열선택내부자의 SEC Central Index Key입니다.
insiders[].owner_id문자열선택등록처 접두어가 붙은 내부자 ID입니다.
insiders[].name문자열항상공시에 적힌 소유자 이름입니다.
insiders[].title문자열선택공시에 적힌 임원 직함 또는 기타 관계입니다.
insiders[].director항상 true선택소유자가 이사이면 true입니다.
insiders[].officer항상 true선택소유자가 임원이면 true입니다.
insiders[].ten_percent항상 true선택소유자가 주식의 10%를 넘게 보유하면 true입니다.
insiders[].other항상 true선택소유자가 기업과 다른 관계가 있으면 true입니다.
insiders[].first_filing_date날짜항상이 기업에 대한 내부자의 첫 공시일입니다.
insiders[].last_filing_date날짜항상이 기업에 대한 내부자의 가장 최근 공시일입니다.
insiders[].filing_count정수항상내부자가 이 기업에 대해 제출한 공시 수입니다.
insiders[].position_count정수항상내부자가 보고한 포지션 수입니다.
insiders[].shares_owned문자열선택일반 주식 포지션별 가장 최근 잔액의 합계입니다. 내부자가 주식 잔액을 보고한 적이 없으면 생략합니다.
insiders[].shares_owned_direct문자열선택shares_owned 중 직접 보유한 부분입니다.
insiders[].shares_owned_indirect문자열선택shares_owned 중 간접 보유한 부분입니다.
insiders[].ownership_pct문자열선택shares_owned가 기업의 가장 최근 보고 발행 주식 수에서 차지하는 비율(%)입니다. 발행 주식 수를 알 수 없거나, 결과가 100을 넘거나, 기업의 주식이 두 종류 이상이면 생략합니다.
insiders[].outstanding_as_of날짜선택ownership_pct의 근거가 된 발행 주식 수 수치의 날짜입니다.
next_cursor문자열항상다음 페이지를 읽으려면 cursor로 전달합니다. 항상 제공하며 마지막 페이지에서는 null입니다.
요청
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/companies/usa:0000320193/insiders?limit=1"
응답 예시
{
  "id": "usa:0000320193",
  "insiders": [
    {
      "owner_cik": "0001780525",
      "name": "Newstead Jennifer",
      "title": "SVP, GC and Government Affairs",
      "officer": true,
      "first_filing_date": "2026-03-06",
      "last_filing_date": "2026-11-05",
      "filing_count": 17,
      "position_count": 1,
      "shares_owned": "29997",
      "shares_owned_direct": "29997",
      "ownership_pct": "0.0002",
      "outstanding_as_of": "2026-10-23"
    }
  ],
  "next_cursor": "eyJrIjoiNzk3My04OC05NHww…"
}

내부자 한 명의 거래 목록

GET /v1/insiders/{cik}/trades

내부자 한 명이 여러 기업에 걸쳐 제출한 모든 거래를 최신 공시순으로 반환합니다. cik 값은 내부자 본인의 CIK입니다.

응답의 id 값은 usa: 뒤에 내부자의 CIK를 붙인 것입니다. 행은 기업 경로와 같으며 company_id, issuer, ticker가 추가됩니다.

MCP: 도구 filings_list_insider_person_trades.

매개변수

매개변수위치필수유형의미
cik경로예문자열내부자 본인의 CIK이며 1~10자리 숫자입니다.
filed_from쿼리아니요날짜조회 시작 공시일입니다(해당 일 포함, YYYY-MM-DD).
filed_to쿼리아니요날짜조회 종료 공시일입니다(해당 일 포함).
filing_date쿼리아니요날짜이 날 제출된 공시만 반환합니다.
filing_date_gt쿼리아니요날짜이 날 이후에 제출된 공시만 반환합니다.
filing_date_lt쿼리아니요날짜이 날 이전에 제출된 공시만 반환합니다.
transaction_date쿼리아니요날짜이 날 이루어진 거래만 반환합니다.
transaction_date_gt쿼리아니요날짜이 날 이후에 이루어진 거래만 반환합니다.
transaction_date_gte쿼리아니요날짜이 날 또는 그 이후에 이루어진 거래만 반환합니다.
transaction_date_lt쿼리아니요날짜이 날 이전에 이루어진 거래만 반환합니다.
transaction_date_lte쿼리아니요날짜이 날 또는 그 이전에 이루어진 거래만 반환합니다.
owner_cik쿼리아니요문자열이 CIK를 가진 소유자의 공시만 반환합니다. 앞의 0은 생략할 수 있습니다.
name쿼리아니요문자열이름에 이 텍스트가 포함된 소유자만 반환합니다. 대소문자를 구분하지 않으며 2~100자입니다.
transaction_code쿼리아니요문자열SEC 거래 코드가 이 한 글자인 거래만 반환합니다. 예: P 또는 S.
form_type쿼리아니요one of 3, 3/A, 4, 4/A, 5, 5/A이 양식의 거래만 반환합니다. 거래는 Form 4와 Form 5에서 가져옵니다.
sort쿼리아니요one of filing_date.desc, filing_date.asc, transaction_date.desc, transaction_date.asc목록의 정렬 순서입니다. 기본값은 filing_date.desc입니다.
cursor쿼리아니요문자열이전 페이지의 next_cursor. 다른 매개변수는 동일하게 유지합니다.
limit쿼리아니요정수페이지당 행 수입니다. 기본값 50, 최대 200입니다.

응답 필드

필드유형전송의미
id문자열선택기업 ID입니다. 내부자 한 명의 거래에서는 usa: 뒤에 내부자의 CIK를 붙인 값입니다.
filed_from날짜선택이 계정이 읽을 수 있는 가장 이른 공시일입니다. 그보다 이른 날이 가려져 있지 않으면 생략합니다.
trades객체 목록항상요청한 순서대로 나열한 거래입니다.
trades[].derivative항상 true선택옵션, 워런트, 전환증권 같은 파생 증권이면 true입니다.
trades[].security문자열선택공시에 적힌 증권 명칭입니다. 예: Common Stock.
trades[].ownershipone of D, I선택D는 직접 보유, I는 간접 보유입니다.
trades[].nature문자열선택간접 보유 방식이며, 공시에 적힌 그대로입니다.
trades[].underlying문자열선택파생 증권인 경우 전환 대상이 되는 증권입니다.
trades[].underlying_shares문자열선택파생 증권인 경우 기초 주식 수입니다.
trades[].exercise_price문자열선택파생 증권인 경우 행사가격 또는 전환가격입니다.
trades[].exercise_date날짜선택파생 증권인 경우 처음 행사할 수 있는 날짜입니다.
trades[].expiration_date날짜선택파생 증권인 경우 만료일입니다.
trades[].filing_id문자열항상이 행의 출처가 된 공시의 ID입니다.
trades[].formone of 3, 3/A, 4, 4/A, 5, 5/A항상행이 보고된 양식입니다. 3, 4, 5이며 정정이면 /A가 붙습니다.
trades[].filed날짜항상공시가 제출된 날입니다.
trades[].period날짜선택공시 의무를 발생시킨 사건의 날짜입니다.
trades[].owners객체 목록항상공시의 보고 소유자입니다. 공동 공시에는 여러 명이 나열됩니다.
trades[].owners[].cik문자열선택소유자의 SEC Central Index Key입니다.
trades[].owners[].id문자열선택등록처 접두어가 붙은 소유자 ID입니다. 예: usa:0001780525.
trades[].owners[].name문자열항상공시에 적힌 소유자 이름입니다.
trades[].owners[].title문자열선택공시에 적힌 임원 직함 또는 기타 관계입니다.
trades[].owners[].director항상 true선택소유자가 이사이면 true입니다.
trades[].owners[].officer항상 true선택소유자가 임원이면 true입니다.
trades[].owners[].ten_percent항상 true선택소유자가 주식의 10%를 넘게 보유하면 true입니다.
trades[].owners[].other항상 true선택소유자가 기업과 다른 관계가 있으면 true입니다.
trades[].plan_10b5_1항상 true선택양식에 Rule 10b5-1 칸이 체크되어 있으면 true입니다.
trades[].transaction_date날짜선택거래일입니다.
trades[].code문자열선택SEC 거래 코드입니다. 예: P 매수, S 매도, A 부여, M 옵션 행사, F 세금 원천징수, G 증여.
trades[].acquired_disposedone of A, D선택소유자가 주식을 취득하면 A, 처분하면 D입니다.
trades[].shares문자열선택거래된 주식 수입니다.
trades[].price문자열선택주당 가격입니다. 공시에 가격이 없으면 생략합니다.
trades[].currency문자열선택가격과 금액의 통화입니다. 생략하면 미국 달러입니다.
trades[].owned_after문자열선택거래 후 보유 주식 수입니다.
trades[].equity_swap항상 true선택제출자가 이 거래를 주식 스왑 또는 유사 상품으로 표시하면 true입니다.
trades[].amends문자열선택이 공시가 원본 하나와 정확히 일치하는 정정 공시일 때, 이 공시가 대체하는 공시입니다.
trades[].amends_unmatched항상 true선택정정 공시가 찾지 못한 원본을 가리키면 true입니다.
trades[].transaction_value문자열선택shares와 price의 곱입니다. 공시에 둘 다 있지 않으면 생략합니다.
trades[].shares_owned_before문자열선택거래 전 보유 주식 수입니다. 해당 포지션에 대한 공시 행들의 잔액이 서로 이어질 때만 제공합니다.
trades[].deemed_execution_date날짜선택거래가 실행된 것으로 간주되는 날짜이며, 공시에 있을 때만 제공합니다.
trades[].timelinessone of E, L선택제출자가 보고를 조기로 표시하면 E, 지연으로 표시하면 L입니다.
trades[].not_subject_to_section_16항상 true선택제출자가 이 거래를 Section 16 적용 대상이 아닌 것으로 표시하면 true입니다.
trades[].remarks문자열선택제출자가 양식에 적은 비고입니다.
trades[].footnoteslist of string항상행의 각주입니다. 없으면 비어 있습니다.
trades[].company_id문자열선택주식이 거래된 기업의 ID입니다. 한 기업에 한정되지 않은 목록에서 제공합니다.
trades[].issuer문자열선택주식이 거래된 기업의 이름입니다.
trades[].ticker문자열선택기업의 티커입니다.
next_cursor문자열항상다음 페이지를 읽으려면 cursor로 전달합니다. 항상 제공하며 마지막 페이지에서는 null입니다.
요청
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/insiders/0001780525/trades?limit=1"
응답 예시
{
  "id": "usa:0001780525",
  "trades": [
    {
      "security": "Common Stock",
      "ownership": "D",
      "filing_id": "usa:0000320193:0001140361-26-042149",
      "form": "4",
      "filed": "2026-11-05",
      "period": "2026-11-03",
      "owners": [
        {
          "cik": "0001780525",
          "name": "Newstead Jennifer",
          "title": "SVP, GC and Government Affairs",
          "officer": true
        }
      ],
      "plan_10b5_1": true,
      "transaction_date": "2026-11-03",
      "code": "S",
      "acquired_disposed": "D",
      "shares": "2399",
      "price": "325.75",
      "owned_after": "29997",
      "transaction_value": "781474.25",
      "shares_owned_before": "32396",
      "footnotes": [
        "This transaction was made pursuant to a Rule 10b5-1 trading plan adopted by the reporting person on May 5, 2026."
      ],
      "company_id": "usa:0000320193",
      "issuer": "Apple Inc.",
      "ticker": "AAPL"
    }
  ],
  "next_cursor": "eyJrIjoiNzk3Mzg4OTQ5OTk4…"
}

기업 전체의 내부자 거래 목록

GET /v1/insider-trades

모든 기업의 내부자 거래를 최신 공시순으로 반환합니다. 날짜를 주지 않으면 보유 중인 가장 최근 공시일과 그 전 6일을 반환합니다.

날짜가 없으면 피드는 보유 중인 가장 최근 공시일과 그 전 6일을 반환합니다. 구간을 지정하려면 filed_from과 filed_to를 함께 보내거나 filing_date를 보냅니다. 구간은 최대 31일입니다.

피드는 공시일 기준 최신순으로 정렬됩니다. 거래일 기준으로 정렬하려면 기업 하나 또는 내부자 한 명을 지정하세요.

MCP: 도구 filings_list_insider_feed.

매개변수

매개변수위치필수유형의미
filed_from쿼리아니요날짜조회 시작 공시일입니다(해당 일 포함, YYYY-MM-DD).
filed_to쿼리아니요날짜조회 종료 공시일입니다(해당 일 포함).
filing_date쿼리아니요날짜이 날 제출된 공시만 반환합니다.
filing_date_gt쿼리아니요날짜이 날 이후에 제출된 공시만 반환합니다.
filing_date_lt쿼리아니요날짜이 날 이전에 제출된 공시만 반환합니다.
transaction_date쿼리아니요날짜이 날 이루어진 거래만 반환합니다.
transaction_date_gt쿼리아니요날짜이 날 이후에 이루어진 거래만 반환합니다.
transaction_date_gte쿼리아니요날짜이 날 또는 그 이후에 이루어진 거래만 반환합니다.
transaction_date_lt쿼리아니요날짜이 날 이전에 이루어진 거래만 반환합니다.
transaction_date_lte쿼리아니요날짜이 날 또는 그 이전에 이루어진 거래만 반환합니다.
owner_cik쿼리아니요문자열이 CIK를 가진 소유자의 공시만 반환합니다. 앞의 0은 생략할 수 있습니다.
name쿼리아니요문자열이름에 이 텍스트가 포함된 소유자만 반환합니다. 대소문자를 구분하지 않으며 2~100자입니다.
transaction_code쿼리아니요문자열SEC 거래 코드가 이 한 글자인 거래만 반환합니다. 예: P 또는 S.
form_type쿼리아니요one of 3, 3/A, 4, 4/A, 5, 5/A이 양식의 거래만 반환합니다. 거래는 Form 4와 Form 5에서 가져옵니다.
sort쿼리아니요one of filing_date.desc, filing_date.asc, transaction_date.desc, transaction_date.asc목록의 정렬 순서입니다. 기본값은 filing_date.desc입니다.
cursor쿼리아니요문자열이전 페이지의 next_cursor. 다른 매개변수는 동일하게 유지합니다.
limit쿼리아니요정수페이지당 행 수입니다. 기본값 50, 최대 200입니다.
country쿼리아니요문자열등록처의 세 글자 국가 코드입니다. 생략하면 USA입니다. 이 경로가 지원하지 않는 국가는 404 not_covered입니다.

응답 필드

필드유형전송의미
id문자열선택기업 ID입니다. 내부자 한 명의 거래에서는 usa: 뒤에 내부자의 CIK를 붙인 값입니다.
filed_from날짜선택이 계정이 읽을 수 있는 가장 이른 공시일입니다. 그보다 이른 날이 가려져 있지 않으면 생략합니다.
trades객체 목록항상요청한 순서대로 나열한 거래입니다.
trades[].derivative항상 true선택옵션, 워런트, 전환증권 같은 파생 증권이면 true입니다.
trades[].security문자열선택공시에 적힌 증권 명칭입니다. 예: Common Stock.
trades[].ownershipone of D, I선택D는 직접 보유, I는 간접 보유입니다.
trades[].nature문자열선택간접 보유 방식이며, 공시에 적힌 그대로입니다.
trades[].underlying문자열선택파생 증권인 경우 전환 대상이 되는 증권입니다.
trades[].underlying_shares문자열선택파생 증권인 경우 기초 주식 수입니다.
trades[].exercise_price문자열선택파생 증권인 경우 행사가격 또는 전환가격입니다.
trades[].exercise_date날짜선택파생 증권인 경우 처음 행사할 수 있는 날짜입니다.
trades[].expiration_date날짜선택파생 증권인 경우 만료일입니다.
trades[].filing_id문자열항상이 행의 출처가 된 공시의 ID입니다.
trades[].formone of 3, 3/A, 4, 4/A, 5, 5/A항상행이 보고된 양식입니다. 3, 4, 5이며 정정이면 /A가 붙습니다.
trades[].filed날짜항상공시가 제출된 날입니다.
trades[].period날짜선택공시 의무를 발생시킨 사건의 날짜입니다.
trades[].owners객체 목록항상공시의 보고 소유자입니다. 공동 공시에는 여러 명이 나열됩니다.
trades[].owners[].cik문자열선택소유자의 SEC Central Index Key입니다.
trades[].owners[].id문자열선택등록처 접두어가 붙은 소유자 ID입니다. 예: usa:0001780525.
trades[].owners[].name문자열항상공시에 적힌 소유자 이름입니다.
trades[].owners[].title문자열선택공시에 적힌 임원 직함 또는 기타 관계입니다.
trades[].owners[].director항상 true선택소유자가 이사이면 true입니다.
trades[].owners[].officer항상 true선택소유자가 임원이면 true입니다.
trades[].owners[].ten_percent항상 true선택소유자가 주식의 10%를 넘게 보유하면 true입니다.
trades[].owners[].other항상 true선택소유자가 기업과 다른 관계가 있으면 true입니다.
trades[].plan_10b5_1항상 true선택양식에 Rule 10b5-1 칸이 체크되어 있으면 true입니다.
trades[].transaction_date날짜선택거래일입니다.
trades[].code문자열선택SEC 거래 코드입니다. 예: P 매수, S 매도, A 부여, M 옵션 행사, F 세금 원천징수, G 증여.
trades[].acquired_disposedone of A, D선택소유자가 주식을 취득하면 A, 처분하면 D입니다.
trades[].shares문자열선택거래된 주식 수입니다.
trades[].price문자열선택주당 가격입니다. 공시에 가격이 없으면 생략합니다.
trades[].currency문자열선택가격과 금액의 통화입니다. 생략하면 미국 달러입니다.
trades[].owned_after문자열선택거래 후 보유 주식 수입니다.
trades[].equity_swap항상 true선택제출자가 이 거래를 주식 스왑 또는 유사 상품으로 표시하면 true입니다.
trades[].amends문자열선택이 공시가 원본 하나와 정확히 일치하는 정정 공시일 때, 이 공시가 대체하는 공시입니다.
trades[].amends_unmatched항상 true선택정정 공시가 찾지 못한 원본을 가리키면 true입니다.
trades[].transaction_value문자열선택shares와 price의 곱입니다. 공시에 둘 다 있지 않으면 생략합니다.
trades[].shares_owned_before문자열선택거래 전 보유 주식 수입니다. 해당 포지션에 대한 공시 행들의 잔액이 서로 이어질 때만 제공합니다.
trades[].deemed_execution_date날짜선택거래가 실행된 것으로 간주되는 날짜이며, 공시에 있을 때만 제공합니다.
trades[].timelinessone of E, L선택제출자가 보고를 조기로 표시하면 E, 지연으로 표시하면 L입니다.
trades[].not_subject_to_section_16항상 true선택제출자가 이 거래를 Section 16 적용 대상이 아닌 것으로 표시하면 true입니다.
trades[].remarks문자열선택제출자가 양식에 적은 비고입니다.
trades[].footnoteslist of string항상행의 각주입니다. 없으면 비어 있습니다.
trades[].company_id문자열선택주식이 거래된 기업의 ID입니다. 한 기업에 한정되지 않은 목록에서 제공합니다.
trades[].issuer문자열선택주식이 거래된 기업의 이름입니다.
trades[].ticker문자열선택기업의 티커입니다.
next_cursor문자열항상다음 페이지를 읽으려면 cursor로 전달합니다. 항상 제공하며 마지막 페이지에서는 null입니다.
요청
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/insider-trades?transaction_code=P&limit=1"
응답 예시
{
  "trades": [
    {
      "security": "Ordinary Shares",
      "ownership": "D",
      "filing_id": "usa:0001651717:0002111999-26-000011",
      "form": "4",
      "filed": "2026-11-12",
      "period": "2026-11-09",
      "owners": [
        {
          "cik": "0002111999",
          "name": "BALDEW RUBEN",
          "title": "Chief Financial Officer",
          "director": true,
          "officer": true
        }
      ],
      "transaction_date": "2026-11-09",
      "code": "P",
      "acquired_disposed": "A",
      "shares": "8379",
      "price": "11.9538",
      "owned_after": "375551",
      "transaction_value": "100160.8902",
      "shares_owned_before": "367172",
      "footnotes": [
        "Includes 184,991 Restricted Share Units which will vest on June 17, 2027."
      ],
      "company_id": "usa:0001651717",
      "issuer": "Nomad Foods Ltd",
      "ticker": "NOMD"
    }
  ],
  "next_cursor": "eyJrIjoiNzk3Mzg4ODc5OTk3…"
}

일별 내부자 매수·매도 조회

GET /v1/insider-trades/activity

일반 주식의 장내 매수(코드 P)와 매도(코드 S)를 기업과 거래일별로 묶은 일별 합계입니다.

합계는 일반 주식의 장내 매수(코드 P)와 매도(코드 S)를 대상으로 합니다. 파생 증권은 제외합니다.

company_id를 함께 보내면 전체 이력을 요청할 수 있습니다. 보내지 않으면 filed_from과 filed_to를 7일 이내 간격으로 보내야 하며, 합계는 그 기간에 제출된 공시를 대상으로 합니다. 더 긴 구간은 400 invalid_query입니다.

purchaser_count와 seller_count는 공시마다 사람을 한 번씩 셉니다. 처음 나열된 소유자만 셉니다.

MCP: 도구 filings_get_insider_activity.

매개변수

매개변수위치필수유형의미
company_id쿼리아니요문자열이 기업만 반환합니다. 이 값을 쓰면 전체 이력을 요청할 수 있습니다.
country쿼리아니요문자열등록처의 세 글자 국가 코드입니다. 생략하면 USA입니다. 이 경로가 지원하지 않는 국가는 404 not_covered입니다.
filed_from쿼리아니요날짜조회 시작 공시일입니다(해당 일 포함, YYYY-MM-DD).
filed_to쿼리아니요날짜조회 종료 공시일입니다(해당 일 포함).
transaction_date쿼리아니요날짜이 날 이루어진 거래만 반환합니다.
transaction_date_gt쿼리아니요날짜이 날 이후에 이루어진 거래만 반환합니다.
transaction_date_gte쿼리아니요날짜이 날 또는 그 이후에 이루어진 거래만 반환합니다.
transaction_date_lt쿼리아니요날짜이 날 이전에 이루어진 거래만 반환합니다.
transaction_date_lte쿼리아니요날짜이 날 또는 그 이전에 이루어진 거래만 반환합니다.
sort쿼리아니요one of transaction_date.desc, transaction_date.asc일 정렬 순서입니다. 기본값은 transaction_date.desc입니다.
cursor쿼리아니요문자열이전 페이지의 next_cursor. 다른 매개변수는 동일하게 유지합니다.
limit쿼리아니요정수페이지당 일 수입니다. 기본값 100, 최대 1000입니다.

응답 필드

필드유형전송의미
days객체 목록항상기업과 날짜마다 한 행입니다.
days[].company_id문자열항상기업 ID입니다.
days[].currency문자열선택가격과 금액의 통화입니다. 생략하면 미국 달러입니다.
days[].issuer문자열선택주식이 거래된 기업의 이름입니다.
days[].ticker문자열선택기업의 티커입니다.
days[].transaction_date날짜항상거래일입니다.
days[].last_filing_date날짜항상이 날의 합계에 더해지는 가장 최근 공시의 날짜입니다.
days[].purchase_count정수항상장내 매수 건수입니다.
days[].purchase_shares문자열항상매수한 주식 수입니다.
days[].purchase_value문자열선택매수 금액(달러)입니다. 합산 대상 거래 중 가격이 없는 것이 있으면 생략합니다.
days[].purchaser_count정수항상매수한 사람 수이며, 공시마다 한 번씩 셉니다.
days[].sale_count정수항상장내 매도 건수입니다.
days[].sale_shares문자열항상매도한 주식 수입니다.
days[].sale_value문자열선택매도 금액(달러)입니다. 합산 대상 거래 중 가격이 없는 것이 있으면 생략합니다.
days[].seller_count정수항상매도한 사람 수이며, 공시마다 한 번씩 셉니다.
days[].net_shares문자열항상purchase_shares에서 sale_shares를 뺀 값입니다.
days[].net_value문자열선택purchase_value에서 sale_value를 뺀 값입니다.
days[].planned_purchase_value문자열선택Rule 10b5-1 칸이 체크된 양식의 매수 금액입니다. 이 칸은 양식 전체에 적용되므로 상한값입니다. 2023년 4월 1일 이전 공시에는 생략합니다.
days[].planned_sale_value문자열선택Rule 10b5-1 칸이 체크된 양식의 매도 금액입니다. 상한값입니다. 2023년 4월 1일 이전 공시에는 생략합니다.
next_cursor문자열항상다음 페이지를 읽으려면 cursor로 전달합니다. 항상 제공하며 마지막 페이지에서는 null입니다.
요청
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/insider-trades/activity?company_id=usa:0000320193&limit=1"
응답 예시
{
  "days": [
    {
      "company_id": "usa:0000320193",
      "issuer": "Apple Inc.",
      "ticker": "AAPL",
      "transaction_date": "2026-11-03",
      "last_filing_date": "2026-11-05",
      "purchase_count": 0,
      "purchase_shares": "0",
      "purchase_value": "0",
      "purchaser_count": 0,
      "sale_count": 1,
      "sale_shares": "2399",
      "sale_value": "781474.25",
      "seller_count": 1,
      "net_shares": "-2399",
      "net_value": "-781474.25",
      "planned_purchase_value": "0",
      "planned_sale_value": "781474.25"
    }
  ],
  "next_cursor": "eyJrIjoiMDAwMDMyMDE5M3wy…"
}

내부자 거래 코드 목록

GET /v1/insider-trades/transaction-codes

SEC 거래 코드의 고정 목록이며 뜻과 그룹을 함께 제공합니다. 무료: 이 경로는 요금이 부과되지 않습니다.

코드는 고정되어 있습니다. 이 목록으로 거래의 code 값을 해석하세요. 매개변수는 없습니다. 예시는 목록의 처음 네 개입니다.

MCP: 도구 filings_list_insider_transaction_codes.

매개변수

이 라우트는 파라미터가 없습니다.

응답 필드

필드유형전송의미
codes객체 목록항상거래 코드입니다.
codes[].code문자열항상한 글자 SEC 거래 코드입니다.
codes[].meaning문자열항상코드의 뜻입니다.
codes[].groupone of general, derivative, other항상general, derivative 또는 other입니다.
요청
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/insider-trades/transaction-codes"
응답 예시
{
  "codes": [
    {
      "code": "P",
      "meaning": "Open market or private purchase",
      "group": "general"
    },
    {
      "code": "S",
      "meaning": "Open market or private sale",
      "group": "general"
    },
    {
      "code": "V",
      "meaning": "Transaction voluntarily reported earlier than required",
      "group": "general"
    },
    {
      "code": "A",
      "meaning": "Grant, award or other acquisition",
      "group": "general"
    }
  ]
}

오류

오류는 공통 문제 형식을 사용하며, 다음 필드를 포함합니다: request_id. 확인 API 오류 코드와 크레딧 형식과 크레딧 헤더에 대한 설명이 있습니다. 실패한 요청에는 요금이 부과되지 않습니다.

코드상태의미
invalid_query400매개변수가 없거나, 알 수 없거나, 중복되었거나, 범위를 벗어났습니다.
invalid_cursor400이 요청이 반환한 커서가 아니거나, 다른 요청의 커서입니다.
company_not_found404ID와 일치하는 기업이 없습니다.
not_covered404해당 시장, 국가 또는 기업은 아직 제공되지 않습니다.
insufficient_credits402크레딧 잔액이 요청 비용보다 적습니다.
company_data_unavailable503이 경로의 근거 공시를 지금은 읽을 수 없습니다. 잠시 후 다시 시도하세요.

이 페이지가 도움이 되었나요?