get_flow_metrics
Compute CVD, aggressor ratio, and buy-sell pressure from trade data for crypto pairs. Specify hours for time range or limit for trade count.
Instructions
[Flow / CVD / Buy-Sell Pressure] 資金フロー分析（flow / CVD / aggressor ratio / buy-sell pressure）。約定データからCVD・アグレッサー比・スパイクを検出。hours（推奨）で時間範囲指定、または limit で件数指定。
データソース制約（bitbank 側仕様）: 約定アーカイブ /transactions/{YYYYMMDD} は UTC 暦日単位で、当該 UTC 日の完了後にのみ公開される。進行中の UTC 日（JST 09:00 で切り替わる）の約定は /transactions (latest, 直近約60件) でしか取得できないため、当日区間のカバレッジは限定的（warning で明示される）。
加工契約:
内部で使用する約定列は、取得パスに関わらず timestampMs 昇順にソート済み。
latest と date ベースをマージする場合、重複除去キーは
timestampMs:price:amount:side（transaction_id は使用しない: 同一約定でも上流エンドポイント間で ID が一致しないケースがあるため）。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tz | No | Asia/Tokyo | |
| date | No | YYYYMMDD; omit for latest | |
| pair | No | btc_jpy | |
| view | No | view は content の量を制御します。量は summary < detailed < full の順で、full は常にそのツールの最重量です。view が structuredContent から**フィールドを削ることはありません**（その view でしか計算しないデータを足すツールはあり、その場合は当該 view の説明に明記しています）。content[0].text は LLM への唯一のチャネルなので、軽い view は「短い表示」ではなく「LLM が明細を受け取らない」を意味します。 本ツールの主対象はバケット列なので、view が決めるのは content のバケット行の量です（集計値・警告・フッタは全 view に出ます）。 - summary（既定）: 集計値のみ。バケット行は content に出ない。 - detailed: 集計値 ＋ 直近 bucketsN 件のバケット行（既定 10 / 上限 100）。それより前のバケット行は content に出ない。 - full: 集計値 ＋ 全バケット行。本ツールの最重量。 - compact: 非推奨。view=full + nonZeroOnly=true を使うこと。0.6.0 で削除予定。挙動は view=full + nonZeroOnly=true と同じ。 - buckets: 非推奨。view=detailed を使うこと。0.6.0 で削除予定。挙動は view=detailed と同じ。 | summary |
| hours | No | 指定した時間数分の約定を取得して分析（例: 8 → 直近8時間）。limit より優先。複数日にまたがる場合も自動で取得します | |
| limit | No | 取得する約定件数（バケット数ではない）。hours 指定時は無視されます | |
| bucketMs | No | バケットの時間幅（ミリ秒）。デフォルト60000=1分間隔 | |
| bucketsN | No | view=detailed（および deprecated な view=buckets）で content に出す直近バケット行の件数。他の view では無視されます。 | |
| nonZeroOnly | No | true にすると content のバケット行を非ゼロ（buy または sell > 0）のみに絞ります。量ではなく絞り込みの軸なので view とは独立に指定できます。約定が 1 件も無かった区間のバケットは出来高 0 なので content から落ちます（structuredContent には残るので、区間の連続性はそちらで確認できます）。structuredContent は変わりません（全バケットのまま）。view=summary との併用は no-op（バケット行が無いため。エラーにはしません）。 |