get_transactions
Fetch recent or date-specific cryptocurrency trade executions, filter by price or amount, and receive matched transactions with truncation warnings.
Instructions
[Transactions / Trades] 市場の約定履歴(transactions / recent trades)を取得。直近60件 or 日付指定。金額・価格でフィルタ可能(フィルタは limit の前に適用され、条件に合致した約定を最大 limit 件返す)。
limit による切り捨てが起きた場合は meta(totalFetched / matched / returned / truncated / actualRange / fetchedRange)と warning で明示される。
制約(bitbank 側仕様): date 指定(YYYYMMDD)は UTC 暦日アーカイブで、当該 UTC 日の完了後(JST 09:00 以降)にのみ公開される。進行中の UTC 日を指定すると 404。当日分の約定は date 省略(latest, 直近約60件)でのみ取得可能。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | YYYYMMDD。**UTC 暦日**として解釈します(bitbank の約定アーカイブ /transactions/{YYYYMMDD} が UTC 暦日単位のため)。get_candles / validate_candle_data の date が tz 引数の暦日(既定 Asia/Tokyo)である点と基準が異なります。当該 UTC 日の完了後(JST 09:00 以降)に公開されるため、進行中の UTC 日を指定すると 404。省略時は latest(直近約60件)。 | |
| pair | No | btc_jpy | |
| view | No | view は content の量を制御します。量は summary < detailed < full の順で、full は常にそのツールの最重量です。view が structuredContent から**フィールドを削ることはありません**(その view でしか計算しないデータを足すツールはあり、その場合は当該 view の説明に明記しています)。content[0].text は LLM への唯一のチャネルなので、軽い view は「短い表示」ではなく「LLM が明細を受け取らない」を意味します。 - full(既定): 返却した全約定を 1 行 1 件で列挙 + 件数サマリ + 切り捨て警告 + スコープフッタ。本ツールの最重量。 - summary: 非推奨。view=full を使うこと。0.4.0 で削除予定。旧既定値で、実体は full と同じ全件列挙(挙動は完全に不変で、名前だけを階梯に合わせた)。集計のみの軽量 summary は将来別リリースで opt-in 専用として新設予定。 - items: 非推奨。view=full + format=json を使うこと。0.4.0 で削除予定。挙動は view=full + format=json と同じ(content は全件の pretty JSON のみで、件数サマリとスコープフッタは出ない)。 | full |
| limit | No | 返却件数の上限。フィルタ適用後の件数に対して効き、超過分は最新側を残して切り捨て(meta.truncated / warning で明示) | |
| format | No | content の形式。text(既定): 散文 / json: pretty JSON。json は機械可読性のために**トークンを払う**オプションで、同じデータでも text より必ず多くなります(削減オプションではありません)。量は format ではなく view と limit が決めます。 | text |
| maxPrice | No | 約定価格の上限(limit 適用前にフィルタ) | |
| minPrice | No | 約定価格の下限(limit 適用前にフィルタ) | |
| maxAmount | No | 約定数量の上限(limit 適用前にフィルタ) | |
| minAmount | No | 約定数量の下限(limit 適用前にフィルタ) |