get_top_movers

Get Top Market Movers

Read-only5 parameters

What it does

Top stock movers — gainers (largest % up), losers (largest % down), or active (highest volume). Optional session window (premarket / regular / afterhours; regular default; not supported for active).

Optional date (YYYY-MM-DD) returns a PAST trade date's gainers/losers on a historical daily close-to-close basis (computed from split-adjusted daily bars, NOT intraday) — session is rejected when date is set, date is not supported for direction=active, and a non-trade date (weekend/holiday) returns an empty list (not an error).

Penny-stock artifacts are filtered by default — set includePennyStocks to include sub-$1 movers.

Ask your AI

With the Signal8 MCP server connected, your assistant calls this tool when a question needs it. For example:

Use Signal8's get_top_movers tool.

Parameters

Name	Type	Description
`direction` required	"gainers" \| "losers" \| "active"	Mover direction: gainers, losers, or active (volume)
`limit` optional	integer	Optional max rows (1–100). Backend default applied when omitted.
`session` optional	"premarket" \| "regular" \| "afterhours"	Session window: premarket (4:00–9:30 AM ET), regular (RTH close-to-close, default), afterhours (4:00–8:00 PM ET). Live-only — rejected (400) when combined with date.
`includePennyStocks` optional	boolean	Loosen penny-stock artifact guards. Default false enforces prev_close >= $1 and a $1M dollar-volume floor. Set true to allow sub-$1 movers (prev_close >= $0.10, no dollar-volume floor). The ABS(change_pct) <= 500 cap applies in both modes.
`date` optional	string	Optional past trade date (YYYY-MM-DD). When set, returns that day's top gainers/losers computed on a historical daily close-to-close basis from split-adjusted daily bars (NOT intraday, NOT session-specific). Rejected with 400 when combined with a non-regular session or with direction="active"; a future or malformed date is also 400. A weekend/holiday date returns an empty list, not an error.

Other Market data tools