bitbank-lab-mcp 0.1.0

package/lib/formatter.ts

@@ -0,0 +1,296 @@
+import { dayjs, toDisplayTime } from './datetime.js';
+
+/** 時間足コードを日本語ラベルに変換 */
+export function timeframeLabel(type: string): string {
+	const map: Record<string, string> = {
+		'1min': '1分足',
+		'5min': '5分足',
+		'15min': '15分足',
+		'30min': '30分足',
+		'1hour': '1時間足',
+		'4hour': '4時間足',
+		'8hour': '8時間足',
+		'12hour': '12時間足',
+		'1day': '日足',
+		'1week': '週足',
+		'1month': '月足',
+	};
+	return map[type] || type;
+}
+
+export function formatPair(pair: string): string {
+	return (pair || '').toUpperCase().replace('_', '/');
+}
+
+/**
+ * タイムスタンプをJST表示形式に変換
+ * @param ts タイムスタンプ（ミリ秒）。未指定時は現在時刻
+ * @param tz タイムゾーン（デフォルト: 'Asia/Tokyo'）
+ * @returns "2025/11/24 15:32:45 JST" 形式
+ */
+export function formatTimestampJST(ts?: number, tz: string = 'Asia/Tokyo'): string {
+	const result = toDisplayTime(ts, tz);
+	return result ?? dayjs(ts).toISOString();
+}
+
+/**
+ * 価格フォーマット（¥プレフィックス、ペア依存）
+ * JPY ペア → ¥123,456  /  non-JPY → 0.123456
+ * pair 省略時は JPY として扱う
+ */
+export function formatPrice(value: number | null | undefined, pair?: string): string {
+	if (value == null || !Number.isFinite(Number(value))) return 'N/A';
+	const n = Number(value);
+	const jpy = !pair || (typeof pair === 'string' && pair.toLowerCase().includes('jpy'));
+	if (jpy) return `¥${n.toLocaleString('ja-JP')}`;
+	return n.toLocaleString('ja-JP');
+}
+
+/**
+ * 価格フォーマット（円サフィックス、四捨五入）
+ * → 123,456円
+ */
+export function formatPriceJPY(value: number | null | undefined): string {
+	if (value == null || !Number.isFinite(Number(value))) return 'n/a';
+	return `${Math.round(Number(value)).toLocaleString('ja-JP')}円`;
+}
+
+/**
+ * 通貨フォーマット（JPY/非JPY対応、スペース＋通貨コード）
+ * JPY → 123,456 JPY  /  非JPY → 0.12
+ */
+export function formatCurrency(value: number | null | undefined, pair?: string): string {
+	if (value == null) return 'n/a';
+	const jpy = !pair || (typeof pair === 'string' && pair.toLowerCase().includes('jpy'));
+	return jpy ? `${Number(value).toLocaleString('ja-JP')} JPY` : `${Number(value).toFixed(2)}`;
+}
+
+/**
+ * 通貨フォーマット短縮形（大きな値はk表示）
+ * JPY ≥1000 → 12k JPY  /  JPY <1000 → 123 JPY  /  非JPY → 0.12
+ */
+export function formatCurrencyShort(value: number | null | undefined, pair?: string): string {
+	if (value == null) return 'n/a';
+	const jpy = !pair || (typeof pair === 'string' && pair.toLowerCase().includes('jpy'));
+	if (jpy) {
+		const n = Number(value);
+		return n >= 1000 ? `${Math.round(n / 1000)}k JPY` : `${n.toLocaleString('ja-JP')} JPY`;
+	}
+	return `${Number(value).toFixed(2)}`;
+}
+
+/**
+ * パーセンテージフォーマット
+ * @param value 数値
+ * @param opts.digits 小数桁数（デフォルト: 1）
+ * @param opts.sign 正数に+を付けるか（デフォルト: false）
+ * @param opts.multiply 100倍するか（デフォルト: false）。0-1小数→%変換に使う
+ */
+export function formatPercent(
+	value: number | null | undefined,
+	opts: { digits?: number; sign?: boolean; multiply?: boolean } = {},
+): string {
+	if (value == null || !Number.isFinite(Number(value))) return 'n/a';
+	const { digits = 1, sign = false, multiply = false } = opts;
+	const v = multiply ? Number(value) * 100 : Number(value);
+	const prefix = sign && v >= 0 ? '+' : '';
+	return `${prefix}${v.toFixed(digits)}%`;
+}
+
+/**
+ * 出来高フォーマット（日本円単位、億円/万円）
+ */
+export function formatVolumeJPY(value: number | null | undefined): string {
+	if (value == null || !Number.isFinite(value)) return 'n/a';
+	if (value >= 100_000_000) return `${(value / 100_000_000).toFixed(1)}億円`;
+	return `${Math.round(value / 10_000)}万円`;
+}
+
+// ── unknown 型安全フォーマッタ（デバッグ・パターン検出向け） ──
+
+/**
+ * unknown 値を固定小数点で整形（デバッグ表示用）
+ * @param v 値（unknown 型対応、NaN/null/undefined → 'n/a'）
+ * @param digits 小数桁数（デフォルト: 8）
+ */
+export function formatFixed(v: unknown, digits = 8): string {
+	if (v == null) return 'n/a';
+	const n = Number(v);
+	return Number.isFinite(n) ? n.toFixed(digits) : 'n/a';
+}
+
+/**
+ * unknown 値を四捨五入してロケール整形
+ * @param v 値（unknown 型対応、NaN/null/undefined → 'n/a'）
+ */
+export function formatRounded(v: unknown): string {
+	if (v == null) return 'n/a';
+	const n = Number(v);
+	return Number.isFinite(n) ? Math.round(n).toLocaleString('ja-JP') : 'n/a';
+}
+
+/**
+ * unknown 値をそのまま文字列化（整数表示用）
+ * @param v 値（unknown 型対応、NaN/null/undefined → 'n/a'）
+ */
+export function formatInt(v: unknown): string {
+	if (v == null) return 'n/a';
+	const n = Number(v);
+	return Number.isFinite(n) ? String(n) : 'n/a';
+}
+
+/**
+ * unknown 値を比率（0-1）からパーセント整形
+ * 例: 0.05 → "5.0%"
+ * @param v 値（unknown 型対応、NaN/null/undefined → 'n/a'）
+ * @param digits 小数桁数（デフォルト: 1）
+ */
+export function formatPctFromRatio(v: unknown, digits = 1): string {
+	if (v == null) return 'n/a';
+	const n = Number(v);
+	return Number.isFinite(n) ? `${(n * 100).toFixed(digits)}%` : 'n/a';
+}
+
+// ── トレンド方向シンボル ──
+
+/**
+ * 傾き（slope）から方向絵文字を返す
+ * 正→📈  負→📉  ゼロ/null→➡️
+ */
+export function formatTrendSymbol(slope: number | null | undefined): string {
+	if (slope == null) return '➡️';
+	return slope > 0 ? '📈' : slope < 0 ? '📉' : '➡️';
+}
+
+/**
+ * 値の基準値との比較で矢印を返す（ボラティリティ推移など）
+ * @param val 現在値
+ * @param base 基準値
+ * @param threshold 有意差の閾値（デフォルト: 0.05 = 5%）
+ */
+export function formatTrendArrow(
+	val: number | null | undefined,
+	base: number | null | undefined,
+	threshold = 0.05,
+): string {
+	if (val == null || base == null) return '→';
+	if (val > base * (1 + threshold)) return '⬆⬆';
+	if (val > base) return '⬆';
+	if (val < base * (1 - threshold)) return '⬇⬇';
+	if (val < base) return '⬇';
+	return '→';
+}
+
+/**
+ * 現在価格に対する基準価格の乖離率を整形
+ * 例: close=100, ref=102 → "+2.0% 上方"
+ * @param close 現在価格
+ * @param ref 基準価格（SMA等）
+ */
+export function formatDeviation(close: number | null, ref: number | null | undefined): string {
+	if (close == null || ref == null || !Number.isFinite(close) || !Number.isFinite(ref) || close === 0) return 'n/a';
+	const pct = ((ref - close) / Math.abs(close)) * 100;
+	if (!Number.isFinite(pct)) return 'n/a';
+	const dir = ref >= close ? '上方' : '下方';
+	return `${formatPercent(pct, { sign: true, digits: 1 })} ${dir}`;
+}
+
+export function formatSummary(
+	args: {
+		pair?: string;
+		timeframe?: string;
+		latest?: number;
+		totalItems?: number;
+		keyPoints?: {
+			today?: { date?: string | null; index: number; close: number } | null;
+			sevenDaysAgo?: { date?: string | null; index: number; close: number; changePct: number | null } | null;
+			thirtyDaysAgo?: { date?: string | null; index: number; close: number; changePct: number | null } | null;
+			ninetyDaysAgo?: { date?: string | null; index: number; close: number; changePct: number | null } | null;
+		};
+		volumeStats?: {
+			recent7DaysAvg: number;
+			previous7DaysAvg: number;
+			last30DaysAvg?: number | null;
+			changePct: number;
+			judgment: string;
+		} | null;
+		extra?: string;
+		// 追加: 全件の範囲情報
+		priceRange?: { high: number; low: number; periodStart: string; periodEnd: string };
+	} = {},
+): string {
+	const { pair, timeframe, latest, totalItems, keyPoints, volumeStats, extra, priceRange } = args;
+	const p = formatPair(pair ?? '');
+	const tf = timeframe ? ` [${timeframe}]` : '';
+	const isJpy = typeof pair === 'string' && pair.toLowerCase().includes('jpy');
+	const currency = isJpy ? '円' : '';
+
+	// 基本情報
+	let summary = p;
+
+	// ローソク足取得の場合（totalItemsが明示的に指定されている場合）
+	if (typeof totalItems === 'number' && totalItems > 0) {
+		summary += `${tf} ローソク足${totalItems}本取得`;
+		summary += `\n⚠️ 配列は古い順: data[0]=最古、data[${totalItems - 1}]=最新`;
+
+		// 全件の範囲情報を追加
+		if (priceRange) {
+			summary += `\n\n📈 全${totalItems}件の価格範囲:`;
+			summary += `\n- 期間: ${priceRange.periodStart} 〜 ${priceRange.periodEnd}`;
+			summary += `\n- 高値: ${formatPrice(priceRange.high)}`;
+			summary += `\n- 安値: ${formatPrice(priceRange.low)}`;
+		}
+	}
+
+	// 期間別の価格推移
+	if (keyPoints && keyPoints.today) {
+		summary += '\n\n📊 期間別の価格推移:';
+
+		const fmtChange = (pct: number | null) => {
+			if (pct === null) return '';
+			return ` → 変化率 ${formatPercent(pct, { sign: true })}`;
+		};
+
+		// 今日
+		const today = keyPoints.today;
+		summary += `\n- 今日 (${today.date || '不明'}, data[${today.index}]): ${formatPrice(today.close)}`;
+
+		// 7日前
+		if (keyPoints.sevenDaysAgo) {
+			const sd = keyPoints.sevenDaysAgo;
+			summary += `\n- 7日前 (${sd.date || '不明'}, data[${sd.index}]): ${formatPrice(sd.close)}${fmtChange(sd.changePct)}`;
+		}
+
+		// 30日前
+		if (keyPoints.thirtyDaysAgo) {
+			const td = keyPoints.thirtyDaysAgo;
+			summary += `\n- 30日前 (${td.date || '不明'}, data[${td.index}]): ${formatPrice(td.close)}${fmtChange(td.changePct)}`;
+		}
+
+		// 90日前
+		if (keyPoints.ninetyDaysAgo) {
+			const nd = keyPoints.ninetyDaysAgo;
+			summary += `\n- 90日前 (${nd.date || '不明'}, data[${nd.index}]): ${formatPrice(nd.close)}${fmtChange(nd.changePct)}`;
+		}
+
+		// 出来高情報
+		if (volumeStats) {
+			summary += '\n\n【出来高推移】';
+			summary += `\n- 直近7日間の平均: ${volumeStats.recent7DaysAvg.toFixed(0)} BTC/日`;
+			summary += `\n- その前7日間の平均: ${volumeStats.previous7DaysAvg.toFixed(0)} BTC/日`;
+			if (typeof volumeStats.last30DaysAvg === 'number') {
+				summary += `\n- 過去30日間の平均: ${volumeStats.last30DaysAvg.toFixed(0)} BTC/日`;
+			}
+			summary += `\n- 出来高変化率: ${volumeStats.changePct >= 0 ? '+' : ''}${volumeStats.changePct}%`;
+			summary += `\n- 判定: ${volumeStats.judgment}`;
+		}
+
+		// 全データは呼び出し元（get_candles.ts 等）がテキストに追記する
+	} else if (typeof latest === 'number') {
+		// keyPointsがない場合（板情報など）は中値を表示
+		summary += ` 中値=${latest.toLocaleString('ja-JP')}${currency}`;
+	}
+
+	const tail = extra ? ` ${extra}` : '';
+	return `${summary}${tail}`.trim();
+}

