bitbank-lab-mcp 0.1.0

package/tools/chart/render-depth.ts

@@ -0,0 +1,139 @@
+/**
+ * chart/render-depth — Depth チャート（板の深度）の SVG 描画。
+ *
+ * メインのローソク足チャートとは完全に独立したコードパス。
+ */
+
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { formatPair } from '../../lib/formatter.js';
+import getDepth from '../../lib/get-depth.js';
+import { fail, ok } from '../../lib/result.js';
+import type { Pair, Result } from '../../src/schemas.js';
+
+type RenderData = { svg?: string; filePath?: string; legend?: Record<string, string> };
+type RenderMeta = {
+	pair: Pair;
+	type: string;
+	bbMode: 'default' | 'extended';
+	[key: string]: unknown;
+};
+
+export async function renderDepthChart(
+	pair: string,
+	args: { depth?: { levels?: number }; type?: string },
+	effectivePrecision: number,
+): Promise<Result<RenderData, RenderMeta>> {
+	try {
+		const depth = await getDepth(pair, { maxLevels: args.depth?.levels ?? 200 });
+		if (!depth.ok) return fail(depth.summary.replace(/^Error: /, ''), depth.meta?.errorType || 'internal');
+		const asks: Array<[string, string]> = depth.data.asks || [];
+		const bids: Array<[string, string]> = depth.data.bids || [];
+		// 価格レンジ
+		const minBid = Number(bids[bids.length - 1]?.[0] ?? bids[0]?.[0] ?? 0);
+		const maxAsk = Number(asks[asks.length - 1]?.[0] ?? asks[0]?.[0] ?? 0);
+		const xMinP = Math.min(minBid, Number(bids[0]?.[0] ?? minBid));
+		const xMaxP = Math.max(maxAsk, Number(asks[0]?.[0] ?? maxAsk));
+		// 累積量（左：bids 降順→小へ、右：asks 昇順→大へ）
+		const bidsSorted = [...bids]
+			.map(([p, s]) => [Number(p), Number(s)] as [number, number])
+			.sort((a, b) => b[0] - a[0]);
+		const asksSorted = [...asks]
+			.map(([p, s]) => [Number(p), Number(s)] as [number, number])
+			.sort((a, b) => a[0] - b[0]);
+		let cum = 0;
+		const bidSteps: Array<[number, number]> = [];
+		for (const [p, s] of bidsSorted) {
+			cum += s;
+			bidSteps.push([p, cum]);
+		}
+		cum = 0;
+		const askSteps: Array<[number, number]> = [];
+		for (const [p, s] of asksSorted) {
+			cum += s;
+			askSteps.push([p, cum]);
+		}
+		const maxQty = Math.max(bidSteps.at(-1)?.[1] || 0, askSteps.at(-1)?.[1] || 0) || 1;
+
+		// キャンバス
+		const w = 860,
+			h = 420;
+		const padding = { top: 36, right: 12, bottom: 32, left: 64 };
+		const plotW = w - padding.left - padding.right;
+		const plotH = h - padding.top - padding.bottom;
+		const x = (price: number) =>
+			Number((padding.left + ((price - xMinP) * plotW) / Math.max(1, xMaxP - xMinP)).toFixed(effectivePrecision));
+		const y = (qty: number) => Number((h - padding.bottom - (qty * plotH) / maxQty).toFixed(effectivePrecision));
+
+		// ステップパス生成
+		const toStepPath = (steps: Array<[number, number]>) => {
+			if (!steps.length) return '';
+			const pts = steps.map(([p, q]) => `${x(p)},${y(q)}`);
+			return `M ${pts.join(' L ')}`;
+		};
+		const bidPath = toStepPath(bidSteps);
+		const askPath = toStepPath(askSteps);
+
+		// 塗りつぶし（ステップ下を半透明で）
+		const toFillPath = (steps: Array<[number, number]>, side: 'bid' | 'ask') => {
+			if (!steps.length) return '';
+			const head = steps[0];
+			const tail = steps[steps.length - 1];
+			const baseY = y(0);
+			const poly = ['M', `${x(head[0])},${baseY}`, 'L']
+				.concat(steps.map(([p, q]) => `${x(p)},${y(q)}`))
+				.concat(['L', `${x(tail[0])},${baseY}`, 'Z'])
+				.join(' ');
+			const fill = side === 'bid' ? 'rgba(16,185,129,0.12)' : 'rgba(249,115,22,0.12)';
+			return `<path d="${poly}" fill="${fill}" stroke="none"/>`;
+		};
+		const bidFill = toFillPath(bidSteps, 'bid');
+		const askFill = toFillPath(askSteps, 'ask');
+
+		const mid = (Number(bids[0]?.[0] ?? 0) + Number(asks[0]?.[0] ?? 0)) / 2;
+		const yAxis = `
+        <line x1="${padding.left}" y1="${padding.top}" x2="${padding.left}" y2="${h - padding.bottom}" stroke="#4b5563" stroke-width="1"/>
+      `;
+		const xAxis = `
+        <line x1="${padding.left}" y1="${h - padding.bottom}" x2="${w - padding.right}" y2="${h - padding.bottom}" stroke="#4b5563" stroke-width="1"/>
+      `;
+		const legendDepth = `
+        <g font-size="12" fill="#e5e7eb" transform="translate(${padding.left}, ${Math.max(14, padding.top - 18)})">
+          <rect x="0" y="-10" width="12" height="12" fill="#10b981"></rect>
+          <text x="16" y="0">買い (Bids)</text>
+          <rect x="120" y="-10" width="12" height="12" fill="#f97316"></rect>
+          <text x="136" y="0">売り (Asks)</text>
+        </g>`;
+
+		const svg = `
+      <svg width="${w}" height="${h}" viewBox="0 0 ${w} ${h}" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" style="background-color:#1f2937;color:#e5e7eb;font-family:sans-serif;max-width:100%;height:auto;">
+        <title>${formatPair(pair)} depth chart</title>
+        ${legendDepth}
+        <g class="axes">${yAxis}${xAxis}</g>
+        <g class="plot-area">
+          ${bidFill}
+          ${askFill}
+          <path d="${bidPath}" fill="none" stroke="#10b981" stroke-width="2"/>
+          <path d="${askPath}" fill="none" stroke="#f97316" stroke-width="2"/>
+          <line x1="${x(mid)}" y1="${padding.top}" x2="${x(mid)}" y2="${h - padding.bottom}" stroke="#9ca3af" stroke-width="1" stroke-dasharray="4 4"/>
+        </g>
+      </svg>`;
+		const assetsDir = path.join(process.cwd(), 'assets');
+		await fs.mkdir(assetsDir, { recursive: true });
+		const outputPath = path.join(assetsDir, `depth-${pair}-${Date.now()}.svg`);
+		await fs.writeFile(outputPath, svg);
+		const metaOut: RenderMeta = {
+			pair: pair as Pair,
+			type: String(args.type || '1day'),
+			bbMode: 'default',
+		};
+		return ok<RenderData, RenderMeta>(
+			`${formatPair(pair)} depth chart saved to ${outputPath}`,
+			{ filePath: outputPath, svg },
+			metaOut,
+		);
+	} catch (e: unknown) {
+		const msg = e instanceof Error ? e.message : String(e);
+		return fail(msg || 'failed to render depth', 'internal');
+	}
+}

