內部人交易 API 參考

來自 SEC Form 3、4 和 5 的公司內部人交易與持股

概覽

內部人交易來自 SEC 的持股表格：Form 3（初始持股）、Form 4（變動）和 Form 5（年度補報），以及其修訂件。涵蓋美國上市公司的高階主管、董事及持股 10% 以上的股東。每個請求都需要 Bearer 金鑰，REST 與 MCP 共用同一份額度餘額。

八個路由涵蓋單一公司的交易、持股、持股申報與內部人，單一內部人跨公司的交易，涵蓋所有公司的交易清單，每日買賣合計，以及交易代碼清單。公司以其 Filings API 的 ID 指定，例如 usa:0000320193。內部人以其本身的 CIK 指定。

歷史資料從 2021 年 10 月的申報文件開始。新的申報文件每 2 分鐘從 SEC 讀取一次。

僅涵蓋美國。其他國家回傳 404 not_covered。

基礎網址： https://api.narwhalapi.com。下列每條路由都是各自獨立的 MCP 工具，參數相同。

持股超過 5% 的持有人請見大額持股人頁面。

公司 ID 即為申報文件 API 公司搜尋所回傳的 ID。

每個帳戶都能取得的內容

費用	所有帳戶
內部人交易，七個路由	已包含
交易代碼清單	已包含，免費

查看定價說明每次呼叫的費用。除非路由另有說明，請求依其所屬 API 的價格計費。

依 Companies 價格計費。每次成功回應計為一次呼叫，與資料列數無關，空白頁面也會計費。錯誤不計費。交易代碼清單免費。
數字為十進位字串。沒有值的欄位會省略，清單一律存在，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

公司內部人（高階主管、董事及持股 10% 以上的股東）在 Form 4 和 Form 5 中申報的所有公司股票交易，依申報日由新到舊排列。衍生性交易（選擇權、認股權證、可轉換證券）也包含在內，並帶有 derivative。

交易來自 Form 4 和 Form 5。form_type 為 3 或 3/A 時回傳空清單。

預設排序為申報日，由新到舊。傳入 sort=transaction_date.asc 可依交易順序讀取。

MCP：工具 filings_list_insider_trades。

參數

參數	位置	必填	類型	含義
`company_id`	path	是	字串	公司 ID，例如 `usa:0000320193`。也接受股票代號別名，例如 `usa:AAPL`。
`filed_from`	query	否	日期	起始申報日（含），格式為 YYYY-MM-DD。
`filed_to`	query	否	日期	結束申報日（含）。
`filing_date`	query	否	日期	僅限在這一天提交的申報文件。
`filing_date_gt`	query	否	日期	僅限在這一天之後提交的申報文件。
`filing_date_lt`	query	否	日期	僅限在這一天之前提交的申報文件。
`transaction_date`	query	否	日期	僅限在這一天發生的交易。
`transaction_date_gt`	query	否	日期	僅限在這一天之後發生的交易。
`transaction_date_gte`	query	否	日期	僅限在這一天或之後發生的交易。
`transaction_date_lt`	query	否	日期	僅限在這一天之前發生的交易。
`transaction_date_lte`	query	否	日期	僅限在這一天或之前發生的交易。
`owner_cik`	query	否	字串	僅限此 CIK 所屬持有人的申報文件。開頭的 0 可省略。
`name`	query	否	字串	僅限名稱包含此文字的持有人。不分大小寫，長度為 2 至 100 個字元。
`transaction_code`	query	否	字串	僅限使用此 SEC 單字母交易代碼的交易，例如 `P` 或 `S`。
`form_type`	query	否	one of 3, 3/A, 4, 4/A, 5, 5/A	僅限此表格上的交易。交易來自 Form 4 和 Form 5。
`sort`	query	否	one of filing_date.desc, filing_date.asc, transaction_date.desc, transaction_date.asc	清單的排序方式。預設為 `filing_date.desc`。
`cursor`	query	否	字串	上一頁的 `next_cursor`，其他參數須與上一頁相同。
`limit`	query	否	整數	每頁資料列數。預設為 50，最多 200。

回應欄位