package/lib/get-depth.ts

@@ -0,0 +1,111 @@
+import { GetDepthOutputSchema } from '../src/schemas.js';
+import { estimateZones } from './depth-analysis.js';
+import { formatSummary, formatTimestampJST } from './formatter.js';
+import { BITBANK_API_BASE, DEFAULT_RETRIES, fetchJsonWithRateLimit } from './http.js';
+import { failFromError, failFromValidation, ok } from './result.js';
+import { createMeta, ensurePair } from './validate.js';
+
+export interface GetDepthOptions {
+	timeoutMs?: number;
+	maxLevels?: number;
+}
+
+export interface BuildDepthTextInput {
+	timestamp: number;
+	summary: string;
+	bids: Array<[unknown, unknown]>;
+	asks: Array<[unknown, unknown]>;
+	mid: number | null;
+}
+
+/** テキスト組み立て（板データ表示）— テスト可能な純粋関数 */
+export function buildDepthText(input: BuildDepthTextInput): string {
+	const { timestamp, summary, bids, asks, mid } = input;
+	const text = [
+		`📸 ${formatTimestampJST(timestamp)}`,
+		'',
+		summary,
+		`板の層数: 買い ${bids.length}層 / 売り ${asks.length}層`,
+		mid ? `中値: ${mid.toLocaleString('ja-JP')}円` : '',
+		'',
+		`🟢 買い板 (全${bids.length}層):`,
+		...bids.map(([p, s]: [unknown, unknown], i: number) => `  ${i + 1}. ${Number(p).toLocaleString('ja-JP')}円 ${s}`),
+		'',
+		`🔴 売り板 (全${asks.length}層):`,
+		...asks.map(([p, s]: [unknown, unknown], i: number) => `  ${i + 1}. ${Number(p).toLocaleString('ja-JP')}円 ${s}`),
+	]
+		.filter(Boolean)
+		.join('\n');
+
+	return (
+		text +
+		`\n\n---\n📌 含まれるもの: 現時点の板（bid/ask全レベル）、壁ゾーン推定` +
+		`\n📌 含まれないもの: 板の時系列変化、約定履歴、テクニカル指標、出来高フロー` +
+		`\n📌 補完ツール: get_orderbook（分析モード付き板情報）, get_flow_metrics（出来高フロー）, get_transactions（約定履歴）`
+	);
+}
+
+export default async function getDepth(pair: string, { timeoutMs = 3000, maxLevels = 200 }: GetDepthOptions = {}) {
+	const chk = ensurePair(pair);
+	if (!chk.ok) return failFromValidation(chk);
+
+	const url = `${BITBANK_API_BASE}/${chk.pair}/depth`;
+	try {
+		const { data: json, rateLimit } = await fetchJsonWithRateLimit(url, { timeoutMs, retries: DEFAULT_RETRIES });
+		const jsonObj = json as { data?: Record<string, unknown> };
+		const d = jsonObj?.data ?? {};
+		const asks = Array.isArray(d.asks) ? d.asks.slice(0, maxLevels) : [];
+		const bids = Array.isArray(d.bids) ? d.bids.slice(0, maxLevels) : [];
+
+		// 簡易サマリ（最良気配と件数）
+		const bestAsk = asks[0]?.[0] ?? null;
+		const bestBid = bids[0]?.[0] ?? null;
+		const mid = bestBid && bestAsk ? Number(((Number(bestBid) + Number(bestAsk)) / 2).toFixed(2)) : null;
+		const summary = formatSummary({
+			pair: chk.pair,
+			latest: mid ?? undefined,
+			extra: `levels: bids=${bids.length} asks=${asks.length}`,
+		});
+
+		const data = {
+			asks,
+			bids,
+			asks_over: d.asks_over,
+			asks_under: d.asks_under,
+			bids_over: d.bids_over,
+			bids_under: d.bids_under,
+			ask_market: d.ask_market,
+			bid_market: d.bid_market,
+			timestamp: Number(d.timestamp ?? d.timestamp_ms ?? Date.now()),
+			sequenceId:
+				d.sequenceId != null ? Number(d.sequenceId) : d.sequence_id != null ? Number(d.sequence_id) : undefined,
+			overlays: {
+				depth_zones: [
+					...estimateZones(
+						bids.slice(0, 50).map(([p, s]: [unknown, unknown]) => [Number(p), Number(s)] as [number, number]),
+						'bid',
+					),
+					...estimateZones(
+						asks.slice(0, 50).map(([p, s]: [unknown, unknown]) => [Number(p), Number(s)] as [number, number]),
+						'ask',
+					),
+				],
+			},
+		};
+
+		// タイムスタンプ付きテキスト出力（全板データを含める: LLM が structuredContent.data を読めない対策）
+		const textWithBoundary = buildDepthText({ timestamp: data.timestamp, summary, bids, asks, mid });
+
+		const meta = createMeta(chk.pair, rateLimit ? { rateLimit } : {});
+		return GetDepthOutputSchema.parse(
+			ok(textWithBoundary, data as Record<string, unknown>, meta as Record<string, unknown>),
+		);
+	} catch (err: unknown) {
+		return failFromError(err, {
+			schema: GetDepthOutputSchema,
+			timeoutMs,
+			defaultType: 'network',
+			defaultMessage: 'ネットワークエラー',
+		}) as ReturnType<typeof GetDepthOutputSchema.parse>;
+	}
+}

