Price Statistics
price.statsRealized volatility, change over window, and range for an instrument, computed over its stored history. Use this for 'how volatile is X' and 'how has X moved over the last year' — it answers both in one call, so prefer it over fetching price.history and computing yourself. Descriptive only: no signals or view, which live in decision.get.
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": {
"code": "<code>"
},
"name": "price.stats"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | Instrument code from catalog.list. Example: CC, CL, GC. | |
| windows | No | Windows to compute over, as a count and a unit. Example: ["30d", "90d", "1y"]. Defaults to those three. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| unit | No | Unit of the underlying price | |
| as_of | No | Economic date of the newest observation used | |
| range | Yes | Min, max and mean over the retained history | |
| change | Yes | Change across each window, both endpoints dated | |
| series_id | Yes | Underlying series id | |
| instrument | Yes | Instrument code | |
| volatility | Yes | Annualized realized volatility per window | |
| license_tag | No | Licence the derived figures may claim | |
| input_series | Yes | The window these figures were computed over. Dereference via price.history for the observations themselves. | |
| periods_per_year | No | Observations per year implied by the series cadence; null when the cadence makes no promise and nothing can be annualized |