TraderMemosトレードのインポート
証券会社の約定を TraderMemos に取り込みます — 列マッピング対応の CSV、ジャーナルのエクスポート、JSON バックアップ。重複は自動的にスキップされます。
サイドバーのインポートを開きます（ホットキー G I）。流れは
アップロード → 列のマッピング → 結果です。口座を選び、ファイルを投入し、マッピングを確認して
インポートします。ファイルはあなたのサーバー上で解析され、第三者に送信されることはありません。
対応フォーマット
フォーマットはファイルのヘッダーから自動判定されます。対応ブローカーの エクスポートは列マッピングとタイムゾーンが事前入力され、それ以外の証券会社の約定エクスポートも 列をマッピングすれば取り込めます。
| フォーマット | 内容 | マッピング手順 |
|---|---|---|
| 約定 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 に正規化されます。オプションの
約定にはコール／プットの区分（明示的な列、または銘柄コードからの推定）と ×100 の乗数が適用されます。
重複と再インポート
約定の同一性は、口座単位での銘柄 + 売買方向 + 数量 + 価格 + タイムスタンプの組み合わせで 判定されます。同じ明細を 2 回インポートしても、日付範囲が重複していても、重複分は **スキップ（重複）**として数えられるだけです。再インポートは常に安全です。
約定がトレードになる仕組み
インポートのたびに口座は自動的に再グループ化されます。同じ銘柄／商品の約定が時系列順に処理され、 同方向の約定は積み増し、逆方向の約定は縮小として扱われ、ポジションがゼロに戻った時点でトレードが 決済されます（ドテンする約定は次のトレードを開始します）。ジャーナルのノートはトレードに紐づき、 再グループ化後も保持されます。
うまくいかなかった場合も、インポートはすべてバッチ単位で管理されています。インポートページには 過去のバッチが一覧表示され、バッチを削除すると取り消しになります（その約定を削除し、再グループ 化します）。
上限
アップロードは TM_IMPORT_MAX_BYTES（既定10 MiB、おおよそ数万行）で制限されます。セルフ
ホストであれば引き上げられます — 設定を参照してください。
その際、プロキシのボディサイズ上限はそれより大きくしておいてください。非常に大きな履歴は年ごとに
分割しても構いません。重複排除があるため、範囲が重なっても問題ありません。
その他の取り込み方法
- tm-sync — 明細フォルダを監視し、MT4/MT5 のエクスポートを出力と同時にパーソナルアクセス トークン経由でインポートする小さなデスクトップウォッチャー — tm-sync を参照
- IBKR Flex 同期 — IBKR Flex Query からの自動インポートをスケジュール
（設定 → 口座 → Flex 同期、間隔は
TM_JOB_FLEX_SYNC_INTERVAL_MIN） - スクリーンショットスキャン — 証券会社のスクリーンショットから LLM で約定を抽出します。 AI 機能を参照してください
- 手入力 — 新規トレードドロワー（ホットキー
ct） - API / スクリプト — パーソナルアクセストークンを使った
POST /api/v1/executions。同じ重複排除が適用されます - CLI — API コンテナ内で
tradermemos import --account … --file …