Skip to main content
Glama
Finance Toolkit

Finance Toolkit

breadth

Read-onlyIdempotent

Calculate market-wide technical indicators—such as McClellan Oscillator, Advance/Decline Line, TRIN, OBV, and new highs/lows—from ticker price data without fetching prices first.

Instructions

Market breadth technical indicators (McClellan Oscillator, OBV, Advance/Decline Line, Chaikin, TRIN, new highs and lows). Applied to price data automatically — no need to fetch prices first. TRIN treats the given tickers as one market, so every column holds the same value; pass the market's constituents for a meaningful figure. 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_market_breadth measures the breadth of all tickers together (advancers and decliners, the advance-decline line, the McClellan oscillator and summation index, the share above the 50 and 200-period averages and new highs and lows), meant for many tickers such as an index's constituents (discovery get_index_constituents). For the predictive power of these indicators across tickers (factor analysis), use the momentum tool with indicator='get_factor_analysis' and metrics='breadth'.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "indicator": "<indicator>"
    },
    "name": "breadth"
  }
}

Input Schema

NameRequiredDescriptionDefault
lagNoNumber of periods to lag when computing growth rates.
rankNotrue ranks the tickers (or countries) within every period, from the highest value (rank 1) to the lowest, and compares each with its neighbour toward the middle of the ranking: the Difference (in points for returns) and the Multiple (only when both have the same sign), so the first and last rank show how far the best and the worst stand apart, e.g. a fall more than twice as large as the next one. Needs a value per period and ticker; pick one field with show_columns where there are more.
limitNoThe 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, and rows per ticker (an earnings calendar) are selected per ticker. For ETF holdings the largest (or, negative, the smallest) by weight, and for a list (e.g. news or a screener) its length. 0 returns every row.
growthNoReturn period-over-period growth rates instead of absolute values.
periodNoObservation frequency, e.g. 'daily', 'weekly', 'monthly', 'quarterly', or 'annual' (supported values differ per method).daily
windowNoThe 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 are 14 for get_ease_of_movement; 20 for get_chaikin_money_flow; 252 for get_new_highs_new_lows.
tickersNoComma-separated ticker symbols, e.g. 'AAPL,MSFT,GOOGL'.
end_dateNoEnd of the date range in YYYY-MM-DD format; left empty, today (or the indicator's own window).
indicatorYesName 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.
quarterlyNoReturn quarterly data instead of annual when True.
start_dateNoStart of the date range in YYYY-MM-DD format; left empty, five years before today (or the indicator's own window).
long_windowNoFor get_chaikin_oscillator: Number of periods for the long-term moving average. For get_market_breadth: The long moving average window. Leave unset to use the default of the indicator you selected. Defaults are 10 for get_chaikin_oscillator; 200 for get_market_breadth.
standardizeNoReturn 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.
start_valueNoThe index value to start the series at.
close_columnNoFor get_mcclellan_oscillator, get_advancers_decliners, get_trin, get_new_highs_new_lows, get_market_breadth: The name of the column containing the close prices. For get_on_balance_volume, get_accumulation_distribution_line, get_chaikin_oscillator, get_chaikin_money_flow, get_ease_of_movement, get_negative_volume_index, get_positive_volume_index: The column name for closing prices in the historical data.Adj Close
short_windowNoFor get_chaikin_oscillator: Number of periods for the short-term moving average. For get_market_breadth: The short moving average window. Leave unset to use the default of the indicator you selected. Defaults are 3 for get_chaikin_oscillator; 50 for get_market_breadth.
show_columnsNoComma-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.
volume_divisorNoScaling constant applied to volume so that the Box Ratio (and therefore EMV) stays in a readable range regardless of an asset's typical share volume.
high_low_windowNoThe number of periods, including the current one, of the new highs and lows.
long_ema_windowNoThe window size for the long-term EMA.
benchmark_tickerNoTicker used as the market benchmark, e.g. 'SPY' or '^GSPC'; 'None' for no benchmark.SPY
short_ema_windowNoThe window size for the short-term EMA.

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv2.3.4
    • addedInput schema / properties / rank
      Added value: +{
      +  "default": false,
      +  "description": "true ranks the tickers (or countries) within every period, from the highest value (rank 1) to the lowest, and compares each with its neighbour toward the middle of the ranking: the Difference (in points for returns) and the Multiple (only when both have the same sign), so the first and last rank show how far the best and the worst stand apart, e.g. a fall more than twice as large as the next one. Needs a value per period and ticker; pick one field with show_columns where there are more.",
      +  "type": "boolean"
      +}
  2. Changed1 schema field changedv2.3.2
    • changedInput schema / properties / limit / description
      Previous value: -"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. 0 returns every row."New value: +"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, and rows per ticker (an earnings calendar) are selected per ticker. For ETF holdings the largest (or, negative, the smallest) by weight, and for a list (e.g. news or a screener) its length. 0 returns every row."
  3. Changed6 schema fields changedv2.3.1
    • changedInput schema / properties / benchmark_ticker / description
      Previous value: -"Ticker used as the market benchmark, e.g. 'SPY' or '^GSPC'."New value: +"Ticker used as the market benchmark, e.g. 'SPY' or '^GSPC'; 'None' for no benchmark."
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-10-27"New value: +""
    • changedInput schema / properties / end_date / description
      Previous value: -"End of the date range in YYYY-MM-DD format."New value: +"End of the date range in YYYY-MM-DD format; left empty, today (or the indicator's own window)."
    • changedInput schema / properties / limit / description
      Previous value: -"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."New value: +"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. 0 returns every row."
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-10-28"New value: +""
    • changedInput schema / properties / start_date / description
      Previous value: -"Start of the date range in YYYY-MM-DD format."New value: +"Start of the date range in YYYY-MM-DD format; left empty, five years before today (or the indicator's own window)."
  4. Changed13 schema fields changedv2.3.0
    • changedInput schema / properties / close_column / description
      Previous value: -"For get_mcclellan_oscillator, get_advancers_decliners, get_trin, get_new_highs_new_lows: The name of the column containing the close prices. For get_on_balance_volume, get_accumulation_distribution_line, get_chaikin_oscillator, get_chaikin_money_flow, get_ease_of_movement, get_negative_volume_index, get_positive_volume_index: The column name for closing prices in the historical data."New value: +"For get_mcclellan_oscillator, get_advancers_decliners, get_trin, get_new_highs_new_lows, get_market_breadth: The name of the column containing the close prices. For get_on_balance_volume, get_accumulation_distribution_line, get_chaikin_oscillator, get_chaikin_money_flow, get_ease_of_movement, get_negative_volume_index, get_positive_volume_index: The column name for closing prices in the historical data."
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-10-14"New value: +"2026-10-27"
    • addedInput schema / properties / high_low_window
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The number of periods, including the current one, of the new highs and lows."
      +}
    • changedInput schema / properties / indicator / enum
      Previous value: -[
      -  "get_mcclellan_oscillator",
      -  "get_advancers_decliners",
      -  "get_on_balance_volume",
      -  "get_accumulation_distribution_line",
      -  "get_chaikin_oscillator",
      -  "get_trin",
      -  "get_new_highs_new_lows",
      -  "get_chaikin_money_flow",
      -  "get_ease_of_movement",
      -  "get_negative_volume_index",
      -  "get_positive_volume_index"
      -]New value: +[
      +  "get_mcclellan_oscillator",
      +  "get_advancers_decliners",
      +  "get_on_balance_volume",
      +  "get_accumulation_distribution_line",
      +  "get_chaikin_oscillator",
      +  "get_trin",
      +  "get_new_highs_new_lows",
      +  "get_market_breadth",
      +  "get_chaikin_money_flow",
      +  "get_ease_of_movement",
      +  "get_negative_volume_index",
      +  "get_positive_volume_index"
      +]
    • addedInput schema / properties / long_window / anyOf
      Added value: +[
      +  {
      +    "type": "integer"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / long_window / default
      Previous value: -10New value: +null
    • changedInput schema / properties / long_window / description
      Previous value: -"Number of periods for the long-term moving average."New value: +"For get_chaikin_oscillator: Number of periods for the long-term moving average. For get_market_breadth: The long moving average window. Leave unset to use the default of the indicator you selected. Defaults are 10 for get_chaikin_oscillator; 200 for get_market_breadth."
    • removedInput schema / properties / long_window / type
      Removed value: -"integer"
    • addedInput schema / properties / short_window / anyOf
      Added value: +[
      +  {
      +    "type": "integer"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / short_window / default
      Previous value: -3New value: +null
    • changedInput schema / properties / short_window / description
      Previous value: -"Number of periods for the short-term moving average."New value: +"For get_chaikin_oscillator: Number of periods for the short-term moving average. For get_market_breadth: The short moving average window. Leave unset to use the default of the indicator you selected. Defaults are 3 for get_chaikin_oscillator; 50 for get_market_breadth."
    • removedInput schema / properties / short_window / type
      Removed value: -"integer"
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-10-15"New value: +"2021-10-28"
  5. Changed37 schema fields changedv2.2.3
    • removedInput schema / properties / benchmark_ticker / title
      Removed value: -"Benchmark Ticker"
    • changedInput schema / properties / close_column / description
      Previous value: -"Value for close_column."New value: +"For get_mcclellan_oscillator, get_advancers_decliners, get_trin, get_new_highs_new_lows: The name of the column containing the close prices. For get_on_balance_volume, get_accumulation_distribution_line, get_chaikin_oscillator, get_chaikin_money_flow, get_ease_of_movement, get_negative_volume_index, get_positive_volume_index: The column name for closing prices in the historical data."
    • removedInput schema / properties / close_column / title
      Removed value: -"Close Column"
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-10-02"New value: +"2026-10-14"
    • removedInput schema / properties / end_date / title
      Removed value: -"End Date"
    • removedInput schema / properties / growth / title
      Removed value: -"Growth"
    • changedInput schema / properties / indicator / description
      Previous value: -"Name of the specific metric to calculate, e.g. 'get_asset_turnover_ratio'. Required — omitting it returns the list of available indicators."New value: +"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."
    • removedInput schema / properties / indicator / title
      Removed value: -"Indicator"
    • addedInput schema / properties / lag / anyOf
      Added value: +[
      +  {
      +    "type": "integer"
      +  },
      +  {
      +    "items": {
      +      "type": "integer"
      +    },
      +    "type": "array"
      +  }
      +]
    • removedInput schema / properties / lag / title
      Removed value: -"Lag"
    • removedInput schema / properties / lag / type
      Removed value: -"integer"
    • addedInput schema / properties / limit
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "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."
      +}
    • changedInput schema / properties / long_ema_window / description
      Previous value: -"Value for long_ema_window."New value: +"The window size for the long-term EMA."
    • removedInput schema / properties / long_ema_window / title
      Removed value: -"Long Ema Window"
    • changedInput schema / properties / long_window / description
      Previous value: -"Value for long_window."New value: +"Number of periods for the long-term moving average."
    • removedInput schema / properties / long_window / title
      Removed value: -"Long Window"
    • changedInput schema / properties / period / description
      Previous value: -"Observation frequency, e.g. 'monthly', 'quarterly', or 'annual'."New value: +"Observation frequency, e.g. 'daily', 'weekly', 'monthly', 'quarterly', or 'annual' (supported values differ per method)."
    • removedInput schema / properties / period / title
      Removed value: -"Period"
    • removedInput schema / properties / quarterly / title
      Removed value: -"Quarterly"
    • changedInput schema / properties / short_ema_window / description
      Previous value: -"Value for short_ema_window."New value: +"The window size for the short-term EMA."
    • removedInput schema / properties / short_ema_window / title
      Removed value: -"Short Ema Window"
    • changedInput schema / properties / short_window / description
      Previous value: -"Value for short_window."New value: +"Number of periods for the short-term moving average."
    • removedInput schema / properties / short_window / title
      Removed value: -"Short Window"
    • removedInput schema / properties / show_columns / title
      Removed value: -"Show Columns"
    • removedInput schema / properties / standardize / title
      Removed value: -"Standardize"
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-10-03"New value: +"2021-10-15"
    • removedInput schema / properties / start_date / title
      Removed value: -"Start Date"
    • changedInput schema / properties / start_value / description
      Previous value: -"Value for start_value."New value: +"The index value to start the series at."
    • removedInput schema / properties / start_value / title
      Removed value: -"Start Value"
    • addedInput schema / properties / tickers / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  }
      +]
    • removedInput schema / properties / tickers / title
      Removed value: -"Tickers"
    • removedInput schema / properties / tickers / type
      Removed value: -"string"
    • changedInput schema / properties / volume_divisor / description
      Previous value: -"Value for volume_divisor."New value: +"Scaling constant applied to volume so that the Box Ratio (and therefore EMV) stays in a readable range regardless of an asset's typical share volume."
    • removedInput schema / properties / volume_divisor / title
      Removed value: -"Volume Divisor"
    • changedInput schema / properties / window / description
      Previous value: -"Value for window. Leave unset to use the default of the indicator you selected. Defaults are 14 for get_ease_of_movement; 20 for get_chaikin_money_flow; 252 for get_new_highs_new_lows."New value: +"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 are 14 for get_ease_of_movement; 20 for get_chaikin_money_flow; 252 for get_new_highs_new_lows."
    • removedInput schema / properties / window / title
      Removed value: -"Window"
    • removedInput schema / title
      Removed value: -"breadthArguments"
  6. Changed2 schema fields changedv2.2.1
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-08-19"New value: +"2026-10-02"
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-08-20"New value: +"2021-10-03"
  7. Changed9 schema fields changedv2.2.0
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-07-14"New value: +"2026-08-19"
    • changedInput schema / properties / indicator / enum
      Previous value: -[
      -  "get_mcclellan_oscillator",
      -  "get_advancers_decliners",
      -  "get_on_balance_volume",
      -  "get_accumulation_distribution_line",
      -  "get_chaikin_oscillator",
      -  "get_trin",
      -  "get_new_highs_new_lows"
      -]New value: +[
      +  "get_mcclellan_oscillator",
      +  "get_advancers_decliners",
      +  "get_on_balance_volume",
      +  "get_accumulation_distribution_line",
      +  "get_chaikin_oscillator",
      +  "get_trin",
      +  "get_new_highs_new_lows",
      +  "get_chaikin_money_flow",
      +  "get_ease_of_movement",
      +  "get_negative_volume_index",
      +  "get_positive_volume_index"
      +]
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-07-15"New value: +"2021-08-20"
    • addedInput schema / properties / start_value
      Added value: +{
      +  "default": 1000,
      +  "description": "Value for start_value.",
      +  "title": "Start Value",
      +  "type": "number"
      +}
    • addedInput schema / properties / volume_divisor
      Added value: +{
      +  "default": 100000000,
      +  "description": "Value for volume_divisor.",
      +  "title": "Volume Divisor",
      +  "type": "number"
      +}
    • addedInput schema / properties / window / anyOf
      Added value: +[
      +  {
      +    "type": "integer"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / window / default
      Previous value: -252New value: +null
    • changedInput schema / properties / window / description
      Previous value: -"Value for window."New value: +"Value for window. Leave unset to use the default of the indicator you selected. Defaults are 14 for get_ease_of_movement; 20 for get_chaikin_money_flow; 252 for get_new_highs_new_lows."
    • removedInput schema / properties / window / type
      Removed value: -"integer"
  8. Changed5 schema fields changed
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-07-09"New value: +"2026-07-14"
    • changedInput schema / properties / indicator / enum
      Previous value: -[
      -  "get_mcclellan_oscillator",
      -  "get_advancers_decliners",
      -  "get_on_balance_volume",
      -  "get_accumulation_distribution_line",
      -  "get_chaikin_oscillator"
      -]New value: +[
      +  "get_mcclellan_oscillator",
      +  "get_advancers_decliners",
      +  "get_on_balance_volume",
      +  "get_accumulation_distribution_line",
      +  "get_chaikin_oscillator",
      +  "get_trin",
      +  "get_new_highs_new_lows"
      +]
    • addedInput schema / properties / standardize
      Added value: +{
      +  "default": false,
      +  "description": "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.",
      +  "title": "Standardize",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-07-10"New value: +"2021-07-15"
    • addedInput schema / properties / window
      Added value: +{
      +  "default": 252,
      +  "description": "Value for window.",
      +  "title": "Window",
      +  "type": "integer"
      +}
  9. Changed2 schema fields changedv2.1.4
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-06-27"New value: +"2026-07-09"
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-06-28"New value: +"2021-07-10"
  10. Changed2 schema fields changedv2.1.3
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-06-23"New value: +"2026-06-27"
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-06-24"New value: +"2021-06-28"
  11. Changed4 schema fields changedv0.1.2
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-06-22"New value: +"2026-06-23"
    • removedInput schema / properties / rounding
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "integer"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "Number of decimal places to round results to.",
      -  "title": "Rounding"
      -}
    • addedInput schema / properties / show_columns
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "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.",
      +  "title": "Show Columns"
      +}
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-06-23"New value: +"2021-06-24"
  12. Addedv0.1.1

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent and openWorld, so the description's job is to add operational context — and it does: price fetching is automatic, TRIN fills every column with the same value, and long-window indicators can return empty periods on short histories, requiring an earlier start_date to warm up. It does not mention rate limits or output shape, but those are covered by the output schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The paragraph is dense but ordered sensibly: indicator list first, then TRIN caveat, warm-up caveat, ticker requirement, and finally the two sibling alternatives. The wording around the warm-up ('quarterly or yearly periods with long windows can be empty on short histories') is a little convoluted, and the single indicator list plus caveat stack pushes length, but each sentence carries actionable information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 22 parameters, full schema coverage, an output schema, and rich annotations, the description supplies the non-obvious operational facts an agent needs — auto price fetch, mandatory tickers, TRIN semantics, warm-up empties — plus sibling routing. The remaining gap is minimal: nothing tells the agent which of the 12 indicators to prefer in a given situation, but that is largely a selection detail rather than a calling detail.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all 22 parameters and the baseline is 3. The description only adds meaning for a few: tickers accepts comma-separated values and is effectively required, start_date should be moved earlier to warm up long windows, and TRIN interprets the ticker list as one market. Most parameters (lag, rank, growth, standardize, limit, windows) get no additional description-level context.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names the specific resource set (McClellan Oscillator, OBV, Advance/Decline Line, Chaikin, TRIN, new highs/lows) and clarifies that price data is fetched automatically, which corrects the misleadingly narrow tool name 'breadth' since the enum includes OBV, EMV, NVI/PVI etc. It is clear what the tool computes, though it never states a simple verb like 'calculate these indicators for the given tickers' up front.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It routes the agent explicitly: use get_market_breadth when measuring breadth across all tickers together (index constituents), and use momentum with indicator='get_factor_analysis' and metrics='breadth' for cross-ticker factor analysis. It also warns that TRIN needs the market's constituents for a meaningful figure. It lacks a plain statement of the ordinary single-indicator use case, but the alternatives are named concretely.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.