TraderMemosトレードのインポート
証券会社の約定を TraderMemos に取り込みます — 列マッピング対応の CSV、ジャーナルのエクスポート、JSON バックアップ。重複は自動的にスキップされます。
サイドバーのインポートを開きます（ホットキー G I）。流れは
アップロード → 列のマッピング → 結果です。口座を選び、ファイルを投入し、マッピングを確認して
インポートします。ファイルはあなたのサーバー上で解析され、第三者に送信されることはありません。
証券会社からのファイルの取り出し方がわからない場合は、インポートページの Find my broker
（または /connect）で証券会社カタログを開きます。証券会社を選ぶと、選んだアカウント向けに
その証券会社のエクスポート手順がインポートページに表示されます。
対応フォーマット
フォーマットはファイルのヘッダーから自動判定されます。対応ブローカーの エクスポートは列マッピングとタイムゾーンが事前入力され、それ以外の証券会社の約定エクスポートも 列をマッピングすれば取り込めます。
| フォーマット | 内容 | マッピング手順 |
|---|---|---|
| 約定 CSV | 1 行が 1 件の約定 — 証券会社の明細エクスポートで最も一般的な形式 | あり（対応ブローカーは事前入力） |
| MetaTrader ステートメント | MT5 の取引履歴レポート（XLSX/HTML）または MT4 のステートメント（HTML）をそのままアップロード — 対応ブローカーを参照 | なし |
| ジャーナルエクスポート | 1 行が 1 件の完了トレード（エントリー／エグジットを含む。Stonk Journal 形式: Date, Symbol, Side, Qty, Entry, Exit, …, Tags, Setup, Notes）。各行が往復のトレードとジャーナル注記になります | なし |
| JSON バックアップ | TraderMemos のエクスポート — 約定、プレイブックのセットアップ、資金取引、口座メタデータを復元します | なし |
サンプルファイルはインポートページからダウンロードできます。
列のマッピング（約定 CSV）
各標準フィールドを、CSV のヘッダーのいずれか、または**(スキップ)** に対応付けます。一般的な ヘッダー名は自動的に候補として提示されます。
| フィールド | 必須 | 自動検出されるヘッダー例 |
|---|---|---|
symbol | ✔ | Symbol, Ticker, Instrument |
side | ✔ | Side, B/S, Action（buy/b/bot、sell/s/sld） |
quantity | ✔ | Qty, Quantity, Shares, Contracts |
price | ✔ | Fill Price, Price, Avg Price, Exec Price |
executed_at | ✔ | Trade Date, Date/Time, Datetime |
fees / commission | — | Fee(s) / Commission, Comm |
instrument_type | — | Market, Asset Type, Sec Type |
option_right | — | Call/Put, Option Type, Right |
タイムスタンプは ISO 8601（2026-07-01T15:04:05Z）、2026-07-01 15:04:05、
07/01/2026 15:04:05、および日付のみの形式を受け付け、すべて UTC の時刻として保存されます。
- タイムゾーン — オフセットのない時刻はファイルのタイムゾーンで読み取ります。ブローカー プリセットのゾーン、それ以外の約定 CSV ではマーケットタイムゾーン（既定は米東部 — 多くの エクスポートがこれです）。別のゾーンで出力する証券会社なら、マッピング画面で変更してください。
- 日付の順序 —
05/01/2026のようなスラッシュ日付は 5 月 1 日とも 1 月 5 日とも読めます。13/01/2026のように順序を確定できるセルがあれば、プレビューは読み取り結果を表示するだけです。 すべての日付がどちらにも読める場合は、既定値のない日付の順序ピッカーが表示され（各選択肢に 例の日付の読み方を明記）、選ぶまでインポートできません。 - サンプル行は実際の取り込み結果を表示します。マッピングしたフィールドごとに 1 列（下に読み取る
ファイル列名）、各時刻の後ろに変換後の時刻（
→ Oct 1, 6:08:13 AM EDT）が付き、どこにも 使われないファイル列は「not imported」として薄く表示されます。オプションの 約定にはコール／プットの区分（明示的な列、または銘柄コードからの推定）と ×100 の乗数が適用されます。
重複と再インポート
約定の同一性は、口座単位での銘柄 + 売買方向 + 数量 + 価格 + タイムスタンプの組み合わせで 判定されます。同じ明細を 2 回インポートしても、日付範囲が重複していても、重複分は **スキップ（重複）**として数えられるだけです。再インポートは常に安全です。
1 つのファイル内の同一約定（銘柄、方向、数量、価格、秒まで同じ — 証券会社が 1 つの注文を分割 した場合など）はすべて保持されます。出現順のインデックス付きで識別されるため、同じファイルを 再インポートしてもすべてスキップされます。
約定がトレードになる仕組み
インポートのたびに口座は自動的に再グループ化されます。同じ銘柄／商品の約定が時系列順に処理され、 同方向の約定は積み増し、逆方向の約定は縮小として扱われ、ポジションがゼロに戻った時点でトレードが 決済されます（ドテンする約定は次のトレードを開始し、その手数料は数量に応じて両方に按分され ます）。ジャーナルのノートはトレードに紐づき、 再グループ化後も保持されます。
うまくいかなかった場合も、インポートと Flex 同期はすべてバッチ単位で管理されています。 設定 → アカウント → 同期・インポート履歴に一覧があり（アカウントページにはそのアカウント分 だけ表示）、ロールバックでそのバッチの約定を削除して再グループ化します。約定のない定期 Flex 同期は Show empty syncs を押すまで非表示です。
上限
アップロードは TM_IMPORT_MAX_BYTES（既定10 MiB、おおよそ数万行）で制限されます。セルフ
ホストであれば引き上げられます — 設定を参照してください。
その際、プロキシのボディサイズ上限はそれより大きくしておいてください。非常に大きな履歴は年ごとに
分割しても構いません。重複排除があるため、範囲が重なっても問題ありません。
その他の取り込み方法
- IBKR Flex 同期 — IBKR Flex Query からの自動インポートをスケジュール。
/connectか アカウントページの Interactive Brokers · Flex sync カードから設定します（間隔はTM_JOB_FLEX_SYNC_INTERVAL_MIN） - スクリーンショットスキャン — 証券会社のスクリーンショットから LLM で約定を抽出します。 AI 機能を参照してください
- 手入力 — 新規トレードドロワー（ホットキー
ct） - API / スクリプト — パーソナルアクセストークンを使った
POST /api/v1/executions。同じ重複排除が適用されます - CLI — API コンテナ内で
tradermemos import --account … --file …