get_candles
Fetch OHLCV candlestick data from bitbank for intervals from 1 minute to 1 month. Provide a trading pair, timeframe, date, and limit to obtain historical candles for chart analysis or backtesting.
Instructions
[Candles / OHLCV / Candlestick] ローソク足（candles / OHLCV / chart data）を取得。1min〜1monthの各時間足に対応。date は tz（既定 Asia/Tokyo）の暦日として解釈し、その終端以前の limit 本を返す。 詳細は inputSchema を参照。
【重要】バックテストには run_backtest を使用（データ取得〜チャート描画を一括実行）。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tz | No | タイムゾーン（既定 Asia/Tokyo）。date パラメータの暦日解釈、isoTimeLocal、keyPoints.date、priceRange.periodStart/End の表示に使用。isoTime は常に UTC ISO。空文字も Asia/Tokyo にフォールバック。UTC が必要な場合は明示的に "UTC" を渡す。 | Asia/Tokyo |
| date | No | type により形式が異なる: - 1min/5min/15min/30min/1hour → YYYYMMDD（例: 20251022） - 4hour/8hour/12hour/1day/1week/1month → YYYY（例: 2025） date=YYYYMMDD は tz（既定 Asia/Tokyo）の暦日として解釈します。指定日の終端（23:59:59.999 in tz）以前の limit 本を返します。limit は日数ではなくローソク足本数です。例: 1hour, date=20251002, limit=24 は指定 tz の 10/2 24 本（00:00〜23:00）。 省略時は最新。 （互換: 年足系で YYYYMMDD を渡した場合は先頭4桁を年として使用） | |
| pair | Yes | ||
| type | Yes | ||
| view | No | view は content の量を制御します。量は summary < detailed < full の順で、full は常にそのツールの最重量です。view が structuredContent から**フィールドを削ることはありません**（その view でしか計算しないデータを足すツールはあり、その場合は当該 view の説明に明記しています）。content[0].text は LLM への唯一のチャネルなので、軽い view は「短い表示」ではなく「LLM が明細を受け取らない」を意味します。 - full（既定）: サマリ本文（全 OHLCV を 1 行 1 本の圧縮形式で列挙）＋ 価格レンジ / キーポイント / 出来高統計 / フッタ ＋ 先頭 5 本の JSON サンプル。本ツールの最重量。 - items: 非推奨。view=full + format=json を使うこと。0.6.0 で削除予定。挙動は view=full + format=json と同じ（content は全件の pretty JSON のみで、サマリ本文・価格レンジ・キーポイント・出来高統計・フッタは出ない）。 集計だけを返す軽量 summary は未実装（量を絞る手段は limit）。 | full |
| limit | No | デフォルト 200。1〜10000 の整数。type により実上限が変わる: 1min〜1hour は最大 10000（複数日取得）、4hour〜1month は最大 5000（複数年取得）、それ以外は 1000。実上限を超えると user エラー。 | |
| format | No | content の形式。text（既定）: 散文 / json: pretty JSON。json は機械可読性のために**トークンを払う**オプションで、同じデータでも text より必ず多くなります（削減オプションではありません）。量は format ではなく view と limit が決めます。 | text |