欄位	類型	傳送	含義
`id`	字串	固定回傳	公司 ID。在單一內部人的交易中，為 `usa:` 加上該內部人的 CIK。
`filed_from`	日期	選填	此帳戶可讀取的最早申報日。若沒有被隱藏的更早日期則省略。
`trades`	物件陣列	固定回傳	交易清單，依請求的順序排列。
`trades[].derivative`	一律為 true	選填	當此資料列為衍生性證券（例如選擇權、認股權證或可轉換證券）時為 true。
`trades[].security`	字串	選填	證券名稱，依申報原文，例如 Common Stock。
`trades[].ownership`	one 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[].form`	one 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_disposed`	one 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[].timeliness`	one of E, L	選填	申報人將報告標記為提早申報時為 `E`，遲交時為 `L`。
`trades[].not_subject_to_section_16`	一律為 true	選填	申報人將此交易標記為不受 Section 16 規範時為 true。
`trades[].remarks`	字串	選填	申報人在表格上填寫的備註。
`trades[].footnotes`	list 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`	path	是	字串	公司 ID，例如 `usa:0000320193`。也接受股票代號別名，例如 `usa:AAPL`。
`filed_from`	query	否	日期	起始申報日（含），格式為 YYYY-MM-DD。
`filed_to`	query	否	日期	結束申報日（含）。
`filing_date`	query	否	日期	僅限在這一天提交的申報文件。
`filing_date_gt`	query	否	日期	僅限在這一天之後提交的申報文件。
`filing_date_lt`	query	否	日期	僅限在這一天之前提交的申報文件。
`owner_cik`	query	否	字串	僅限此 CIK 所屬持有人的申報文件。開頭的 0 可省略。
`name`	query	否	字串	僅限名稱包含此文字的持有人。不分大小寫，長度為 2 至 100 個字元。
`form_type`	query	否	one of 3, 3/A, 4, 4/A, 5, 5/A	僅限此表格上的申報文件。
`cursor`	query	否	字串	上一頁的 `next_cursor`，其他參數須與上一頁相同。
`limit`	query	否	整數	每頁資料列數。預設為 100，最多 500。

回應欄位

欄位	類型	傳送	含義
`id`	字串	固定回傳	公司 ID。在單一內部人的交易中，為 `usa:` 加上該內部人的 CIK。
`filed_from`	日期	選填	此帳戶可讀取的最早申報日。若沒有被隱藏的更早日期則省略。
`positions`	物件陣列	固定回傳	每位持有人在每種證券的最新持股。
`positions[].derivative`	一律為 true	選填	當此資料列為衍生性證券（例如選擇權、認股權證或可轉換證券）時為 true。
`positions[].security`	字串	選填	證券名稱，依申報原文，例如 Common Stock。
`positions[].ownership`	one 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[].form`	one 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`	path	是	字串	公司 ID，例如 `usa:0000320193`。也接受股票代號別名，例如 `usa:AAPL`。
`filed_from`	query	否	日期	起始申報日（含），格式為 YYYY-MM-DD。
`filed_to`	query	否	日期	結束申報日（含）。
`filing_date`	query	否	日期	僅限在這一天提交的申報文件。
`filing_date_gt`	query	否	日期	僅限在這一天之後提交的申報文件。
`filing_date_lt`	query	否	日期	僅限在這一天之前提交的申報文件。
`owner_cik`	query	否	字串	僅限此 CIK 所屬持有人的申報文件。開頭的 0 可省略。
`name`	query	否	字串	僅限名稱包含此文字的持有人。不分大小寫，長度為 2 至 100 個字元。
`form_type`	query	否	one of 3, 3/A, 4, 4/A, 5, 5/A	僅限此表格上的申報：`3`、`3/A`、`5` 或 `5/A`。
`cursor`	query	否	字串	上一頁的 `next_cursor`，其他參數須與上一頁相同。
`limit`	query	否	整數	每頁資料列數。預設為 100，最多 500。

回應欄位

