インサイダー取引APIリファレンス
SECのForm 3、4、5に基づく、企業インサイダーの取引と保有
概要
インサイダー取引は、SECの所有に関するフォームに基づきます:Form 3(初回の保有)、Form 4(変更)、Form 5(年次の補完)、およびそれらの修正。対象は米国上場企業の役員、取締役、10%保有者です。すべてのリクエストにBearerキーが必要で、RESTとMCPは1つのクレジット残高を共有します。
8つのルートで、1社の取引、保有、保有報告書、インサイダー、1人のインサイダーの企業横断の取引、全企業の取引フィード、日次の売買合計、取引コードの一覧を取得できます。企業はFilings APIのID(例:usa:0000320193)で指定します。インサイダーは本人のCIKで指定します。
履歴は2021年10月の提出書類から始まります。新しい提出書類は2分ごとにSECから読み取ります。
対応しているのは米国のみです。他の国は404 not_です。
ベースURL: https:/。 以下の各ルートは、同じパラメータを持つ独立したMCPツールです。
5%超の保有者は次にあります: 大量保有者のページ。
企業IDは次が返すものです: 開示書類 API 企業検索から返されます。
すべてのアカウントで利用できるもの
| 課金額 | すべてのアカウント |
|---|---|
| インサイダー取引、7ルート | 含まれる |
| 取引コード一覧 | 含まれる、無料 |
参照: 料金表 で、呼び出し1回の料金を確認できます。ルートに別の記載がない限り、リクエストはそのAPIの料金で課金されます。
- Companies料金で課金されます。成功した各レスポンスは、行数に関係なく1回の呼び出しです。空のページも課金されます。エラーは課金されません。取引コード一覧は無料です。
- 数値は小数文字列です。値のないフィールドは省略され、リストは常に存在し、
officerのようなフラグはtrueの場合だけ返されます。 - 取引価格は1株あたりで、提出書類に記載がない場合は省略されます。
transaction_とvalue shares_は、元になる数値が提出書類にある場合だけ算出されます。owned_ before - Rule 10b5-1のボックスはフォーム全体で1つのチェックです。
plan_は、そのフォームのすべての取引でtrueになります。提出者が計画に基づいて行わなかった取引も含みます。10b5_ 1 - 元の書類がちょうど1件に一致した修正は、
amendsでそれを示します。見つからなかった元の書類を指す場合、amends_がtrueになり、両方の行がリストに残ります。unmatched - 親会社など他の事業体を通じてのみ報告する保有者は、株数の合計なしで一覧に載ります。株数が保有されていない場合、
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_が3または3/の場合は空のリストを返します。
デフォルトの並び順は提出日の新しい順です。取引日順に読むにはsort=transaction_を送ります。
MCP: ツール filings_。
パラメータ
| パラメータ | 場所 | 必須 | 種別 | 意味 |
|---|---|---|---|---|
company_ | パス | はい | 文字列 | 企業ID。例:usa:0000320193。usa:AAPLのようなティッカー別名も使えます。 |
filed_ | クエリ | いいえ | 日付 | 最初の提出日(その日を含む)(YYYY-MM-DD)。 |
filed_ | クエリ | いいえ | 日付 | 最後の提出日(その日を含む)。 |
filing_ | クエリ | いいえ | 日付 | この日に提出されたものだけ。 |
filing_ | クエリ | いいえ | 日付 | この日より後に提出されたものだけ。 |
filing_ | クエリ | いいえ | 日付 | この日より前に提出されたものだけ。 |
transaction_ | クエリ | いいえ | 日付 | この日に行われた取引だけ。 |
transaction_ | クエリ | いいえ | 日付 | この日より後に行われた取引だけ。 |
transaction_ | クエリ | いいえ | 日付 | この日以降に行われた取引だけ。 |
transaction_ | クエリ | いいえ | 日付 | この日より前に行われた取引だけ。 |
transaction_ | クエリ | いいえ | 日付 | この日以前に行われた取引だけ。 |
owner_ | クエリ | いいえ | 文字列 | このCIKを持つ保有者の提出書類だけ。先頭のゼロは省略できます。 |
name | クエリ | いいえ | 文字列 | 名前にこのテキストを含む保有者だけ。大文字と小文字を区別せず、2〜100文字。 |
transaction_ | クエリ | いいえ | 文字列 | このSECの1文字の取引コードを持つ取引だけ。例:PまたはS。 |
form_ | クエリ | いいえ | 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_。 |
cursor | クエリ | いいえ | 文字列 | 前のページの next_。ほかのパラメータは同じ値にします。 |
limit | クエリ | いいえ | 整数 | 1ページあたりの行数。デフォルトは50、最大200。 |
レスポンスフィールド
| フィールド | 種別 | 送信 | 意味 |
|---|---|---|---|
id | 文字列 | 常に | 企業ID。インサイダー1人の取引では、usa:とそのインサイダーのCIK。 |
filed_ | 日付 | 任意 | このアカウントが読める最も古い提出日。それより前に隠れている日がない場合は省略されます。 |
trades | オブジェクトの配列 | 常に | リクエストした順の取引。 |
trades[].derivative | 常に true | 任意 | その行がオプション、ワラント、転換証券などのデリバティブ証券である場合はtrue。 |
trades[].security | 文字列 | 任意 | 証券の名称(提出書類の記載どおり)。例:Common Stock。 |
trades[].ownership | one of D, I | 任意 | 直接保有はD、間接保有はI。 |
trades[].nature | 文字列 | 任意 | 間接保有の保有形態(提出書類の記載どおり)。 |
trades[].underlying | 文字列 | 任意 | デリバティブの場合、転換先の証券。 |
trades[].underlying_ | 文字列 | 任意 | デリバティブの場合、原資産の株数。 |
trades[].exercise_ | 文字列 | 任意 | デリバティブの場合、権利行使価格または転換価格。 |
trades[].exercise_ | 日付 | 任意 | デリバティブの場合、最初に権利行使できる日。 |
trades[].expiration_ | 日付 | 任意 | デリバティブの場合、失効日。 |
trades[].filing_ | 文字列 | 常に | その行の元となる提出書類のID。 |
trades[].form | one of 3, 3/A, 4, 4/A, 5, 5/A | 常に | その行が報告されたフォーム:3、4、5。修正の場合は/が付きます。 |
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_ | 常に true | 任意 | 報告者が株式の10%超を保有している場合はtrue。 |
trades[].owners[].other | 常に true | 任意 | 報告者が企業とその他の関係を持つ場合はtrue。 |
trades[].plan_ | 常に true | 任意 | フォームでRule 10b5-1のボックスにチェックが付いている場合はtrue。 |
trades[].transaction_ | 日付 | 任意 | 取引日。 |
trades[].code | 文字列 | 任意 | SECの取引コード。例:P購入、S売却、A付与、Mオプション行使、F源泉徴収、G贈与。 |
trades[].acquired_ | one of A, D | 任意 | 報告者が株式を取得した場合はA、処分した場合はD。 |
trades[].shares | 文字列 | 任意 | 取引の株数。 |
trades[].price | 文字列 | 任意 | 1株あたりの価格。提出書類に記載がない場合は省略されます。 |
trades[].currency | 文字列 | 任意 | 価格と金額の通貨。省略は米ドルを意味します。 |
trades[].owned_ | 文字列 | 任意 | 取引後に保有している株数。 |
trades[].equity_ | 常に true | 任意 | 提出者がその取引をエクイティスワップまたは類似の商品として示した場合はtrue。 |
trades[].amends | 文字列 | 任意 | この提出書類が置き換える提出書類。元の書類がちょうど1件に一致した修正の場合です。 |
trades[].amends_ | 常に true | 任意 | 修正が、見つからなかった元の書類を指している場合はtrue。 |
trades[].transaction_ | 文字列 | 任意 | sharesにpriceを掛けた値。提出書類に両方がある場合だけ返されます。 |
trades[].shares_ | 文字列 | 任意 | 取引前に保有していた株数。そのポジションについて、提出書類の各行の残高が順につながる場合だけ返されます。 |
trades[].deemed_ | 日付 | 任意 | 取引が約定したとみなされた日付。提出書類に記載がある場合。 |
trades[].timeliness | one of E, L | 任意 | 提出者が報告を早期と示した場合はE、遅延と示した場合はL。 |
trades[].not_ | 常に true | 任意 | 提出者がその取引を第16条の対象外と示した場合はtrue。 |
trades[].remarks | 文字列 | 任意 | 提出者がフォームに書いた備考。 |
trades[].footnotes | list of string | 常に | その行の脚注。ない場合は空。 |
trades[].company_ | 文字列 | 任意 | 株式が取引された企業のID。1社に限らない一覧で返されます。 |
trades[].issuer | 文字列 | 任意 | 株式が取引された企業の名前。 |
trades[].ticker | 文字列 | 任意 | 企業のティッカー。 |
next_ | 文字列 | 常に | 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や年次の保有報告のうち、最後に提出されたもの。
所有者とセキュリティごとに1行:最新の残高。sharesは保有量で、提出書類がドルで示している場合はvalueです。as_は、その取引の日付またはその保有の提出日です。
MCP: ツール filings_。
パラメータ
| パラメータ | 場所 | 必須 | 種別 | 意味 |
|---|---|---|---|---|
company_ | パス | はい | 文字列 | 企業ID。例:usa:0000320193。usa:AAPLのようなティッカー別名も使えます。 |
filed_ | クエリ | いいえ | 日付 | 最初の提出日(その日を含む)(YYYY-MM-DD)。 |
filed_ | クエリ | いいえ | 日付 | 最後の提出日(その日を含む)。 |
filing_ | クエリ | いいえ | 日付 | この日に提出されたものだけ。 |
filing_ | クエリ | いいえ | 日付 | この日より後に提出されたものだけ。 |
filing_ | クエリ | いいえ | 日付 | この日より前に提出されたものだけ。 |
owner_ | クエリ | いいえ | 文字列 | このCIKを持つ保有者の提出書類だけ。先頭のゼロは省略できます。 |
name | クエリ | いいえ | 文字列 | 名前にこのテキストを含む保有者だけ。大文字と小文字を区別せず、2〜100文字。 |
form_ | クエリ | いいえ | one of 3, 3/A, 4, 4/A, 5, 5/A | このフォームの提出書類だけ。 |
cursor | クエリ | いいえ | 文字列 | 前のページの next_。ほかのパラメータは同じ値にします。 |
limit | クエリ | いいえ | 整数 | 1ページあたりの行数。デフォルトは100、最大500。 |
レスポンスフィールド
| フィールド | 種別 | 送信 | 意味 |
|---|---|---|---|
id | 文字列 | 常に | 企業ID。インサイダー1人の取引では、usa:とそのインサイダーのCIK。 |
filed_ | 日付 | 任意 | このアカウントが読める最も古い提出日。それより前に隠れている日がない場合は省略されます。 |
positions | オブジェクトの配列 | 常に | 各保有者の各証券における最新の保有。 |
positions[].derivative | 常に true | 任意 | その行がオプション、ワラント、転換証券などのデリバティブ証券である場合はtrue。 |
positions[].security | 文字列 | 任意 | 証券の名称(提出書類の記載どおり)。例:Common Stock。 |
positions[].ownership | one of D, I | 任意 | 直接保有はD、間接保有はI。 |
positions[].nature | 文字列 | 任意 | 間接保有の保有形態(提出書類の記載どおり)。 |
positions[].underlying | 文字列 | 任意 | デリバティブの場合、転換先の証券。 |
positions[].underlying_ | 文字列 | 任意 | デリバティブの場合、原資産の株数。 |
positions[].exercise_ | 文字列 | 任意 | デリバティブの場合、権利行使価格または転換価格。 |
positions[].exercise_ | 日付 | 任意 | デリバティブの場合、最初に権利行使できる日。 |
positions[].expiration_ | 日付 | 任意 | デリバティブの場合、失効日。 |
positions[].filing_ | 文字列 | 常に | その行の元となる提出書類のID。 |
positions[].form | one of 3, 3/A, 4, 4/A, 5, 5/A | 常に | その行が報告されたフォーム:3、4、5。修正の場合は/が付きます。 |
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_ | 常に true | 任意 | 報告者が株式の10%超を保有している場合はtrue。 |
positions[].owners[].other | 常に true | 任意 | 報告者が企業とその他の関係を持つ場合はtrue。 |
positions[].as_ | 日付 | 常に | 取引日、またはこの残高を示す保有報告の提出日。 |
positions[].shares | 文字列 | 任意 | 保有量(株数)。 |
positions[].value | 文字列 | 任意 | 保有金額(ドル)。提出書類が株数ではなく金額を報告している場合。 |
positions[].currency | 文字列 | 任意 | 価格と金額の通貨。省略は米ドルを意味します。 |
next_ | 文字列 | 常に | 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_は3、3/、5、5/を受け付け、他のフォームは400 invalid_です。
MCP: ツール filings_。
パラメータ
| パラメータ | 場所 | 必須 | 種別 | 意味 |
|---|---|---|---|---|
company_ | パス | はい | 文字列 | 企業ID。例:usa:0000320193。usa:AAPLのようなティッカー別名も使えます。 |
filed_ | クエリ | いいえ | 日付 | 最初の提出日(その日を含む)(YYYY-MM-DD)。 |
filed_ | クエリ | いいえ | 日付 | 最後の提出日(その日を含む)。 |
filing_ | クエリ | いいえ | 日付 | この日に提出されたものだけ。 |
filing_ | クエリ | いいえ | 日付 | この日より後に提出されたものだけ。 |
filing_ | クエリ | いいえ | 日付 | この日より前に提出されたものだけ。 |
owner_ | クエリ | いいえ | 文字列 | このCIKを持つ保有者の提出書類だけ。先頭のゼロは省略できます。 |
name | クエリ | いいえ | 文字列 | 名前にこのテキストを含む保有者だけ。大文字と小文字を区別せず、2〜100文字。 |
form_ | クエリ | いいえ | one of 3, 3/A, 4, 4/A, 5, 5/A | このフォームの報告書だけ:3、3/、5、5/。 |
cursor | クエリ | いいえ | 文字列 | 前のページの next_。ほかのパラメータは同じ値にします。 |
limit | クエリ | いいえ | 整数 | 1ページあたりの行数。デフォルトは100、最大500。 |
レスポンスフィールド
| フィールド | 種別 | 送信 | 意味 |
|---|---|---|---|
id | 文字列 | 常に | 企業ID。インサイダー1人の取引では、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_ | 文字列 | 任意 | デリバティブの場合、原資産の株数。 |
statements[].exercise_ | 文字列 | 任意 | デリバティブの場合、権利行使価格または転換価格。 |
statements[].exercise_ | 日付 | 任意 | デリバティブの場合、最初に権利行使できる日。 |
statements[].expiration_ | 日付 | 任意 | デリバティブの場合、失効日。 |
statements[].filing_ | 文字列 | 常に | その行の元となる提出書類のID。 |
statements[].form | one of 3, 3/A, 4, 4/A, 5, 5/A | 常に | その行が報告されたフォーム:3、4、5。修正の場合は/が付きます。 |
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_ | 常に true | 任意 | 報告者が株式の10%超を保有している場合はtrue。 |
statements[].owners[].other | 常に true | 任意 | 報告者が企業とその他の関係を持つ場合はtrue。 |
statements[].as_ | 日付 | 常に | 取引日、またはこの残高を示す保有報告の提出日。 |
statements[].shares | 文字列 | 任意 | 保有量(株数)。 |
statements[].value | 文字列 | 任意 | 保有金額(ドル)。提出書類が株数ではなく金額を報告している場合。 |
statements[].currency | 文字列 | 任意 | 価格と金額の通貨。省略は米ドルを意味します。 |
next_ | 文字列 | 常に | 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_とshares_は、通常株式の各ポジションの最新残高を合算します。デリバティブは除きます。複数の保有者が共同で報告するポジションは、それぞれに数えられます。
MCP: ツール filings_。
パラメータ
| パラメータ | 場所 | 必須 | 種別 | 意味 |
|---|---|---|---|---|
company_ | パス | はい | 文字列 | 企業ID。例:usa:0000320193。usa:AAPLのようなティッカー別名も使えます。 |
name | クエリ | いいえ | 文字列 | 名前にこのテキストを含む保有者だけ。大文字と小文字を区別せず、2〜100文字。 |
cursor | クエリ | いいえ | 文字列 | 前のページの next_。ほかのパラメータは同じ値にします。 |
limit | クエリ | いいえ | 整数 | 1ページあたりの行数。デフォルトは100、最大500。 |
レスポンスフィールド
| フィールド | 種別 | 送信 | 意味 |
|---|---|---|---|
id | 文字列 | 常に | 企業ID。インサイダー1人の取引では、usa:とそのインサイダーのCIK。 |
insiders | オブジェクトの配列 | 常に | 企業のインサイダー。 |
insiders[].owner_ | 文字列 | 任意 | インサイダーのSEC Central Index Key。 |
insiders[].owner_ | 文字列 | 任意 | レジストリ付きのインサイダーID。 |
insiders[].name | 文字列 | 常に | 報告者の名前(提出書類の記載どおり)。 |
insiders[].title | 文字列 | 任意 | 役職またはその他の関係(提出書類の記載どおり)。 |
insiders[].director | 常に true | 任意 | 報告者が取締役である場合はtrue。 |
insiders[].officer | 常に true | 任意 | 報告者が役員である場合はtrue。 |
insiders[].ten_ | 常に true | 任意 | 報告者が株式の10%超を保有している場合はtrue。 |
insiders[].other | 常に true | 任意 | 報告者が企業とその他の関係を持つ場合はtrue。 |
insiders[].first_ | 日付 | 常に | このインサイダーがこの企業について最初に提出した日。 |
insiders[].last_ | 日付 | 常に | このインサイダーがこの企業について最後に提出した日。 |
insiders[].filing_ | 整数 | 常に | このインサイダーがこの企業について行った提出の件数。 |
insiders[].position_ | 整数 | 常に | このインサイダーが報告したポジションの数。 |
insiders[].shares_ | 文字列 | 任意 | 通常株式の各ポジションの最新残高の合計。株式残高を一度も報告していないインサイダーでは省略されます。 |
insiders[].shares_ | 文字列 | 任意 | shares_のうち直接保有している分。 |
insiders[].shares_ | 文字列 | 任意 | shares_のうち間接保有している分。 |
insiders[].ownership_ | 文字列 | 任意 | shares_を、企業の最新の報告済み発行済み株式数に対する割合(%)で示した値。不明な場合、結果が100を超える場合、企業に複数の種類株式がある場合は省略されます。 |
insiders[].outstanding_ | 日付 | 任意 | ownership_の元になった発行済み株式数の日付。 |
next_ | 文字列 | 常に | 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…"
}インサイダー1人の取引を一覧表示
GET /v1/insiders/{cik}/trades
インサイダー1人が企業をまたいで提出したすべての取引。提出が新しい順です。cikはそのインサイダー自身のCIKです。
答えのidはusa:とインサイダーのCIKです。行は企業ルートと同じで、company_、issuer、tickerが加わります。
MCP: ツール filings_。
パラメータ
| パラメータ | 場所 | 必須 | 種別 | 意味 |
|---|---|---|---|---|
cik | パス | はい | 文字列 | インサイダー自身のCIK。1〜10桁。 |
filed_ | クエリ | いいえ | 日付 | 最初の提出日(その日を含む)(YYYY-MM-DD)。 |
filed_ | クエリ | いいえ | 日付 | 最後の提出日(その日を含む)。 |
filing_ | クエリ | いいえ | 日付 | この日に提出されたものだけ。 |
filing_ | クエリ | いいえ | 日付 | この日より後に提出されたものだけ。 |
filing_ | クエリ | いいえ | 日付 | この日より前に提出されたものだけ。 |
transaction_ | クエリ | いいえ | 日付 | この日に行われた取引だけ。 |
transaction_ | クエリ | いいえ | 日付 | この日より後に行われた取引だけ。 |
transaction_ | クエリ | いいえ | 日付 | この日以降に行われた取引だけ。 |
transaction_ | クエリ | いいえ | 日付 | この日より前に行われた取引だけ。 |
transaction_ | クエリ | いいえ | 日付 | この日以前に行われた取引だけ。 |
owner_ | クエリ | いいえ | 文字列 | このCIKを持つ保有者の提出書類だけ。先頭のゼロは省略できます。 |
name | クエリ | いいえ | 文字列 | 名前にこのテキストを含む保有者だけ。大文字と小文字を区別せず、2〜100文字。 |
transaction_ | クエリ | いいえ | 文字列 | このSECの1文字の取引コードを持つ取引だけ。例:PまたはS。 |
form_ | クエリ | いいえ | 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_。 |
cursor | クエリ | いいえ | 文字列 | 前のページの next_。ほかのパラメータは同じ値にします。 |
limit | クエリ | いいえ | 整数 | 1ページあたりの行数。デフォルトは50、最大200。 |
レスポンスフィールド
| フィールド | 種別 | 送信 | 意味 |
|---|---|---|---|
id | 文字列 | 任意 | 企業ID。インサイダー1人の取引では、usa:とそのインサイダーのCIK。 |
filed_ | 日付 | 任意 | このアカウントが読める最も古い提出日。それより前に隠れている日がない場合は省略されます。 |
trades | オブジェクトの配列 | 常に | リクエストした順の取引。 |
trades[].derivative | 常に true | 任意 | その行がオプション、ワラント、転換証券などのデリバティブ証券である場合はtrue。 |
trades[].security | 文字列 | 任意 | 証券の名称(提出書類の記載どおり)。例:Common Stock。 |
trades[].ownership | one of D, I | 任意 | 直接保有はD、間接保有はI。 |
trades[].nature | 文字列 | 任意 | 間接保有の保有形態(提出書類の記載どおり)。 |
trades[].underlying | 文字列 | 任意 | デリバティブの場合、転換先の証券。 |
trades[].underlying_ | 文字列 | 任意 | デリバティブの場合、原資産の株数。 |
trades[].exercise_ | 文字列 | 任意 | デリバティブの場合、権利行使価格または転換価格。 |
trades[].exercise_ | 日付 | 任意 | デリバティブの場合、最初に権利行使できる日。 |
trades[].expiration_ | 日付 | 任意 | デリバティブの場合、失効日。 |
trades[].filing_ | 文字列 | 常に | その行の元となる提出書類のID。 |
trades[].form | one of 3, 3/A, 4, 4/A, 5, 5/A | 常に | その行が報告されたフォーム:3、4、5。修正の場合は/が付きます。 |
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_ | 常に true | 任意 | 報告者が株式の10%超を保有している場合はtrue。 |
trades[].owners[].other | 常に true | 任意 | 報告者が企業とその他の関係を持つ場合はtrue。 |
trades[].plan_ | 常に true | 任意 | フォームでRule 10b5-1のボックスにチェックが付いている場合はtrue。 |
trades[].transaction_ | 日付 | 任意 | 取引日。 |
trades[].code | 文字列 | 任意 | SECの取引コード。例:P購入、S売却、A付与、Mオプション行使、F源泉徴収、G贈与。 |
trades[].acquired_ | one of A, D | 任意 | 報告者が株式を取得した場合はA、処分した場合はD。 |
trades[].shares | 文字列 | 任意 | 取引の株数。 |
trades[].price | 文字列 | 任意 | 1株あたりの価格。提出書類に記載がない場合は省略されます。 |
trades[].currency | 文字列 | 任意 | 価格と金額の通貨。省略は米ドルを意味します。 |
trades[].owned_ | 文字列 | 任意 | 取引後に保有している株数。 |
trades[].equity_ | 常に true | 任意 | 提出者がその取引をエクイティスワップまたは類似の商品として示した場合はtrue。 |
trades[].amends | 文字列 | 任意 | この提出書類が置き換える提出書類。元の書類がちょうど1件に一致した修正の場合です。 |
trades[].amends_ | 常に true | 任意 | 修正が、見つからなかった元の書類を指している場合はtrue。 |
trades[].transaction_ | 文字列 | 任意 | sharesにpriceを掛けた値。提出書類に両方がある場合だけ返されます。 |
trades[].shares_ | 文字列 | 任意 | 取引前に保有していた株数。そのポジションについて、提出書類の各行の残高が順につながる場合だけ返されます。 |
trades[].deemed_ | 日付 | 任意 | 取引が約定したとみなされた日付。提出書類に記載がある場合。 |
trades[].timeliness | one of E, L | 任意 | 提出者が報告を早期と示した場合はE、遅延と示した場合はL。 |
trades[].not_ | 常に true | 任意 | 提出者がその取引を第16条の対象外と示した場合はtrue。 |
trades[].remarks | 文字列 | 任意 | 提出者がフォームに書いた備考。 |
trades[].footnotes | list of string | 常に | その行の脚注。ない場合は空。 |
trades[].company_ | 文字列 | 任意 | 株式が取引された企業のID。1社に限らない一覧で返されます。 |
trades[].issuer | 文字列 | 任意 | 株式が取引された企業の名前。 |
trades[].ticker | 文字列 | 任意 | 企業のティッカー。 |
next_ | 文字列 | 常に | 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_をfiled_と一緒に送るか、filing_を送ります。期間は最大31日です。
フィードは提出日の新しい順に並びます。取引日順に並べるには、1社または1人のインサイダーを指定してください。
MCP: ツール filings_。
パラメータ
| パラメータ | 場所 | 必須 | 種別 | 意味 |
|---|---|---|---|---|
filed_ | クエリ | いいえ | 日付 | 最初の提出日(その日を含む)(YYYY-MM-DD)。 |
filed_ | クエリ | いいえ | 日付 | 最後の提出日(その日を含む)。 |
filing_ | クエリ | いいえ | 日付 | この日に提出されたものだけ。 |
filing_ | クエリ | いいえ | 日付 | この日より後に提出されたものだけ。 |
filing_ | クエリ | いいえ | 日付 | この日より前に提出されたものだけ。 |
transaction_ | クエリ | いいえ | 日付 | この日に行われた取引だけ。 |
transaction_ | クエリ | いいえ | 日付 | この日より後に行われた取引だけ。 |
transaction_ | クエリ | いいえ | 日付 | この日以降に行われた取引だけ。 |
transaction_ | クエリ | いいえ | 日付 | この日より前に行われた取引だけ。 |
transaction_ | クエリ | いいえ | 日付 | この日以前に行われた取引だけ。 |
owner_ | クエリ | いいえ | 文字列 | このCIKを持つ保有者の提出書類だけ。先頭のゼロは省略できます。 |
name | クエリ | いいえ | 文字列 | 名前にこのテキストを含む保有者だけ。大文字と小文字を区別せず、2〜100文字。 |
transaction_ | クエリ | いいえ | 文字列 | このSECの1文字の取引コードを持つ取引だけ。例:PまたはS。 |
form_ | クエリ | いいえ | 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_。 |
cursor | クエリ | いいえ | 文字列 | 前のページの next_。ほかのパラメータは同じ値にします。 |
limit | クエリ | いいえ | 整数 | 1ページあたりの行数。デフォルトは50、最大200。 |
country | クエリ | いいえ | 文字列 | レジストリの3文字の国コード。省略はUSAを意味します。ルートが対応していない国は404 not_coveredです。 |
レスポンスフィールド
| フィールド | 種別 | 送信 | 意味 |
|---|---|---|---|
id | 文字列 | 任意 | 企業ID。インサイダー1人の取引では、usa:とそのインサイダーのCIK。 |
filed_ | 日付 | 任意 | このアカウントが読める最も古い提出日。それより前に隠れている日がない場合は省略されます。 |
trades | オブジェクトの配列 | 常に | リクエストした順の取引。 |
trades[].derivative | 常に true | 任意 | その行がオプション、ワラント、転換証券などのデリバティブ証券である場合はtrue。 |
trades[].security | 文字列 | 任意 | 証券の名称(提出書類の記載どおり)。例:Common Stock。 |
trades[].ownership | one of D, I | 任意 | 直接保有はD、間接保有はI。 |
trades[].nature | 文字列 | 任意 | 間接保有の保有形態(提出書類の記載どおり)。 |
trades[].underlying | 文字列 | 任意 | デリバティブの場合、転換先の証券。 |
trades[].underlying_ | 文字列 | 任意 | デリバティブの場合、原資産の株数。 |
trades[].exercise_ | 文字列 | 任意 | デリバティブの場合、権利行使価格または転換価格。 |
trades[].exercise_ | 日付 | 任意 | デリバティブの場合、最初に権利行使できる日。 |
trades[].expiration_ | 日付 | 任意 | デリバティブの場合、失効日。 |
trades[].filing_ | 文字列 | 常に | その行の元となる提出書類のID。 |
trades[].form | one of 3, 3/A, 4, 4/A, 5, 5/A | 常に | その行が報告されたフォーム:3、4、5。修正の場合は/が付きます。 |
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_ | 常に true | 任意 | 報告者が株式の10%超を保有している場合はtrue。 |
trades[].owners[].other | 常に true | 任意 | 報告者が企業とその他の関係を持つ場合はtrue。 |
trades[].plan_ | 常に true | 任意 | フォームでRule 10b5-1のボックスにチェックが付いている場合はtrue。 |
trades[].transaction_ | 日付 | 任意 | 取引日。 |
trades[].code | 文字列 | 任意 | SECの取引コード。例:P購入、S売却、A付与、Mオプション行使、F源泉徴収、G贈与。 |
trades[].acquired_ | one of A, D | 任意 | 報告者が株式を取得した場合はA、処分した場合はD。 |
trades[].shares | 文字列 | 任意 | 取引の株数。 |
trades[].price | 文字列 | 任意 | 1株あたりの価格。提出書類に記載がない場合は省略されます。 |
trades[].currency | 文字列 | 任意 | 価格と金額の通貨。省略は米ドルを意味します。 |
trades[].owned_ | 文字列 | 任意 | 取引後に保有している株数。 |
trades[].equity_ | 常に true | 任意 | 提出者がその取引をエクイティスワップまたは類似の商品として示した場合はtrue。 |
trades[].amends | 文字列 | 任意 | この提出書類が置き換える提出書類。元の書類がちょうど1件に一致した修正の場合です。 |
trades[].amends_ | 常に true | 任意 | 修正が、見つからなかった元の書類を指している場合はtrue。 |
trades[].transaction_ | 文字列 | 任意 | sharesにpriceを掛けた値。提出書類に両方がある場合だけ返されます。 |
trades[].shares_ | 文字列 | 任意 | 取引前に保有していた株数。そのポジションについて、提出書類の各行の残高が順につながる場合だけ返されます。 |
trades[].deemed_ | 日付 | 任意 | 取引が約定したとみなされた日付。提出書類に記載がある場合。 |
trades[].timeliness | one of E, L | 任意 | 提出者が報告を早期と示した場合はE、遅延と示した場合はL。 |
trades[].not_ | 常に true | 任意 | 提出者がその取引を第16条の対象外と示した場合はtrue。 |
trades[].remarks | 文字列 | 任意 | 提出者がフォームに書いた備考。 |
trades[].footnotes | list of string | 常に | その行の脚注。ない場合は空。 |
trades[].company_ | 文字列 | 任意 | 株式が取引された企業のID。1社に限らない一覧で返されます。 |
trades[].issuer | 文字列 | 任意 | 株式が取引された企業の名前。 |
trades[].ticker | 文字列 | 任意 | 企業のティッカー。 |
next_ | 文字列 | 常に | 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_を指定すると全履歴を取得できます。指定しない場合は、filed_とfiled_を7日以内の間隔で送ると、その期間に行われた提出書類が集計されます。それより長い期間は400 invalid_です。
purchaser_とseller_は、提出ごとに人を1回数えます。数えるのは最初に挙がった保有者だけです。
MCP: ツール filings_。
パラメータ
| パラメータ | 場所 | 必須 | 種別 | 意味 |
|---|---|---|---|---|
company_ | クエリ | いいえ | 文字列 | この企業だけ。指定すると全履歴を取得できます。 |
country | クエリ | いいえ | 文字列 | レジストリの3文字の国コード。省略はUSAを意味します。ルートが対応していない国は404 not_coveredです。 |
filed_ | クエリ | いいえ | 日付 | 最初の提出日(その日を含む)(YYYY-MM-DD)。 |
filed_ | クエリ | いいえ | 日付 | 最後の提出日(その日を含む)。 |
transaction_ | クエリ | いいえ | 日付 | この日に行われた取引だけ。 |
transaction_ | クエリ | いいえ | 日付 | この日より後に行われた取引だけ。 |
transaction_ | クエリ | いいえ | 日付 | この日以降に行われた取引だけ。 |
transaction_ | クエリ | いいえ | 日付 | この日より前に行われた取引だけ。 |
transaction_ | クエリ | いいえ | 日付 | この日以前に行われた取引だけ。 |
sort | クエリ | いいえ | one of transaction_date.desc, transaction_date.asc | 日の並び順。デフォルトはtransaction_。 |
cursor | クエリ | いいえ | 文字列 | 前のページの next_。ほかのパラメータは同じ値にします。 |
limit | クエリ | いいえ | 整数 | 1ページあたりの日数。デフォルトは100、最大1000。 |
レスポンスフィールド
| フィールド | 種別 | 送信 | 意味 |
|---|---|---|---|
days | オブジェクトの配列 | 常に | 企業と日ごとに1行。 |
days[].company_ | 文字列 | 常に | 企業のID。 |
days[].currency | 文字列 | 任意 | 価格と金額の通貨。省略は米ドルを意味します。 |
days[].issuer | 文字列 | 任意 | 株式が取引された企業の名前。 |
days[].ticker | 文字列 | 任意 | 企業のティッカー。 |
days[].transaction_ | 日付 | 常に | 取引日。 |
days[].last_ | 日付 | 常に | この日の合計に加わった最新の提出日。 |
days[].purchase_ | 整数 | 常に | 公開市場での購入の件数。 |
days[].purchase_ | 文字列 | 常に | 購入した株数。 |
days[].purchase_ | 文字列 | 任意 | 購入の金額(ドル)。合計に含まれる取引に価格がないものがある場合は省略されます。 |
days[].purchaser_ | 整数 | 常に | 購入した人数。提出ごとに1回数えます。 |
days[].sale_ | 整数 | 常に | 公開市場での売却の件数。 |
days[].sale_ | 文字列 | 常に | 売却した株数。 |
days[].sale_ | 文字列 | 任意 | 売却の金額(ドル)。合計に含まれる取引に価格がないものがある場合は省略されます。 |
days[].seller_ | 整数 | 常に | 売却した人数。提出ごとに1回数えます。 |
days[].net_ | 文字列 | 常に | purchase_からsale_を引いた値。 |
days[].net_ | 文字列 | 任意 | purchase_からsale_を引いた値。 |
days[].planned_ | 文字列 | 任意 | Rule 10b5-1のボックスにチェックが付いたフォームでの購入金額。ボックスはフォーム全体に対するものなので上限値です。2023年4月1日より前の提出では省略されます。 |
days[].planned_ | 文字列 | 任意 | Rule 10b5-1のボックスにチェックが付いたフォームでの売却金額。上限値です。2023年4月1日より前の提出では省略されます。 |
next_ | 文字列 | 常に | 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を読むときにこの一覧を使います。パラメータはありません。例は一覧の最初の4件です。
MCP: ツール filings_。
パラメータ
このルートにパラメーターはありません。
レスポンスフィールド
| フィールド | 種別 | 送信 | 意味 |
|---|---|---|---|
codes | オブジェクトの配列 | 常に | 取引コード。 |
codes[].code | 文字列 | 常に | SECの1文字の取引コード。 |
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_。参照: APIエラーとクレジット で形式とクレジットヘッダーを確認できます。失敗したリクエストには課金されません。
| コード | ステータス | 意味 |
|---|---|---|
invalid_ | 400 | パラメータが欠けている、未知である、重複している、または範囲外です。 |
invalid_ | 400 | このカーソルは、このリクエストが返したものではないか、別のリクエストのものです。 |
company_ | 404 | そのIDに一致する企業はありません。 |
not_ | 404 | その市場、国、企業にはまだ対応していません。 |
insufficient_ | 402 | クレジット残高が、リクエストの費用に足りません。 |
company_ | 503 | この経路の元になる提出書類を、現在は読み取れません。しばらくしてからもう一度お試しください。 |
このページは役に立ちましたか?