get_candles
Retrieve historical candlestick data (OHLCV) for specified trading pairs and timeframes, with filters for date, limit, and timezone.
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 | full | |
| limit | No | デフォルト 200。1〜10000 の整数。type により実上限が変わる: 1min〜1hour は最大 10000（複数日取得）、4hour〜1month は最大 5000（複数年取得）、それ以外は 1000。実上限を超えると user エラー。 |