欄位	類型	傳送	含義
`id`	字串	固定回傳	公司 ID。在單一內部人的交易中，為 `usa:` 加上該內部人的 CIK。
`statements`	物件陣列	固定回傳	申報清單，由新到舊排列。
`statements[].derivative`	一律為 true	選填	當此資料列為衍生性證券（例如選擇權、認股權證或可轉換證券）時為 true。
`statements[].security`	字串	選填	證券名稱，依申報原文，例如 Common Stock。
`statements[].ownership`	one 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[].form`	one 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`	path	是	字串	公司 ID，例如 `usa:0000320193`。也接受股票代號別名，例如 `usa:AAPL`。
`name`	query	否	字串	僅限名稱包含此文字的持有人。不分大小寫，長度為 2 至 100 個字元。
`cursor`	query	否	字串	上一頁的 `next_cursor`，其他參數須與上一頁相同。
`limit`	query	否	整數	每頁資料列數。預設為 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`	path	是	字串	內部人本身的 CIK，一至十位數字。
`filed_from`	query	否	日期	起始申報日（含），格式為 YYYY-MM-DD。
`filed_to`	query	否	日期	結束申報日（含）。
`filing_date`	query	否	日期	僅限在這一天提交的申報文件。
`filing_date_gt`	query	否	日期	僅限在這一天之後提交的申報文件。
`filing_date_lt`	query	否	日期	僅限在這一天之前提交的申報文件。
`transaction_date`	query	否	日期	僅限在這一天發生的交易。
`transaction_date_gt`	query	否	日期	僅限在這一天之後發生的交易。
`transaction_date_gte`	query	否	日期	僅限在這一天或之後發生的交易。
`transaction_date_lt`	query	否	日期	僅限在這一天之前發生的交易。
`transaction_date_lte`	query	否	日期	僅限在這一天或之前發生的交易。
`owner_cik`	query	否	字串	僅限此 CIK 所屬持有人的申報文件。開頭的 0 可省略。
`name`	query	否	字串	僅限名稱包含此文字的持有人。不分大小寫，長度為 2 至 100 個字元。
`transaction_code`	query	否	字串	僅限使用此 SEC 單字母交易代碼的交易，例如 `P` 或 `S`。
`form_type`	query	否	one of 3, 3/A, 4, 4/A, 5, 5/A	僅限此表格上的交易。交易來自 Form 4 和 Form 5。
`sort`	query	否	one of filing_date.desc, filing_date.asc, transaction_date.desc, transaction_date.asc	清單的排序方式。預設為 `filing_date.desc`。
`cursor`	query	否	字串	上一頁的 `next_cursor`，其他參數須與上一頁相同。
`limit`	query	否	整數	每頁資料列數。預設為 50，最多 200。

回應欄位

欄位	類型	傳送	含義
`id`	字串	選填	公司 ID。在單一內部人的交易中，為 `usa:` 加上該內部人的 CIK。
`filed_from`	日期	選填	此帳戶可讀取的最早申報日。若沒有被隱藏的更早日期則省略。
`trades`	物件陣列	固定回傳	交易清單，依請求的順序排列。
`trades[].derivative`	一律為 true	選填	當此資料列為衍生性證券（例如選擇權、認股權證或可轉換證券）時為 true。
`trades[].security`	字串	選填	證券名稱，依申報原文，例如 Common Stock。
`trades[].ownership`	one 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[].form`	one 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_disposed`	one 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[].timeliness`	one of E, L	選填	申報人將報告標記為提早申報時為 `E`，遲交時為 `L`。
`trades[].not_subject_to_section_16`	一律為 true	選填	申報人將此交易標記為不受 Section 16 規範時為 true。
`trades[].remarks`	字串	選填	申報人在表格上填寫的備註。
`trades[].footnotes`	list 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

所有公司的內部人交易，依申報日由新到舊排列。未指定日期時，回傳我們持有的最新申報日及其前六天。

未指定日期時，清單回傳我們持有的最新申報日及其前六天。指定區間時，請傳入 filed_from 搭配 filed_to，或傳入 filing_date。區間最長涵蓋 31 天。

清單依申報日排序，由新到舊。若要依交易日排序，請指定單一公司或單一內部人。

MCP：工具 filings_list_insider_feed。

參數

