rotki 的本地记账流程可以概括为三步：先把数据导进来，再在 History Events 里把对不上的地方改对，最后用数据库备份或 Premium 同步保住结果。它不是一个"连上 API 就自动出报表"的工具，导入只是原料，对账才是你真正要花时间的地方。
导入：API 优先，CSV 补缺
rotki 支持两类数据来源：交易所 API 和 CSV 文件。判断标准很简单：能用只读 API 的，优先用 API；不能用 API 的（交易所不支持、账户已关闭、或者你只有历史导出文件），才用 CSV。
API 连接在 API Keys → Exchanges 里添加，币安、BitMEX 等主流交易所都有内置支持。创建 API Key 时只勾选读取权限，不要给交易或提现权限。币安有一个需要留意的限制：它的 Convert 历史每次请求只返回 30 天，深历史同步会比较慢，而且你需要把正在交易的市场对（比如 BTCUSDT、ETHUSDT）手动填进 rotki，它才知道去查哪些交易对。
CSV 导入在 Import Data 菜单里操作，选择对应的交易所导入器，上传文件。币安的 CSV 可以导入比 API 更多的内容——交易、充提、小额资产兑换 BNB、ETH 2.0 质押和奖励、Launchpool 利息、POS 储蓄的申购和赎回都能进。但币安的 CSV 格式本身有一些数据 rotki 解析不了，导入时会给出警告，看到警告不一定是操作错了，是源文件的信息缺失。
如果你用的交易所在 rotki 里没有专用导入器，可以用 Custom Import 走通用 CSV 格式，自己把列映射到 rotki 的字段。这里有一个容易踩的坑：rotki 用资产标识符而不是符号来识别资产，因为符号不唯一。ERC-20 代币的标识符遵循 CAIP-19 格式，其他资产可能是符号或随机字符串。如果你在通用导入里填了 "USDT"，而 rotki 期望的是某个链上的合约地址格式，导入就会失败或归错资产。
对账：History Events 里的问题分类
导入完成后，打开 History Events。这里不是让你逐条浏览的，而是看顶部的 Actions Center，它会按类别汇总需要处理的问题。
你会遇到的主要类别包括：Unmatched asset movements（交易所提现没有对应的链上收款，或充值没有对应的链上发送）、Unmatched bridge transactions（跨链桥的一边没匹配上另一边）、Duplicate events（你手动编辑过的事件和重新解码出来的原始事件重复了）、Undecoded transactions（交易查到了但没解码成事件）。
Unmatched asset movements 是最常见的对账任务。产生原因通常是：涉及的链上地址没有加进 rotki、链上事件还没同步到、金额或时间差太大导致自动匹配失败、或者交易所本身没提供足够信息（比如没给 tx hash）。处理方式有三种：点 Trigger automatic matching 让 rotki 按金额、资产和时间窗口自动匹配；对单条记录点 Find Match 手动搜索并调整时间范围和金额容差；如果这笔流动确实没有链上对应（比如法币出入金），点 Ignore 把它移到忽略区。Ignore All Fiat 可以一次性处理所有法币流水，省去逐条操作。
一个容易误判的地方：你自己钱包之间的转账，如果两边地址都加进了 rotki，它会把发送和接收匹配成内部转移，不当作应税处置。但如果只加了其中一边，另一边就会显示为 unmatched，你可能误以为需要手动处理。先把所有相关地址加全，再看 Actions Center，能减少很多假问题。
备份：本地数据库是你要保住的东西
rotki 是本地优先的工具，数据存在你电脑上的加密数据库里，默认不离开你的机器。这意味着备份的责任在你这边。官方对数据目录的说明里有一句直接的建议：频繁备份数据目录，因为它包含所有账户的数据和历史价格缓存。
但手动复制数据目录有一个条件：必须先完全关闭 rotki。SQLite 数据库在运行时可能有待写入的 WAL/journal 文件，直接在运行中做文件系统复制，可能捕获到不一致的状态，导致备份打不开或静默损坏。更安全的方式是用应用内的备份功能，它在运行时创建一致性快照。
数据目录的位置按操作系统不同：
- Linux：~/.local/share/rotki/data/
- macOS：~/Library/Application Support/rotki/data（默认隐藏）
- Windows：%LOCALAPPDATA%/rotki/data
如果你有 Premium 订阅，可以开启 Allow data sync with rotki Server 做加密云备份。但要注意两个限制：同步只涉及用户数据库，不包含全局数据库（global.db，里面有资产数据、地址簿、历史价格），全局数据库需要手动迁移。另外，不要在多个设备上同时运行 rotki，最新登录的设备会覆盖云端数据，同时运行可能导致数据一致性问题。
一个可以照做的顺序
如果你刚开始用 rotki，按这个顺序走：安装后创建本地账户并设一个强密码（密码丢了无法恢复） → 在 API Keys 里添加交易所的只读 Key，币安记得填交易对 → 如果有历史数据缺失，用 CSV 补 → 打开 History Events，先看 Actions Center 的 Unmatched 和 Duplicate，用自动匹配处理大部分，手动处理剩下的 → 处理完后生成一次 Profit/Loss Report 看看数字是否合理 → 关闭 rotki，手动复制一次数据目录作为基线备份，或者开启 Premium 同步。
对账完成的判断标准不是 Actions Center 清零（有些类别需要 Premium 才能用，有些法币流动本来就没有链上对应），而是你抽查几笔关键交易，金额、资产、时间和你交易所记录一致，PnL 报告里的数字你能追溯来源。rotki 允许你编辑事件和添加手动条目，如果自动导入的结果不对，改到对为止，然后备份。
参考资料
- Rotki·Binance support，页面未标明更新日期；核查日期：2026-10-19。
- Rotki·BitMEX support，页面未标明更新日期；核查日期：2026-10-19。
- Rotki·Import CSV，页面未标明更新日期；核查日期：2026-10-19。
- Rotki·Import Data，页面未标明更新日期；核查日期：2026-10-19。
- Rotki·Resolving history event issues，页面未标明更新日期；核查日期：2026-10-19。
- Rotki·Local-first crypto accounting，更新于 2026-06；核查日期：2026-10-19。
- Rotki·Data directory，页面未标明更新日期；核查日期：2026-10-19。
- Rotki·Accounts & Sync，页面未标明更新日期；核查日期：2026-10-19。
- Rotki·Usage Guides，页面未标明更新日期；核查日期：2026-10-19。
- Rotki·Quick Start Guide，页面未标明更新日期；核查日期：2026-10-19。
