What inputs does get_insider_transactions accept?

ticker (string, required): Stock ticker symbol, e.g. AAPL, MSFT, BRK.B — or a CIK (SEC identifier), e.g. '0000320193'. lookback_days (integer, optional, default 90): How many days back from today to scan transactions for. Ignored when as_of_date is set. transaction_codes (array, optional): SEC transaction codes to keep (uppercase, single-letter): P=purchase, S=sale, A=grant, M=option exercise, F=tax withholding, G=gift, J=other. Unknown codes are rejected. Omit to include all codes. roles_in (array, optional): Insider roles to keep. Omit to include any role. min_shares (number, optional): Minimum |shares| per transaction. Omit for no floor. as_of_date (string, optional): Point-in-time date (YYYY-MM-DD). Only returns transactions with accepted_at <= this date — eliminates look-ahead bias. When set, lookback_days is ignored. limit (integer, optional, default 100): Maximum rows to return. Default 100, max 500. lineage_detail ("off" | "compact" | "full", optional, default "compact"): Per-row provenance envelope. 'compact' (default) returns source_filing + source_url. 'full' adds accepted_at. 'off' omits lineage.

Which Valuein plans include get_insider_transactions?

Available on Institutional only. Point-in-time safe via as_of_date filtering.

smart-money

PIT-safe

Insider Transactions

get_insider_transactions

Institutional and above

Form 3 / 4 / 5 / 144 line items for a US public company. Returns each transaction (or initial holding / proposed sale) with the insider's name, role, transaction code, share count, price, and notional. Filters by lookback window, transaction code (P=purchase, S=sale, A=grant, ...

Example Call

example_call.pypython

# Using the Valuein MCP server from Python (via MCP SDK)# Or call directly from Claude / Cursor after setup result = await client.call_tool(    "get_insider_transactions",    arguments={    "ticker": "EXAMPLE"})print(result)

Direct tool call:get_insider_transactions(...)

Inputs

Parameter	Type	Required	Description
`ticker`	string	required	Stock ticker symbol, e.g. AAPL, MSFT, BRK.B — or a CIK (SEC identifier), e.g. '0000320193'.
`lookback_days`	integer	optional	How many days back from today to scan transactions for. Ignored when as_of_date is set.Default: `90`
`transaction_codes`	array	optional	SEC transaction codes to keep (uppercase, single-letter): P=purchase, S=sale, A=grant, M=option exercise, F=tax withholding, G=gift, J=other. Unknown codes are rejected. Omit to include all codes.
`roles_in`	array	optional	Insider roles to keep. Omit to include any role.
`min_shares`	number	optional	Minimum \|shares\| per transaction. Omit for no floor.
`as_of_date`	string	optional	Point-in-time date (YYYY-MM-DD). Only returns transactions with accepted_at <= this date — eliminates look-ahead bias. When set, lookback_days is ignored.
`limit`	integer	optional	Maximum rows to return. Default 100, max 500.Default: `100`
`lineage_detail`	"off" \| "compact" \| "full"	optional	Per-row provenance envelope. 'compact' (default) returns source_filing + source_url. 'full' adds accepted_at. 'off' omits lineage.Default: `"compact"`

Output Fields

tickercikcompany_namedata_age_daysstaleness_warningrows

Example Response

Illustrative

response.jsonjson

{  "ticker": "AAPL",  "cik": "0000320193",  "company_name": "Apple Inc.",  "data_age_days": null,  "staleness_warning": null,  "rows": null}

Shape only — field names match the live schema; values are placeholders, not real filings. See MCP server for the structured response shape.

Notes

Available from the Institutional plan and above.

Try this tool

Get token All tools

Categorysmart-money

PIT-safeYes

Min planInstitutional

Inputs8 (1 required)

Plan Access

Sample (guest)

Not included

Benchmark (token)

Not included

Pro

Not included

Institutional

Available

Related Tools

search_companies

Search Companies

get_company_fundamentals

Company Fundamentals

get_valuation_metrics

Valuation Metrics

get_financial_ratios

Financial Ratios

Resources

Point-in-Time methodology →Parquet schema reference →Bulk Data API reference →Python SDK guide →

Index names are trademarks of their owners; Valuein is not affiliated with or endorsed by any index provider.