Docs
币安合约同步（只读）
配置只读 API Key → 手动导入合约成交（fills）。默认导入最近 7 天，可选 1 个月或 1 年。
你需要什么权限
只需要查看/读取权限即可。不要开启交易权限。
- 需要能读取 Binance Futures（合约）成交历史（fills / userTrades）。
- 不需要提现权限，不需要现货交易权限。
在哪里创建 API Key
在 Binance 官网 / App 的 API 管理页面创建 API Key。
官方指引：如何创建 Binance API Key（官方 FAQ）。
由于 Binance 页面会不定期改版，本页同时给出“方向性指引”：
- 登录 Binance → 进入 API Management（API 管理）
- 创建一个新的 API Key（建议命名：
mmc-trade-journal-readonly） - 权限只勾选“读取/查看”（Read / Enable Reading）。不要勾选任何“交易/下单/提现”相关权限。
- 如果 Binance 要求 IP 白名单：你可以先不填（或临时放开），等我们后续支持固定出口 IP 再补。
安全建议
- 单独创建一个专用 Key，不要复用日常交易机器人 Key。
- 只给读取权限（Read-only）。即使泄露，也无法下单/提现。
- 保存好 Secret：Binance 通常只显示一次。丢了只能重新生成。
在系统里如何配置
进入 Trade → 开发者工具 → 集成中心 → 币安合约同步。
- 把 Binance 的 API Key 填到“API Key”
- 把 Binance 的 API Secret 填到“API Secret”
- 点击“保存”
说明：服务端会加密保存 Secret（不会在页面回显明文）。
手动导入（默认最近 7 天）
保存 Key 后点击“开始导入”。你可以在页面选择导入范围：最近 7 天（默认）/ 1 个月 / 1 年。 系统会自动分段拉取，并自动去重。
如果 Binance 接口提示必须提供 symbol，请在页面填写 symbols（例如BTCUSDT、ETHUSDT）再重试。
常见问题
为什么我导入时报权限错误？
通常是 API Key 没有开启读取合约数据权限，或账号风控限制导致。请确认创建 Key 时勾选了读取权限，并在 Binance 端完成必要的安全验证。
我可以只同步某几个币种吗？
可以。你可以在导入时填写 symbols 列表，只拉取指定标的。
下一步会自动同步吗？
目前按你的要求：只做手动触发。后续需要的话，我们再加“定时增量同步”。