package/lib/http.ts

@@ -0,0 +1,132 @@
+/** bitbank Public API ベースURL */
+export const BITBANK_API_BASE = 'https://public.bitbank.cc';
+
+/** fetchJson のデフォルトリトライ回数（初回 + N回） */
+export const DEFAULT_RETRIES = 2;
+
+/** レートリミット情報（レスポンスヘッダから抽出） */
+export interface RateLimitInfo {
+	/** 残りリクエスト数 */
+	remaining: number;
+	/** 期間あたりの上限数 */
+	limit: number;
+	/** リセット時刻（Unix epoch 秒） */
+	reset: number;
+}
+
+/**
+ * レスポンスヘッダからレートリミット情報を抽出する。
+ * ヘッダが存在しない場合は null を返す。
+ */
+export function extractRateLimit(
+	headers: { get(name: string): string | null } | undefined | null,
+): RateLimitInfo | null {
+	if (!headers || typeof headers.get !== 'function') return null;
+	const remaining = headers.get('X-RateLimit-Remaining');
+	const limit = headers.get('X-RateLimit-Limit');
+	const reset = headers.get('X-RateLimit-Reset');
+	if (remaining == null || limit == null || reset == null) return null;
+	const r = parseInt(remaining, 10);
+	const l = parseInt(limit, 10);
+	const s = parseInt(reset, 10);
+	if (Number.isNaN(r) || Number.isNaN(l) || Number.isNaN(s)) return null;
+	return { remaining: r, limit: l, reset: s };
+}
+
+export interface FetchJsonOptions {
+	timeoutMs?: number;
+	retries?: number;
+	/** Zod スキーマ等の parse 互換オブジェクト。指定時はレスポンスをランタイム検証する。 */
+	schema?: { parse: (data: unknown) => unknown };
+}
+
+/** リトライ待機の上限（30秒） */
+const MAX_RETRY_WAIT_MS = 30_000;
+
+/**
+ * Retry-After ヘッダから待機ミリ秒を算出する。
+ * 未指定・不正値の場合はフォールバック値を返す。いずれも MAX_RETRY_WAIT_MS でキャップ。
+ */
+function parseRetryAfterMs(headers: { get(name: string): string | null }, fallbackMs: number): number {
+	const boundedFallbackMs = Math.min(fallbackMs, MAX_RETRY_WAIT_MS);
+	const raw = headers.get('Retry-After');
+	if (raw == null) return boundedFallbackMs;
+	const secs = parseInt(raw, 10);
+	if (Number.isFinite(secs) && secs > 0) return Math.min(secs * 1000, MAX_RETRY_WAIT_MS);
+	return boundedFallbackMs;
+}
+
+export async function fetchJson<T = unknown>(
+	url: string,
+	{ timeoutMs = 2500, retries = DEFAULT_RETRIES, schema }: FetchJsonOptions = {},
+): Promise<T> {
+	let lastErr: unknown;
+	for (let i = 0; i <= retries; i++) {
+		const ctrl = new AbortController();
+		const t = setTimeout(() => ctrl.abort(), timeoutMs);
+		try {
+			const res = await fetch(url, { signal: ctrl.signal });
+			clearTimeout(t);
+			if (res.status === 429) {
+				const waitMs = parseRetryAfterMs(res.headers, 1000 * 2 ** i);
+				if (i < retries) {
+					await new Promise((r) => setTimeout(r, waitMs));
+					continue;
+				}
+				throw new Error('レート制限超過 (HTTP 429)。しばらく待ってから再試行してください');
+			}
+			if (!res.ok) throw new Error(`HTTP ${res.status} ${res.statusText}`);
+			const json: unknown = await res.json();
+			if (schema) return schema.parse(json) as T;
+			return json as T;
+		} catch (e) {
+			clearTimeout(t);
+			lastErr = e;
+			if (i < retries) await new Promise((r) => setTimeout(r, 200 * 2 ** i));
+		}
+	}
+	throw lastErr;
+}
+
+/** fetchJson の戻り値 + レートリミット情報 */
+export interface FetchJsonResult<T> {
+	data: T;
+	rateLimit: RateLimitInfo | null;
+}
+
+/**
+ * fetchJson と同等だが、レスポンスヘッダからレートリミット情報も抽出して返す。
+ * ヘッダが存在しない場合は rateLimit: null。
+ */
+export async function fetchJsonWithRateLimit<T = unknown>(
+	url: string,
+	{ timeoutMs = 2500, retries = DEFAULT_RETRIES, schema }: FetchJsonOptions = {},
+): Promise<FetchJsonResult<T>> {
+	let lastErr: unknown;
+	for (let i = 0; i <= retries; i++) {
+		const ctrl = new AbortController();
+		const t = setTimeout(() => ctrl.abort(), timeoutMs);
+		try {
+			const res = await fetch(url, { signal: ctrl.signal });
+			clearTimeout(t);
+			if (res.status === 429) {
+				const waitMs = parseRetryAfterMs(res.headers, 1000 * 2 ** i);
+				if (i < retries) {
+					await new Promise((r) => setTimeout(r, waitMs));
+					continue;
+				}
+				throw new Error('レート制限超過 (HTTP 429)。しばらく待ってから再試行してください');
+			}
+			if (!res.ok) throw new Error(`HTTP ${res.status} ${res.statusText}`);
+			const rateLimit = extractRateLimit(res.headers);
+			const json: unknown = await res.json();
+			const data = schema ? (schema.parse(json) as T) : (json as T);
+			return { data, rateLimit };
+		} catch (e) {
+			clearTimeout(t);
+			lastErr = e;
+			if (i < retries) await new Promise((r) => setTimeout(r, 200 * 2 ** i));
+		}
+	}
+	throw lastErr;
+}

