PLATFORM INTEGRATIONS · v0.1.0-beta
Bookmap、ATAS & Jigsaw
把 ZeroGamma 的 Call Wall、Put Wall、Zero Gamma 与 Major Long / Short Gamma 带到你的交易图表。下载包包含三个接入工具和中文使用教程。
更新：2026-09-23。已完成构建与自动化验证；客户平台内加载、画线和合约切换尚待实机验收。
| 平台 | 接入与刷新方式 | 版本范围 |
|---|---|---|
| Bookmap | JAR 插件，每 5 秒轮询当前水平线 | API 7.6.0.20 / Java 17 构建；已补查 7.4 类库，需 API 插件权限 |
| ATAS | DLL 指标，每 5 秒自动刷新当前水平线 | 按本机 7.0.11.384 SDK、.NET 8 构建 |
| Jigsaw daytradr | 每 5 秒更新 CSV；图表每次需手动 Load | Depth & Sales / Auction Vista |
测试版不包含历史轨迹、回放、下单或期货自动换月。Jigsaw 目前不是无人值守实时画线；它不会自动读取被改写的 CSV，已经加载的旧线需要手动 Clear。
1. 准备账户与映射
- 准备有效的 ZeroGamma Pro 订阅、已安装的平台与该平台所需的独立许可和行情连接。接入包不包含交易软件许可或原始行情。
- 在设置 → API 与平台接入中创建 API Key，立即保存，只显示一次。不要把密钥发给卖家、写入 URL 或放进截图。
- 完整解压下载包，进入相应平台目录。先在模拟或只读图表上核对品种、价格量级和线的位置。
- SPX → ES/MES、NDX → NQ/MNQ：Basis = 同时刻期货价 − 指数现价。SPY → ES/MES、QQQ → NQ/MNQ：Ratio = 同时刻期货价 ÷ ETF 现价。SOURCE 保持源价格单位。
- 例如指数 6000、目标合约 6032，Basis 填 32；源价位 6010 映射为 6042。这是假设算式，不是当前行情。映射参数不会自动追踪；切合约、换月或基差变化后重新填写。期货输出对齐 0.25 点。
2. Bookmap
- 在 Bookmap 打开 Settings → API plugins configuration，添加 Bookmap 目录中的 ZeroGamma-Bookmap.jar。需要你的 Bookmap 版本及套餐允许加载 API 插件。
- 在目标品种上启用 ZeroGamma Levels (Preview)，打开插件设置。填写 API Key、数据源、目标图表品种、映射值，再按「连接 / 更新」。详细字段见同目录 README。
- 每个图表单独配置。插件后台每 5 秒读取当前价位，显示彩色水平线和标签；密钥仅保存在当前进程内，重启后重新填写。
- 无有效当日数据、请求失败或数据过期时清除插件线。若插件无法加载，先确认兼容版本与 API 权限；不要复制 SDK 文件到插件目录。
3. ATAS
- 在 ATAS 指标窗口点击 Add custom indicator / 添加自定义指标，选择下载包 ATAS 目录中的 ZeroGamma.ATAS.dll。也可关闭 ATAS 后将 DLL 放入 %APPDATA%\ATAS\Indicators，再重启软件。
- 双击同目录 Configure-Key.cmd，按提示隐藏输入 API Key。它用当前 Windows 用户的 DPAPI 加密保存在本机，不需要管理员权限。不要复制加密文件给其他用户。
- 打开目标合约图表，添加 ZeroGamma Levels (beta)，填写 Source、Target chart units 和 Manual basis / ratio，再勾选 Confirm current chart。切换月份合约后会清线，需重新核对映射并再次确认。
- 后台每 5 秒更新，异常时清除旧线。若列表中找不到指标或出现加载错误，请确认版本；本版仅按 .NET 8 与 SDK 7.0.11.384 编译，其他版本尚未验证。
4. Jigsaw daytradr
- 在 Jigsaw 目录双击 Start.bat，按提示填写品种、目标、映射参数和 API Key。保持窗口打开；绿色 OK 表示当前 CSV 已更新。密钥只保存在内存中。
- 在 Depth & Sales 设置 → Load Data Levels，选择工具窗口显示的 CSV 路径，Separator 选英文逗号。默认文件在文档\Jigsaw Trading\Levels 下。
- 在 Auction Vista 画线需勾选 Show Line，设置 Line Width，然后点击 Load。D&S 的 Alert 列会显示价位标签。
- 每次想把新数据画到软件里，都需要再点 Load。出现断网、过期、停止或错误提示时，在 Jigsaw 点击 Clear；CSV 清空不会自动移除软件里已经加载的线。
状态与常见问题
- 没有线：确认有效 Pro、正确 API Key、品种与映射、当日可用数据，以及图表可视价格范围。数据超过 120 秒或跨美东日期就不再作为当前价位返回；非交易时段可能没有可用线。
- 5 秒是客户端轮询间隔，不是逐笔行情延迟保证。上游 levels 没有独立行情时间时，新鲜度依据服务器接收时间；history 使用历史点时间。
- 401：密钥无效、撤销或 Pro 到期。403：访问不允许。429：请求过多，等待至少 60 秒再重试并减少并行窗口。密钥泄露后立即在设置撤销。
- 价格不一致：本版使用 OI 展示区价位，请与网站同源品种、OI 权重、同一时间和相同手动映射对比；不是 Vol 权重或期货行情直连。
开发者：只读 GET /api/v1/levels，以 Authorization: Bearer 发送密钥。支持 instrument、target、mapping、value 和 format=json|jigsaw；不要在 URL 放密钥。完整接口规范在下载包 API.md。