list_insider_transactions
TOOLList insider transactionsscope: dataflow:insider.read · read-only
Tool description, as exposed to the agent
Returns insider transactions for one company or one insider over a recent window. Insider transactions are reported trades by people with privileged access to a company (executives, board members, major shareholders) and their close relatives. Use search_securities to obtain a company_id, or search_owners to obtain an owner_id of an insider — pass exactly one of the two. The days parameter sets the lookback window (default 30, max 1825 — five years). Each row reports the transaction date, the insider's name and position (e.g. CEO, CFO, Board member), whether the transaction was by a close relative, the transaction type (e.g. Acquisition, Disposal, Exercise increase), the number of shares (delta_shares: positive = bought, negative = sold), the share price and currency, and whether the trade was part of an equity compensation plan. Miscellaneous transactions (gifts, inheritances, intra-group transfers) are excluded by default; set include_misc=true to see them. Results are ordered most-recent first, a page at a time (default 20, max 50 per page); when next_cursor is present in the response, pass it back as cursor on the next call to page through all transactions in the window until next_cursor is absent. Successful calls may consume Dataflow credits per transaction actually returned; an empty result costs zero credits.Parameters
| Parameter | Type | Description | |
|---|---|---|---|
| company_id | integer | optional | The company whose insider transactions to fetch, from search_securities. Mutually exclusive with owner_id — pass exactly one. Nonzero integer; the sign of the ID has NO meaning; negative IDs are normal and are NOT a flag for 'unlisted', 'private', or anything else. Pass it through verbatim. |
| owner_id | integer | optional | The insider whose own transactions to fetch (across the companies they are an insider of), from search_owners. Mutually exclusive with company_id — pass exactly one. Nonzero integer; the sign of the ID has NO meaning; negative IDs are normal and are NOT a flag for 'unlisted', 'private', or anything else. Pass it through verbatim. |
| days | integer | optional | Lookback window in calendar days, ending today. e.g. 7 = last week, 90 = last quarter. Default 30, max 1825 (five years).default 30 · min 1 · max 1825 |
| include_misc | boolean | optional | When true, also includes 'miscellaneous' transactions (gifts, inheritances, intra-group movements) that do not reflect open-market trades. Default false — most analysis wants only real trades.default false |
| limit | integer | optional | Maximum number of transactions per page, ordered by transaction_date descending (most recent first). Hard cap 50.default 20 · min 1 · max 50 |
| cursor | string | optional | Opaque pagination token returned as next_cursor by a prior call. Omit on the first call; pass back verbatim to page through all transactions WITHIN the same window until next_cursor is absent. Must accompany identical company_id, owner_id, days, include_misc, and limit values.max length 512 |
Billing
Pricing key: insider.transactions. Successful calls consume Dataflow credits per your contract. See Credits & pricing.
