导入交易

把券商成交记录导入 TraderMemos —— 支持列映射的 CSV、日志导出或 JSON 备份，重复记录自动跳过。

在侧边栏打开导入（快捷键 G I）。流程是上传 → 列映射 → 结果 —— 选择账户、拖入文件、确认映射、导入完成。文件只在你的服务器上解析，不会发送给任何第三方。

不知道怎么从券商导出文件？导入页面的 Find my broker（或 /connect）会打开券商目录 —— 选中你的券商后，导入页面会针对所选账户显示该券商的导出步骤。

支持的格式

格式根据文件的表头自动识别。支持的券商的导出文件会自动填好列映射和时区；其他券商的成交导出只要完成列映射就能导入：

格式	说明	需要映射？
成交 CSV	每行一笔成交 —— 多数券商对账单导出的形式	需要（支持的券商自动填好）
MetaTrader 对账单	MT5 交易历史报告（XLSX/HTML）或 MT4 对账单（HTML），原样上传 —— 见支持的券商	不需要
日志导出	每行一笔完整交易，含开平仓（Stonk Journal 风格：`Date, Symbol, Side, Qty, Entry, Exit, …, Tags, Setup, Notes`）。每行生成一笔完整交易及日志批注	不需要
JSON 备份	TraderMemos 的导出文件 —— 恢复成交、策略手册、现金流水与账户元数据	不需要

导入页面提供示例文件下载。

每个标准字段映射到你 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），预览只会回显读取结果；若所有日期两种读法都成立，会出现一个没有默认值的日期次序选择器（每个选项都写明示例日期的读法），选定前无法导入。
示例行按实际导入结果显示：每个已映射字段一列（下方注明读取的文件列），每个时间后附上转换后的时刻（→ Oct 1, 6:08:13 AM EDT），没有被读取的文件列会变暗并标为 not imported。期权成交会带上看涨 / 看跌方向（显式列或从代码推断）与 ×100 的乘数。

一笔成交的唯一性由代码 + 方向 + 数量 + 价格 + 时间戳共同决定，按账户隔离。同一份对账单导两次、或日期范围重叠，重复部分只会计入已跳过（重复）。重复导入永远是安全的。

同一文件内完全相同的成交（代码、方向、数量、价格、时间精确到秒都相同 —— 例如券商拆分了一笔订单）都会保留：每次出现都有带序号的独立标识，所以再次导入同一文件时它们仍会全部被跳过。

每次导入后账户会自动重新归组：同一代码 / 品种的成交按时间顺序遍历 —— 同向成交加仓、反向成交减仓，仓位归零时交易平仓（跨越零点的成交会开启下一笔交易，其手续费按数量在两笔交易间分摊）。日志批注挂在交易上，重新归组后依然保留。

导错了？每次导入与 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 功能
手动录入 —— 新建交易抽屉（快捷键 c t）
API / 脚本 —— 携带个人访问令牌调用 POST /api/v1/executions；同样的去重规则适用
CLI —— 在 API 容器内执行 tradermemos import --account … --file …