内部人交易 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。

基础 URL： https://api.narwhalapi.com。下面每个路由都是一个独立的 MCP 工具，参数相同。

持股超过 5% 的股东见大股东页面。

公司 id 与披露文件 API 公司搜索返回的 id 相同。

每个账户可获得的内容

查看	所有账户
内部人交易，七个接口	已包含
交易代码列表	已包含，免费

查看价格了解每次调用的费用。请求按其所属 API 的价格计费，除非某个路由另有说明。

按公司价格计费。每次成功的响应计一次调用，无论返回多少行，空页同样计费。错误不计费。交易代码列表免费。
数字为十进制字符串。没有值的字段省略，列表始终存在，像 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`	路径参数	是	字符串	公司 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 的所有人的申报文件。前导零可省略。
`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[].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`	路径参数	是	字符串	公司 id，例如 `usa:0000320193`。也接受 `usa:AAPL` 这样的股票代码别名。
`filed_from`	查询参数	否	日期	起始申报日，含当天（YYYY-MM-DD）。
`filed_to`	查询参数	否	日期	截止申报日，含当天。
`filing_date`	查询参数	否	日期	仅限在这一天提交的申报文件。
`filing_date_gt`	查询参数	否	日期	仅限在这一天之后提交的申报文件。
`filing_date_lt`	查询参数	否	日期	仅限在这一天之前提交的申报文件。
`owner_cik`	查询参数	否	字符串	仅限具有此 CIK 的所有人的申报文件。前导零可省略。
`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[].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`	路径参数	是	字符串	公司 id，例如 `usa:0000320193`。也接受 `usa:AAPL` 这样的股票代码别名。
`filed_from`	查询参数	否	日期	起始申报日，含当天（YYYY-MM-DD）。
`filed_to`	查询参数	否	日期	截止申报日，含当天。
`filing_date`	查询参数	否	日期	仅限在这一天提交的申报文件。
`filing_date_gt`	查询参数	否	日期	仅限在这一天之后提交的申报文件。
`filing_date_lt`	查询参数	否	日期	仅限在这一天之前提交的申报文件。
`owner_cik`	查询参数	否	字符串	仅限具有此 CIK 的所有人的申报文件。前导零可省略。
`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[].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`	路径参数	是	字符串	公司 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，一到十位数字。
`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 的所有人的申报文件。前导零可省略。
`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[].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`	查询参数	否	日期	起始申报日，含当天（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 的所有人的申报文件。前导零可省略。
`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[].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`	查询参数	否	字符串	仅限此公司。指定后可以请求全部历史。
`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[].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"
    }
  ]
}

错误

错误使用通用的 problem 结构，并带有 request_id。查看 API 错误码与额度了解该结构和额度相关的响应头。失败的请求不计费。

代码	状态	含义
`invalid_query`	400	参数缺失、未知、重复或超出范围。
`invalid_cursor`	400	该游标不是本请求返回的，或来自另一个请求。
`company_not_found`	404	没有公司与该 id 匹配。
`not_covered`	404	尚未涵盖该市场、国家或公司。
`insufficient_credits`	402	您的额度余额低于该请求的费用。
`company_data_unavailable`	503	该接口背后的申报文件目前无法读取。请稍后重试。

此页面对你有帮助吗?