Modular Finance Dataflow

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 365). 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

ParameterTypeDescription
company_idintegeroptionalThe 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_idintegeroptionalThe 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.
daysintegeroptionalLookback window in calendar days, ending today. e.g. 7 = last week, 90 = last quarter. Default 30, max 365.default 30 · min 1 · max 365
include_miscbooleanoptionalWhen 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
limitintegeroptionalMaximum number of transactions per page, ordered by transaction_date descending (most recent first). Hard cap 50.default 20 · min 1 · max 50
cursorstringoptionalOpaque 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.