參數	位置	必填	類型	含義
`filed_from`	query	否	日期	起始申報日（含），格式為 YYYY-MM-DD。
`filed_to`	query	否	日期	結束申報日（含）。
`filing_date`	query	否	日期	僅限在這一天提交的申報文件。
`filing_date_gt`	query	否	日期	僅限在這一天之後提交的申報文件。
`filing_date_lt`	query	否	日期	僅限在這一天之前提交的申報文件。
`transaction_date`	query	否	日期	僅限在這一天發生的交易。
`transaction_date_gt`	query	否	日期	僅限在這一天之後發生的交易。
`transaction_date_gte`	query	否	日期	僅限在這一天或之後發生的交易。
`transaction_date_lt`	query	否	日期	僅限在這一天之前發生的交易。
`transaction_date_lte`	query	否	日期	僅限在這一天或之前發生的交易。
`owner_cik`	query	否	字串	僅限此 CIK 所屬持有人的申報文件。開頭的 0 可省略。
`name`	query	否	字串	僅限名稱包含此文字的持有人。不分大小寫，長度為 2 至 100 個字元。
`transaction_code`	query	否	字串	僅限使用此 SEC 單字母交易代碼的交易，例如 `P` 或 `S`。
`form_type`	query	否	one of 3, 3/A, 4, 4/A, 5, 5/A	僅限此表格上的交易。交易來自 Form 4 和 Form 5。
`sort`	query	否	one of filing_date.desc, filing_date.asc, transaction_date.desc, transaction_date.asc	清單的排序方式。預設為 `filing_date.desc`。
`cursor`	query	否	字串	上一頁的 `next_cursor`，其他參數須與上一頁相同。
`limit`	query	否	整數	每頁資料列數。預設為 50，最多 200。
`country`	query	否	字串	登記機關的三字母國家代碼。省略表示美國。路由未涵蓋的國家回傳 404 not_covered。

回應欄位

欄位	類型	傳送	含義
`id`	字串	選填	公司 ID。在單一內部人的交易中，為 `usa:` 加上該內部人的 CIK。
`filed_from`	日期	選填	此帳戶可讀取的最早申報日。若沒有被隱藏的更早日期則省略。
`trades`	物件陣列	固定回傳	交易清單，依請求的順序排列。
`trades[].derivative`	一律為 true	選填	當此資料列為衍生性證券（例如選擇權、認股權證或可轉換證券）時為 true。
`trades[].security`	字串	選填	證券名稱，依申報原文，例如 Common Stock。
`trades[].ownership`	one 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[].form`	one 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_disposed`	one 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[].timeliness`	one of E, L	選填	申報人將報告標記為提早申報時為 `E`，遲交時為 `L`。
`trades[].not_subject_to_section_16`	一律為 true	選填	申報人將此交易標記為不受 Section 16 規範時為 true。
`trades[].remarks`	字串	選填	申報人在表格上填寫的備註。
`trades[].footnotes`	list 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 後可請求完整歷史資料。未指定時，請傳入相隔不超過 7 天的 filed_from 和 filed_to，合計涵蓋這幾天提交的申報文件。區間更長時回傳 400 invalid_query。

purchaser_count 和 seller_count 每份申報計一次人數。只計列在第一位的持有人。

MCP：工具 filings_get_insider_activity。

參數

參數	位置	必填	類型	含義
`company_id`	query	否	字串	僅限此公司。指定後可請求完整歷史資料。
`country`	query	否	字串	登記機關的三字母國家代碼。省略表示美國。路由未涵蓋的國家回傳 404 not_covered。
`filed_from`	query	否	日期	起始申報日（含），格式為 YYYY-MM-DD。
`filed_to`	query	否	日期	結束申報日（含）。
`transaction_date`	query	否	日期	僅限在這一天發生的交易。
`transaction_date_gt`	query	否	日期	僅限在這一天之後發生的交易。
`transaction_date_gte`	query	否	日期	僅限在這一天或之後發生的交易。
`transaction_date_lt`	query	否	日期	僅限在這一天之前發生的交易。
`transaction_date_lte`	query	否	日期	僅限在這一天或之前發生的交易。
`sort`	query	否	one of transaction_date.desc, transaction_date.asc	日期的排序方式。預設為 `transaction_date.desc`。
`cursor`	query	否	字串	上一頁的 `next_cursor`，其他參數須與上一頁相同。
`limit`	query	否	整數	每頁天數。預設為 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[].group`	one 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_query`	400	參數缺漏、未知、重複，或超出範圍。
`invalid_cursor`	400	此游標不是這個請求所回傳的，或來自不同的請求。
`company_not_found`	404	沒有公司符合此 ID。
`not_covered`	404	尚未支援此市場、國家或公司。
`insufficient_credits`	402	您的額度餘額不足以支付此請求的費用。
`company_data_unavailable`	503	這個路由背後的申報文件目前無法讀取。請稍後再試。

此頁面對你有幫助嗎?