chart_series
Fetch an IDX symbol's price chart series for a calendar window (1w to 5y) in one request, oldest first; fall back to paged bars tools on error.
Instructions
A chart price series for one symbol in ONE request, oldest observation first.
This is the cheap path. The other one (the bars family) pages 12 rows at a time, so a year costs ~21 upstream calls and three years ~62; this costs one. Prefer it when you need a series and a calendar window is good enough.
timeframe is a CALENDAR WINDOW, not a bar interval, and must be lowercase: 1w, 1m, 3m, ytd, 1y, 3y, 5y. Read granularity: 1w is intraday and preserves full Jakarta timestamps; longer windows are usually daily. An uppercase or interval-style value (1D, DAILY) is refused here rather than sent, because the server answers those with HTTP 200 and an empty series that looks exactly like a symbol with no history.
This tool ERRORS instead of returning an empty series — including when the response parses but holds no points. An empty result would be indistinguishable from a broken fast path, so on an error fall back to the paged bars tools rather than concluding the symbol has no data.
Check unmapped and warnings on the result before using the numbers. On the daily route the close arrives as value and open/high/low/volume arrive EMPTY, so every candle is flat and warnings says so: candlestick patterns and high/low indicators are meaningless on this series. Volume on that route comes back NULL, not 0 — a field that arrived empty on every bar is absent, and warnings names every such field. mapped, extraKeys and sample show which wire keys were used and what else the point carried.
raw=true returns THIS ROUTE'S payload untouched instead of bars — the same request, with nothing projected. Use it only to discover real field spellings when unmapped or extraKeys is non-empty; it is not a fallback and returns no bars.
raw=true used to read a DIFFERENT endpoint. It called /charts/:symbol while the projection reads /charts/:symbol/daily, and handed the first the second's vocabulary — so the escape hatch could not reproduce the payload it exists to diagnose. Measured 2026-09-01 the two do not share a vocabulary: /charts/:symbol REFUSES 1w with 400 "Kurun waktu tidak valid" and answers {chart_points: []} for everything else, while the daily route accepts 1w and answers the rich payload. That is why 1w errored and 1m came back empty — the route was wrong, not the value. Fixed: raw now reads the same route as the projection.
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": {
"symbol": "<symbol>",
"timeframe": "<timeframe>"
},
"name": "chart_series"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| raw | No | Return the unprojected chart payload instead of bars. Default false. | |
| symbol | Yes | IDX ticker, e.g. BBRI | |
| timeframe | Yes | Calendar window, lowercase: 1w, 1m, 3m, ytd, 1y, 3y, 5y. Read granularity to distinguish intraday points from daily bars. |