package/lib/indicator-config.ts

@@ -0,0 +1,39 @@
+/**
+ * テクニカル指標の共有デフォルト値。
+ * 複数ツール（analyze_indicators, render_chart_svg, handler 等）で
+ * 参照される数値を一箇所に集約する。
+ */
+
+// ── RSI ──
+export const RSI_PERIOD = 14;
+export const RSI_OVERBOUGHT = 70;
+export const RSI_OVERSOLD = 30;
+
+// ── Bollinger Bands ──
+export const BB_PERIOD = 20;
+export const BB_STDDEV = 2;
+
+// ── SMA ──
+export const SMA_DEFAULT_PERIOD = 25;
+
+// ── MACD ──
+export const MACD_FAST = 12;
+export const MACD_SLOW = 26;
+export const MACD_SIGNAL = 9;
+
+// ── Stochastic ──
+export const STOCH_PERIOD = 14;
+export const STOCH_SMOOTH_K = 3;
+export const STOCH_SMOOTH_D = 3;
+
+// ── OBV ──
+export const OBV_SMA_PERIOD = 20;
+export const OBV_TREND_THRESHOLD = 0.02;
+
+// ── 一目均衡表 ──
+export const ICHIMOKU_SHIFT = 26;
+export const ICHIMOKU_MIN_BARS_FOR_CLOUD = 60;
+
+// ── キャッシュ ──
+export const INDICATOR_CACHE_TTL_MS = 30_000;
+export const INDICATOR_CACHE_MAX_ENTRIES = 20;

