What inputs does get_smart_money_flow accept?

ticker (string, required): Issuer ticker symbol — or a CIK (SEC identifier). lookback_days (integer, optional, default 90): Lookback window for insider + blockholder components. Default 90. weight_institutional (number, optional, default 0.4): Weight applied to the institutional component (0–1). weight_blockholder (number, optional, default 0.4): Weight applied to the blockholder component (0–1). weight_insider (number, optional, default 0.2): Weight applied to the insider component (0–1). as_of_date (string, optional): Point-in-time cutoff (YYYY-MM-DD) applied to all three legs (institutional, insider, blockholder) via SEC accepted_at — filings accepted after this date are excluded so the composite is computed with zero look-ahead. Omit for the latest knowable signal.

Which Valuein plans include get_smart_money_flow?

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

smart-money

PIT-safe

Smart Money Flow (composite)

get_smart_money_flow

Institutional and above

Composite flow score on [-100, +100] aggregating insider transactions, 13F institutional Δ-shares vs the prior quarter, and SC 13D/13G blockholder changes over a lookback window. Each component normalised independently, then combined with configurable weights (default: institu...

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_smart_money_flow",    arguments={    "ticker": "EXAMPLE"})print(result)

Direct tool call:get_smart_money_flow(...)

Inputs

Parameter	Type	Required	Description
`ticker`	string	required	Issuer ticker symbol — or a CIK (SEC identifier).
`lookback_days`	integer	optional	Lookback window for insider + blockholder components. Default 90.Default: `90`
`weight_institutional`	number	optional	Weight applied to the institutional component (0–1).Default: `0.4`
`weight_blockholder`	number	optional	Weight applied to the blockholder component (0–1).Default: `0.4`
`weight_insider`	number	optional	Weight applied to the insider component (0–1).Default: `0.2`
`as_of_date`	string	optional	Point-in-time cutoff (YYYY-MM-DD) applied to all three legs (institutional, insider, blockholder) via SEC accepted_at — filings accepted after this date are excluded so the composite is computed with zero look-ahead. Omit for the latest knowable signal.

Output Fields

tickercikcompany_nameperiod_endas_of_datecomposite_scoreinsider_componentinstitutional_componentblockholder_componentweightscomponentscoveragemetrics_display

Example Response

Illustrative

response.jsonjson

{  "ticker": "AAPL",  "cik": "0000320193",  "company_name": "Apple Inc.",  "period_end": "2024-03-15",  "as_of_date": null,  "composite_score": null,  "insider_component": null,  "institutional_component": null}