Market-Wide Insight
market_insightCurated analysis computed live across all US public companies, chosen by name: top_companies (rank by a metric, optionally within an industry), movers (largest change in a metric between fy_from and fy_to), sector_landscape (margin medians per industry), metric_trend (yearly sum, median or mean of a metric), capital_returns (buybacks vs dividends by size bucket) or filing_velocity (monthly filing counts for a form type). Each parameter's description says which analyses read it; the response reports the fiscal year(s) used. Use screen_companies for your own criteria and standard_score for F-Score, Z-Score and similar scores. Cost: $0.15 per call; unpaid calls return a payment-required error.
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": {
"name": "<name>"
},
"name": "market_insight"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fy | No | Fiscal year for top_companies, sector_landscape and capital_returns, and the default end year for movers and metric_trend; omit for the current fiscal year. | |
| agg | No | metric_trend only: sum (the default), median or mean. | |
| form | No | filing_velocity only: form type to count, e.g. 8-K (the default). | |
| name | Yes | Analysis to run: top_companies, movers, sector_landscape, metric_trend, capital_returns or filing_velocity. | |
| fy_to | No | End year for movers and metric_trend (default fy). | |
| limit | No | Maximum rows for top_companies and movers, 1-200 (default 25). | |
| metric | No | Metric for top_companies, movers and metric_trend, e.g. revenue (the default), gross_margin, research_development. | |
| months | No | filing_velocity only: months of history, default 18, up to 120. | |
| fy_from | No | Start year for movers (default fy - 2) and metric_trend (default 2015). | |
| industry | No | top_companies only: 2-digit SIC industry group, e.g. 73; omit for every industry. | |
| min_revenue | No | Minimum annual revenue in USD for movers (default 1e9) and sector_landscape (default 1e8). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |