Comparisons
Overlay other instruments on the main chart.
1aa5e22). Descriptions are the exact text the model receives.comparisons_list
List every comparison symbol currently overlaid on the chart. Each item exposes the stable identity, the complete symbol spec, and the assigned line color. Use identity with comparison_remove.
Parameters
This tool takes no input.
JSON Schema
…comparison_create
Add one comparison symbol to the main chart. symbol is required and is resolved against the active market-data sources so the real exchange, id, and params are used; source, exchange, and assetClass restrict which instrument the code may resolve to; assetClass only accepts a known class, never unknown. primary is the chart main symbol; its source, period, and adjust only fill omitted fields and never override the resolved instrument. When several distinct instruments match, nothing is added and the result is { status: "ambiguous", candidates: [...] }: ask the user to choose with the ask_user tool, then retry with the chosen candidate's source and exchange (add assetClass only when its class is not unknown). Never pick a candidate yourself. Fails with an actionable reason only when the symbol cannot be resolved or is already compared; an unknown market is rejected.
Parameters
| Name | Type | Required | Constraints | Description |
|---|---|---|---|---|
symbol | string | Yes | min length 1 | |
market | string | — | min length 1 | |
exchange | string | — | min length 1 | |
source | string | — | min length 1 | |
assetClass | enum | — | one of "stock", "index", "fund", "etf", "future", "option", "forex", "crypto" | |
period | string | — | min length 1 | |
adjust | string | — | min length 1 | |
primary | object | — | closed | |
primary.symbol | string | — | min length 1 | |
primary.market | string | — | min length 1 | |
primary.exchange | string | — | min length 1 | |
primary.source | string | — | min length 1 | |
primary.period | string | — | min length 1 | |
primary.adjust | string | — | min length 1 | |
primary.startDate | string | — | min length 1 | |
primary.endDate | string | — | min length 1 |
Minimal input · Required fields only; placeholders are derived from the schema.
{
"symbol": "<symbol>"
}JSON Schema
…comparison_remove
Remove one comparison line by its identity from comparisons_list; a matching symbol code also works. The primary symbol and chart mode remain unchanged.
Parameters
| Name | Type | Required | Constraints | Description |
|---|---|---|---|---|
identity | string | Yes | min length 1 |
Minimal input · Required fields only; placeholders are derived from the schema.
{
"identity": "<identity>"
}JSON Schema
…comparisons_clear
Remove every comparison line while keeping the primary symbol and chart mode unchanged. Returns the number of removed symbols.
Parameters
This tool takes no input.
JSON Schema
…