package/tools/chart/render-sub-panels.ts

@@ -0,0 +1,208 @@
+/**
+ * chart/render-sub-panels — MACD / RSI / Volume のサブパネル SVG 描画。
+ */
+
+import { RSI_OVERBOUGHT, RSI_OVERSOLD } from '../../lib/indicator-config.js';
+import { niceTicks } from './svg-utils.js';
+
+// ── Configuration ──
+const RSI_MIDLINE = 50;
+const PRICE_PANEL_HEIGHT = 420;
+
+/** サブパネル描画に必要なコンテキスト */
+export interface SubPanelContext {
+	x: (i: number) => number;
+	padding: { top: number; right: number; bottom: number; left: number };
+	plotW: number;
+	w: number;
+	barW: number;
+	effectivePrecision: number;
+	pastBuffer: number;
+	displayItems: Array<{ open: number; close: number; volume?: number; [k: string]: unknown }>;
+	indicators: Record<string, unknown> | undefined;
+}
+
+const SUB_PANEL_HEIGHT = 120;
+const SUB_PANEL_GAP = 24;
+const LEGEND_H = 18;
+
+function subPanelY(v: number, min: number, max: number, top: number, precision: number): number {
+	const dataH = SUB_PANEL_HEIGHT - LEGEND_H;
+	const range = Math.max(1e-10, max - min);
+	return Number((top + SUB_PANEL_HEIGHT - ((v - min) * dataH) / range).toFixed(precision));
+}
+
+export function renderSubPanels(
+	panelTypes: Array<'macd' | 'rsi' | 'volume'>,
+	ctx: SubPanelContext,
+): { svg: string; totalHeight: number } {
+	if (panelTypes.length === 0) return { svg: '', totalHeight: 0 };
+
+	const { padding, plotW, w } = ctx;
+	const h = PRICE_PANEL_HEIGHT;
+	const pricePanelBottom = h - padding.bottom;
+	let currentTop = pricePanelBottom + SUB_PANEL_GAP;
+	let svgOut = '';
+
+	for (const panelType of panelTypes) {
+		const panelBottom = currentTop + SUB_PANEL_HEIGHT;
+		let pc = '';
+		pc += `<rect x="${padding.left}" y="${currentTop}" width="${plotW}" height="${SUB_PANEL_HEIGHT}" fill="rgba(255,255,255,0.02)"/>`;
+		pc += `<line x1="${padding.left}" y1="${currentTop}" x2="${w - padding.right}" y2="${currentTop}" stroke="#374151" stroke-width="0.5"/>`;
+
+		if (panelType === 'macd') {
+			pc += renderMacdPanel(currentTop, ctx);
+		} else if (panelType === 'rsi') {
+			pc += renderRsiPanel(currentTop, ctx);
+		} else if (panelType === 'volume') {
+			pc += renderVolumePanel(currentTop, ctx);
+		}
+
+		pc += `<line x1="${padding.left}" y1="${currentTop}" x2="${padding.left}" y2="${panelBottom}" stroke="#4b5563" stroke-width="1"/>`;
+		svgOut += pc;
+		currentTop = panelBottom + SUB_PANEL_GAP;
+	}
+
+	const totalHeight = panelTypes.length * SUB_PANEL_HEIGHT + panelTypes.length * SUB_PANEL_GAP;
+	return { svg: svgOut, totalHeight };
+}
+
+function renderMacdPanel(currentTop: number, ctx: SubPanelContext): string {
+	const { x, padding, w, barW, effectivePrecision, pastBuffer, displayItems, indicators } = ctx;
+	const py = (v: number, yMin: number, yMax: number) => subPanelY(v, yMin, yMax, currentTop, effectivePrecision);
+	let pc = '';
+
+	const ms = indicators?.macd_series as { line?: number[]; signal?: number[]; hist?: number[] } | undefined;
+	const mLine = (ms?.line || []) as Array<number | null>;
+	const mSig = (ms?.signal || []) as Array<number | null>;
+	const mHist = (ms?.hist || []) as Array<number | null>;
+	const vals: number[] = [];
+	for (const s of [mLine, mSig, mHist]) {
+		const sliced = s.slice(pastBuffer);
+		for (let i = 0; i < sliced.length; i++) {
+			const v = sliced[i];
+			if (v != null && i < displayItems.length) vals.push(v as number);
+		}
+	}
+	if (vals.length > 0) {
+		const mMin = Math.min(...vals);
+		const mMax = Math.max(...vals);
+		const pad = (mMax - mMin) * 0.1 || 1;
+		const yMin = mMin - pad;
+		const yMax = mMax + pad;
+
+		if (yMin < 0 && yMax > 0) {
+			pc += `<line x1="${padding.left}" y1="${py(0, yMin, yMax)}" x2="${w - padding.right}" y2="${py(0, yMin, yMax)}" stroke="#4b5563" stroke-width="0.5" stroke-dasharray="4 4"/>`;
+		}
+		const hBarW = Math.max(1, barW * 0.7);
+		mHist.forEach((val, i) => {
+			if (val == null) return;
+			const idx = i - pastBuffer;
+			if (idx < 0 || idx >= displayItems.length) return;
+			const cx = x(idx);
+			const topY = py(val as number, yMin, yMax);
+			const zeroY = py(0, yMin, yMax);
+			const color = (val as number) >= 0 ? 'rgba(34,197,94,0.6)' : 'rgba(239,68,68,0.6)';
+			pc += `<rect x="${Number((cx - hBarW / 2).toFixed(1))}" y="${Math.min(topY, zeroY)}" width="${Number(hBarW.toFixed(1))}" height="${Math.max(1, Math.abs(topY - zeroY))}" fill="${color}"/>`;
+		});
+		const lPts: string[] = [];
+		mLine.forEach((v, i) => {
+			if (v != null) {
+				const idx = i - pastBuffer;
+				if (idx >= 0 && idx < displayItems.length) lPts.push(`${x(idx)},${py(v as number, yMin, yMax)}`);
+			}
+		});
+		if (lPts.length > 1) pc += `<path d="M ${lPts.join(' L ')}" fill="none" stroke="#3b82f6" stroke-width="1.5"/>`;
+		const sPts: string[] = [];
+		mSig.forEach((v, i) => {
+			if (v != null) {
+				const idx = i - pastBuffer;
+				if (idx >= 0 && idx < displayItems.length) sPts.push(`${x(idx)},${py(v as number, yMin, yMax)}`);
+			}
+		});
+		if (sPts.length > 1) pc += `<path d="M ${sPts.join(' L ')}" fill="none" stroke="#f97316" stroke-width="1.5"/>`;
+		const mt = niceTicks(yMin, yMax, 3);
+		mt.forEach((v) => {
+			pc += `<text x="${padding.left - 8}" y="${py(v, yMin, yMax)}" text-anchor="end" dominant-baseline="middle" fill="#9ca3af" font-size="10">${v.toFixed(0)}</text>`;
+		});
+	}
+	pc += `<text x="${padding.left + 4}" y="${currentTop + 12}" fill="#9ca3af" font-size="10" font-weight="bold">MACD</text>`;
+	pc += `<line x1="${padding.left + 50}" y1="${currentTop + 8}" x2="${padding.left + 62}" y2="${currentTop + 8}" stroke="#3b82f6" stroke-width="1.5"/>`;
+	pc += `<text x="${padding.left + 65}" y="${currentTop + 12}" fill="#9ca3af" font-size="9">MACD</text>`;
+	pc += `<line x1="${padding.left + 100}" y1="${currentTop + 8}" x2="${padding.left + 112}" y2="${currentTop + 8}" stroke="#f97316" stroke-width="1.5"/>`;
+	pc += `<text x="${padding.left + 115}" y="${currentTop + 12}" fill="#9ca3af" font-size="9">Signal</text>`;
+	return pc;
+}
+
+function renderRsiPanel(currentTop: number, ctx: SubPanelContext): string {
+	const { x, padding, plotW, w, effectivePrecision, pastBuffer, displayItems, indicators } = ctx;
+	const rMin = 0,
+		rMax = 100;
+	const py = (v: number) => subPanelY(v, rMin, rMax, currentTop, effectivePrecision);
+	let pc = '';
+
+	const rsiSeries = (indicators?.RSI_14_series || []) as Array<number | null>;
+	pc += `<rect x="${padding.left}" y="${py(100)}" width="${plotW}" height="${Math.abs(py(RSI_OVERBOUGHT) - py(100))}" fill="rgba(239,68,68,0.06)"/>`;
+	pc += `<rect x="${padding.left}" y="${py(RSI_OVERSOLD)}" width="${plotW}" height="${Math.abs(py(0) - py(RSI_OVERSOLD))}" fill="rgba(34,197,94,0.06)"/>`;
+	(
+		[
+			{ v: RSI_OVERBOUGHT, c: '#ef4444', d: '2 2' },
+			{ v: RSI_MIDLINE, c: '#4b5563', d: '4 4' },
+			{ v: RSI_OVERSOLD, c: '#22c55e', d: '2 2' },
+		] as const
+	).forEach(({ v, c, d }) => {
+		pc += `<line x1="${padding.left}" y1="${py(v)}" x2="${w - padding.right}" y2="${py(v)}" stroke="${c}" stroke-width="0.5" stroke-dasharray="${d}"/>`;
+	});
+	const rPts: string[] = [];
+	rsiSeries.forEach((v, i) => {
+		if (v != null) {
+			const idx = i - pastBuffer;
+			if (idx >= 0 && idx < displayItems.length) rPts.push(`${x(idx)},${py(v as number)}`);
+		}
+	});
+	if (rPts.length > 1) pc += `<path d="M ${rPts.join(' L ')}" fill="none" stroke="#a78bfa" stroke-width="1.5"/>`;
+	[0, RSI_OVERSOLD, RSI_MIDLINE, RSI_OVERBOUGHT, 100].forEach((v) => {
+		pc += `<text x="${padding.left - 8}" y="${py(v)}" text-anchor="end" dominant-baseline="middle" fill="#9ca3af" font-size="10">${v}</text>`;
+	});
+	pc += `<text x="${padding.left + 4}" y="${currentTop + 12}" fill="#9ca3af" font-size="10" font-weight="bold">RSI (14)</text>`;
+	pc += `<line x1="${padding.left + 65}" y1="${currentTop + 8}" x2="${padding.left + 77}" y2="${currentTop + 8}" stroke="#a78bfa" stroke-width="1.5"/>`;
+	pc += `<text x="${padding.left + 80}" y="${currentTop + 12}" fill="#9ca3af" font-size="9">RSI</text>`;
+	return pc;
+}
+
+function renderVolumePanel(currentTop: number, ctx: SubPanelContext): string {
+	const { x, padding, effectivePrecision, displayItems, barW } = ctx;
+	const volumes = displayItems.map((d) => (d.volume as number) || 0);
+	const vMax = Math.max(...volumes) || 1;
+	const py = (v: number) => subPanelY(v, 0, vMax, currentTop, effectivePrecision);
+	let pc = '';
+
+	volumes.forEach((vol, i) => {
+		if (vol <= 0) return;
+		const cx = x(i);
+		const topY = py(vol);
+		const bottomY = py(0);
+		const up = displayItems[i].close >= displayItems[i].open;
+		const color = up ? 'rgba(34,197,94,0.5)' : 'rgba(239,68,68,0.5)';
+		const vBarW = barW;
+		pc += `<rect x="${Number((cx - vBarW / 2).toFixed(1))}" y="${topY}" width="${Number(vBarW.toFixed(1))}" height="${Math.max(1, bottomY - topY)}" fill="${color}"/>`;
+	});
+	const vt = niceTicks(0, vMax, 3);
+	vt.forEach((v) => {
+		const label =
+			v >= 1e9
+				? `${(v / 1e9).toFixed(1)}B`
+				: v >= 1e6
+					? `${(v / 1e6).toFixed(1)}M`
+					: v >= 1e3
+						? `${(v / 1e3).toFixed(0)}K`
+						: v.toFixed(0);
+		pc += `<text x="${padding.left - 8}" y="${py(v)}" text-anchor="end" dominant-baseline="middle" fill="#9ca3af" font-size="10">${label}</text>`;
+	});
+	pc += `<text x="${padding.left + 4}" y="${currentTop + 12}" fill="#9ca3af" font-size="10" font-weight="bold">Volume</text>`;
+	pc += `<rect x="${padding.left + 55}" y="${currentTop + 4}" width="8" height="8" fill="rgba(34,197,94,0.5)"/>`;
+	pc += `<text x="${padding.left + 66}" y="${currentTop + 12}" fill="#9ca3af" font-size="9">Up</text>`;
+	pc += `<rect x="${padding.left + 85}" y="${currentTop + 4}" width="8" height="8" fill="rgba(239,68,68,0.5)"/>`;
+	pc += `<text x="${padding.left + 96}" y="${currentTop + 12}" fill="#9ca3af" font-size="9">Down</text>`;
+	return pc;
+}

