momentum
Read-onlyIdempotent
Compute momentum indicators like RSI, MACD, and Stochastic directly from price data to assess trend strength and spot reversals, without fetching prices first.
Instructions
Momentum technical indicators (RSI, MACD, Stochastic Oscillator, Williams %R, Aroon, ADX, CCI, MFI, rate of change, Ichimoku Cloud, awesome, ultimate and Chande momentum oscillators, vortex, Know Sure Thing and more). Applied to price data automatically — no need to fetch prices first. Each indicator needs its window of history before it produces values, so the first periods after start_date can be empty and quarterly or yearly periods with long windows can be empty on short histories; start earlier to warm up. Requires tickers='AAPL' — use comma-separated values for multiple tickers. get_relative_strength gives the price relative to the benchmark, the Mansfield relative strength and a 1-99 relative strength rating across the tickers; get_seasonality the average return, hit rate and t-statistic per calendar month (frequency='month') or weekday (frequency='weekday').
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lag | No | Number of periods to lag when computing growth rates. | |
| limit | No | The rows to return, like head and tail: 5 for the first five, -5 for the last five (the most recent of a time series). A table with its periods as columns (financial statements, ratios) keeps its first or last periods instead. For ETF holdings the largest (or, negative, the smallest) by weight, and for a list (e.g. news or a screener) its length. | |
| growth | No | Return period-over-period growth rates instead of absolute values. | |
| period | No | Observation frequency, e.g. 'daily', 'weekly', 'monthly', 'quarterly', or 'annual' (supported values differ per method). | daily |
| window | No | The number of periods the indicator looks back over, e.g. 14 or 20. Leave unset to use the default of the indicator you selected. Defaults differ between indicators. | |
| tickers | No | Comma-separated ticker symbols, e.g. 'AAPL,MSFT,GOOGL'. | |
| weights | No | The four weights applied to each smoothed Rate of Change series before summing. | |
| constant | No | Constant multiplier used in the CCI calculation. | |
| end_date | No | End of the date range in YYYY-MM-DD format. | 2026-10-27 |
| window_1 | No | The number of periods for the first short-term window. | |
| window_2 | No | The number of periods for the second mid-term window. | |
| window_3 | No | The number of periods for the third long-term window. | |
| frequency | No | "month" (per calendar month) or "weekday" (per day of the week). | month |
| indicator | Yes | Name of the specific metric to calculate, one of the listed values. Required — search_metrics finds the indicator (and its tool) for a metric by name. | |
| quarterly | No | Return quarterly data instead of annual when True. | |
| start_date | No | Start of the date range in YYYY-MM-DD format. | 2021-10-28 |
| base_window | No | The number of periods to consider for the Base Line (Kijun-sen) calculation, also used as the forward displacement for both Leading Spans. | |
| long_window | No | For get_percentage_price_oscillator: The number of periods for the long-term moving average. For get_moving_average_convergence_divergence: The number of periods for the longer moving average. For get_awesome_oscillator: The number of periods for the long-term SMA of the median price. Leave unset to use the default of the indicator you selected. Defaults are 26 for get_moving_average_convergence_divergence, get_percentage_price_oscillator; 34 for get_awesome_oscillator. | |
| roc_windows | No | The four lookback periods used for the underlying Rate of Change calculations. | |
| sma_windows | No | The four Simple Moving Average smoothing periods applied to each Rate of Change series. | |
| standardize | No | Return the Z-Score (standard score) instead of the raw values, i.e. how many standard deviations each value is from the mean of its own series. When combined with growth=True, the growth values are standardized instead of the raw values. | |
| close_column | No | The column in the historical data that represents. | Adj Close |
| short_window | No | For get_percentage_price_oscillator: The number of periods for the short-term moving average. For get_moving_average_convergence_divergence: The number of periods for the shorter moving average. For get_awesome_oscillator: The number of periods for the short-term SMA of the median price. Leave unset to use the default of the indicator you selected. Defaults are 12 for get_moving_average_convergence_divergence, get_percentage_price_oscillator; 5 for get_awesome_oscillator. | |
| show_columns | No | Comma-separated names to filter the output. For historical data use the key names visible in any response record (e.g. 'Close,Volume,Return'). For financial statements use the 'metric' field values from the response (e.g. 'Revenue,Net Income,EBITDA'). Call the tool once without this parameter to see all available names, then repeat with show_columns to reduce response size and token usage. | |
| signal_window | No | For get_moving_average_convergence_divergence: The number of periods for the signal line. For get_know_sure_thing: Number of periods for the Simple Moving Average of the KST used as the signal line. | |
| smooth_window | No | The number of periods used to smooth the %K line into the %D signal line. | |
| benchmark_ticker | No | Ticker used as the market benchmark, e.g. 'SPY' or '^GSPC'. | SPY |
| conversion_window | No | The number of periods to consider for the Conversion Line (Tenkan-sen) calculation. | |
| lead_span_b_window | No | The number of periods to consider for the Lead Span B (Senkou Span B) calculation. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |