第一次使用 NavaX 应该从哪里开始？

风险提示：本程序提供行情、交易、蓝图回测和自动化执行能力，不承诺任何收益。实盘交易前，请先使用小资金、模拟盘或回测充分验证策略。添加 API 时不要开启提币权限。

打开 NavaX Crypto 后，顶部导航会看到几个主要入口：

• 交易：查看行情、打开图表、管理账户、查看持仓和委托。
• 市场报价：浏览交易对行情。
• 蓝图：创建、导入、编辑、回测和调试策略蓝图。
• 扩展：浏览和安装扩展蓝图、工具或组件。

第一次使用时，建议先进入 交易 页面，确认行情列表可以正常加载。

如果你只看行情，可以不添加账户。若需要下单、查看资产、使用蓝图挂载交易，则需要添加交易所 API 账户。

操作步骤：

1. 在 交易 页面打开左侧 资源管理。
2. 找到 账户 区域，点击添加账户。
3. 选择交易平台，例如 Binance、OKX、Bybit、Bitget 或 HTX。
4. 填写账号备注、API Key、API Secret。
5. 如果平台要求 Passphrase，例如部分 OKX、Bitget 账户，请一并填写。
6. 点击 验证，等待程序确认 API 可用。
7. 验证通过后点击保存。

API 权限建议：

• 开启读取权限，用于同步资产、持仓和委托。
• 如需手动或蓝图实盘交易，再开启交易权限。
• 不要开启提币权限。
• 如果交易所支持 IP 白名单，建议绑定当前网络出口 IP。

行情列表会展示交易对价格、涨跌幅、成交量等信息。你可以按交易对搜索，也可以切换现货、合约或不同交易平台的数据源。

常用操作：

• 双击行情列表中的交易对，打开该交易对图表。
• 在图表顶部切换周期，例如 1m、5m、15m、1h。
• 在图表中查看 K 线、当前价格、挂载蓝图标记和交易线。
• 如果图表没有数据，先检查网络、数据源和交易对是否支持当前市场类型。

添加并登录交易账户后，可以在图表或交易面板中进行手动交易。

下单前请确认：

• 当前登录账户是否正确。
• 当前交易对是否属于你要交易的市场，例如现货或 USDT 合约。
• 合约交易时杠杆是否符合你的风险承受能力。
• 下单数量、方向、止盈止损价格是否填写正确。

交易后可以在底部列表查看：

• 当前持仓
• 当前委托
• 历史委托
• 历史持仓
• 历史成交

如果账户数据没有及时刷新，可以手动刷新或重新登录账户。

蓝图是 NavaX Crypto 的可视化策略系统。你可以把它理解成“策略流程图”：行情节点负责读取数据，指标节点负责计算，逻辑节点负责判断，风控节点负责限制风险，下单节点负责生成交易动作。

进入 蓝图 页面后，左侧是 我的蓝图，中间是蓝图画布，右侧是属性和参数面板。

常用操作：

• 双击左侧蓝图名称，打开蓝图。
• 点击节点查看或修改参数。
• 使用连线把行情、指标、逻辑和下单节点连接起来。
• 修改后使用保存按钮保存到本地工作区。
• 如需导入 .fsvb 文件，在蓝图列表中使用导入功能。

如果只是使用现成蓝图，通常不需要编辑节点结构，只需要检查参数、回测结果和挂载设置。

实盘前建议先回测。回测可以帮助你了解策略在历史 K 线中的交易次数、盈亏、胜率、回撤和订单行为。

基本流程：

1. 进入 蓝图 页面。
2. 打开一个蓝图。
3. 在回测设置中选择交易对、周期、起止时间、初始资金、杠杆等参数。
4. 点击开始回测。
5. 查看回测日志、订单记录、图表标记和统计结果。

回测时需要注意：

• 回测结果依赖历史数据质量。
• 市价单、限价单、滑点和手续费都会影响结果。
• 短时间窗口可能不代表长期表现。
• 回测盈利不代表实盘一定盈利。
• 如果提示编译失败，优先检查蓝图节点连线和参数是否完整。

挂载蓝图是把策略绑定到具体账户和交易对上，让它像 EA 一样随行情运行。

建议先使用 模拟交易 或 纸面交易 模式，确认蓝图行为符合预期，再考虑实盘。

挂载流程：

1. 在 交易 页面打开目标交易对图表。
2. 在左侧 资源管理 中找到要使用的蓝图。
3. 双击蓝图，或将蓝图拖到图表上。
4. 在挂载窗口确认交易对、杠杆、运行模式和开仓方向。
5. 在参数页检查蓝图暴露的可调参数。
6. 在风控页设置最大单笔下单金额、每日最大订单数等限制。
7. 开启自动交易后保存。

运行模式说明：

• 模拟交易 / Paper：只模拟策略触发和订单结果，不向交易所提交真实订单。
• 实盘交易 / Live：策略触发后会通过当前登录账户向交易所提交真实订单。

实盘挂载前，请确认账户、交易对、杠杆、仓位比例和风控上限都已经检查过。

已挂载的蓝图会显示在资源管理的账户节点下，也会在图表上显示挂载提示。

你可以：

• 双击挂载实例，重新打开挂载设置。
• 修改参数或风控后保存。
• 重新载入蓝图，让运行实例使用最新蓝图文件。
• 关闭自动交易，停止后续真实下单。
• 查看挂载日志，确认最近触发、风控拒绝或下单失败原因。

如果你修改了蓝图结构，建议先停止挂载，保存蓝图，再重新挂载运行。

在 扩展 页面可以浏览可安装的蓝图和工具。扩展详情通常会包含版本、说明、作者、回测信息或推荐交易对。

安装后，扩展蓝图会出现在蓝图列表或资源管理中。使用扩展蓝图前，仍然建议先回测，再模拟挂载，最后才考虑实盘。

先检查网络连接、交易平台数据源，以及交易对是否支持当前市场类型。也可以切换数据源后重试。

检查 API Key、Secret、Passphrase 是否填写正确；确认交易所 API 权限已开启；如果使用 IP 白名单，确认当前公网 IP 已加入白名单。

确认当前已经登录交易账户，账户 API 有交易权限，交易对支持当前市场类型，合约杠杆没有超过平台上限，余额或保证金充足。

先打开蓝图并保存，确认节点没有缺失连线。然后检查回测交易对、周期、时间范围和网络数据是否可用。

蓝图只会在满足事件周期和信号条件时触发。请确认当前图表周期、蓝图执行周期、交易对、账户和运行模式正确，并查看挂载日志判断是否被风控拦截。

第一次使用建议按这个顺序来：

1. 先看行情，熟悉交易对和图表。
2. 添加账户，只开启读取权限，确认资产和委托能同步。
3. 小额测试手动下单和平仓流程。
4. 导入或创建蓝图，先做历史回测。
5. 用模拟交易挂载蓝图，观察触发和订单记录。
6. 确认策略稳定后，再考虑小资金实盘。
7. 定期检查挂载日志、账户风险和交易所 API 状态。

这样做可以把“软件是否会用”“账户是否连通”“策略是否合理”“实盘风险是否可控”分开验证，减少一次性直接实盘带来的不确定性。