package/lib/indicator_buffer.ts

@@ -0,0 +1,41 @@
+export type IndicatorBufferKey =
+	| 'SMA_5'
+	| 'SMA_20'
+	| 'SMA_25'
+	| 'SMA_50'
+	| 'SMA_75'
+	| 'SMA_200'
+	| 'EMA_12'
+	| 'EMA_26'
+	| 'EMA_50'
+	| 'EMA_200'
+	| 'BB_20'
+	| 'RSI_14'
+	| 'STOCH'
+	| 'ICHIMOKU';
+
+const INDICATOR_PERIODS: Record<IndicatorBufferKey, number> = {
+	SMA_5: 5,
+	SMA_20: 20,
+	SMA_25: 25,
+	SMA_50: 50,
+	SMA_75: 75,
+	SMA_200: 200,
+	EMA_12: 12,
+	EMA_26: 26,
+	EMA_50: 50,
+	EMA_200: 200,
+	BB_20: 20,
+	RSI_14: 15,
+	STOCH: 20,
+	ICHIMOKU: 78,
+};
+
+export function getFetchCount(displayCount: number, indicatorKeys: readonly IndicatorBufferKey[] = []): number {
+	const maxPeriod = indicatorKeys.reduce((max, key) => {
+		const period = INDICATOR_PERIODS[key] || 0;
+		return Math.max(max, period);
+	}, 0);
+	const buffer = maxPeriod > 0 ? maxPeriod - 1 : 0;
+	return displayCount + buffer;
+}