package/tools/chart/svg-utils.ts

@@ -0,0 +1,102 @@
+/**
+ * chart/svg-utils — SVG チャート描画で共通利用するユーティリティ。
+ *
+ * 全関数は純粋関数（副作用なし）。
+ */
+
+// ── Y 軸目盛り ──
+
+/** Y 軸スケール用の "きれいな" 目盛りを生成する */
+export function niceTicks(min: number, max: number, count = 5): number[] {
+	if (max < min) [min, max] = [max, min];
+	const range = max - min;
+	if (range === 0) return [min];
+
+	const step = Math.max(1e-9, 10 ** Math.floor(Math.log10(range / count)));
+	const err = (count * step) / range;
+
+	let niceStep: number;
+	if (err <= 0.15) niceStep = step * 10;
+	else if (err <= 0.35) niceStep = step * 5;
+	else if (err <= 0.75) niceStep = step * 2;
+	else niceStep = step;
+
+	const precision = Math.max(0, -Math.floor(Math.log10(niceStep)));
+	const niceMin = Math.round(min / niceStep) * niceStep;
+	const ticks: number[] = [];
+	for (let v = niceMin; ticks.length < 20 && v <= max * 1.01; v += niceStep) {
+		ticks.push(Number(v.toFixed(precision)));
+	}
+
+	return ticks;
+}
+
+/** Y 軸ラベルの省略表示フォーマッタ */
+export function formatYLabel(val: number, isJpyPair: boolean): string {
+	const abs = Math.abs(val);
+	const prefix = isJpyPair ? '¥' : '';
+	if (abs >= 1_000_000_000) return `${prefix}${(val / 1_000_000_000).toFixed(1)}B`;
+	if (abs >= 1_000_000) return `${prefix}${(val / 1_000_000).toFixed(abs >= 10_000_000 ? 1 : 2)}M`;
+	if (abs >= 10_000) return `${prefix}${(val / 1_000).toFixed(abs >= 100_000 ? 0 : 1)}K`;
+	if (abs >= 1_000) return `${prefix}${val.toLocaleString('ja-JP')}`;
+	return `${prefix}${val}`;
+}
+
+// ── ポイント簡略化 ──
+
+export type Pt = { x: number; y: number };
+
+/** RDP 風のポイント簡略化 */
+export function simplifyPts(raw: Pt[], tolerance: number): Pt[] {
+	if (tolerance <= 0 || raw.length <= 2) return raw;
+	const sqTol = tolerance * tolerance;
+	const simplified: Pt[] = [raw[0]];
+	for (let i = 1; i < raw.length - 1; i++) {
+		const a = raw[i - 1],
+			b = raw[i],
+			c = raw[i + 1];
+		const area = Math.abs((b.x - a.x) * (c.y - a.y) - (b.y - a.y) * (c.x - a.x));
+		const dx = c.x - a.x;
+		const dy = c.y - a.y;
+		const len2 = dx * dx + dy * dy || 1;
+		if ((area * area) / len2 >= sqTol) simplified.push(b);
+	}
+	simplified.push(raw[raw.length - 1]);
+	return simplified;
+}
+
+// ── サニタイゼーション ──
+
+/** SVG 文字列から script タグと on* イベントハンドラを除去 */
+export function sanitizeSvg(s: string): string {
+	return s
+		.replace(/<script[\s\S]*?>[\s\S]*?<\/script>/gi, '')
+		.replace(/\son[a-z]+="[^"]*"/gi, '')
+		.replace(/\son[a-z]+='[^']*'/gi, '');
+}
+
+// ── カラーマップ ──
+
+export const smaColors: Record<number, string> = {
+	5: '#f472b6',
+	20: '#a78bfa',
+	25: '#3b82f6',
+	50: '#22d3ee',
+	75: '#f59e0b',
+	200: '#10b981',
+};
+
+export const emaColors: Record<number, string> = {
+	12: '#ff6b35',
+	26: '#ffd166',
+	50: '#ef476f',
+	200: '#06d6a0',
+};
+
+export const bbColors = {
+	bandFill2: 'rgba(59, 130, 246, 0.10)',
+	line1: '#9ca3af',
+	line2: '#3b82f6',
+	line3: '#f59e0b',
+	middle: '#9ca3af',
+} as const;