文档
你想做什么？
连接 Lighter
Lighter（Lighter Core）使用与您的 Lighter 账户绑定的 API 密钥：一个公钥和一个可以交易、但不能把资金转到其他地址的私钥：Lighter 只允许提现到拥有该账户的钱包。MyLiquidBot 还需要拥有该账户的 L1 钱包地址。保存时会自动获取账户索引和 API 密钥索引。
Lighter 账户必须用您自己的钱包创建（不是邮箱或社交登录）。任何账户等级都可以连接、进行手动交易并使用 Delta 中性。需要支付 MyLiquidBot 费用的其他机器人需要 Plus 或 Premium，因为 Lighter 不允许向 Standard 账户收取集成商费用；创建机器人前，创建页面会提示您。
在添加连接中选择 Lighter，保持选中快速连接，并用您 Lighter 账户的钱包签署一条消息。MyLiquidBot 会在您主账户的空闲槽位中创建 API 密钥，因此您的其他密钥仍可继续使用。不转移资金，也不花费 gas。集成商费用批准仍是单独的步骤。如果想自己创建，请选择粘贴 API 密钥并按第 1、2 部分操作。
Lighter Core 账户等级与费用
| Lighter Core 等级 | 原生挂单 / 吃单费用 | 使用 MyLiquidBot |
|---|---|---|
| Standard | 0 / 0 | 手动交易、Delta 中性和不收取 MyLiquidBot 费用的机器人 |
| Plus | 0.005% / 0.005% | 所有机器人 |
| Premium | 0.004% / 0.028% 基础费率（可能有折扣） | 所有机器人 |
原生费用由 Lighter 收取，与 MyLiquidBot 费用分开。交易前请核对当前交易所费率。连接验证后，您可以在 Lighter 上或通过管理 → 更改等级更改等级；当有未成交订单或仓位、或处于冷却期时，Lighter 可能拒绝更改，并且更改等级也会影响 MyLiquidBot 之外的交易。
第 1 部分 — 在 Lighter 创建 API 密钥
打开 API 密钥页面
在 app.lighter.xyz 连接您的钱包，然后打开 app.lighter.xyz/apikeys。
生成一个新的标准 API 密钥
复制 Public Key 和 Private Key。私钥只显示一次。不要将密钥标记为仅挂单：交易激活需要标准（非仅挂单）API 密钥。
记下您的钱包地址
您连接到 Lighter 的 EVM 地址就是 L1 钱包地址。
第 2 部分 — 在 MyLiquidBot 添加连接
前往账户 → 交易所 → 添加连接，选择 Lighter，确认账户由钱包创建以及等级提示，然后填写：
| MyLiquidBot 中的字段 | 填写内容 |
|---|---|
| Public Key | API 密钥的公钥（一长串十六进制文本）。 |
| Lighter API 密钥 - 私钥 | API 密钥的私钥。绝不是您的钱包私钥或助记词。 |
| L1 钱包地址（Ethereum） | 您在 Lighter 使用的 0x… 钱包。 |
| Account Index / API Key Index | 留空：保存并验证连接时会自动填写。 |
| 可选值（Auth Token、API URL、WebSocket URL） | 除非支持人员要求更改，否则留空。 |
按保存并验证。MyLiquidBot 会找到您的账户，将公钥与该账户上的某个 API 密钥匹配，并检查其权限。
第 3 部分 — 激活交易（集成商费用）
在激活步骤或管理 → 集成商费用批准中，按批准集成商并用连接中保存的同一 L1 钱包签名。它不转移资金，也不允许提现。当面板显示集成商已批准时，该连接即可交易。
第 4 部分 — 杠杆和保证金模式
在 Lighter 上，杠杆和全仓/逐仓模式按市场存储在交易所。当您创建机器人或发送手动订单时，所选的杠杆和交易模式会自动同步。“管理”中的 Lighter · 杠杆设置面板可让您预先为某个市场设置它们，并显示从该页面保存的设置。
故障排除
| 消息或症状 | 可能原因 | 解决方法 |
|---|---|---|
| “在此账户上未找到已配置的 Lighter API 公钥。” / “已配置的公钥与此账户上的任何 API 密钥都不匹配。” | 公钥属于另一个密钥或账户，或者密钥已被删除。 | 从 app.lighter.xyz/apikeys（或“管理”中显示的列表）重新复制公钥并编辑连接。若密钥已被删除，请创建新的。 |
| “Lighter 不接受此 API 密钥用于已保存的账户…” | 私钥、账户和 API 密钥索引不属于同一个账户。 | 编辑连接，粘贴同一 API 密钥的公钥和私钥，两个索引留空，然后重新保存。 |
| “此 Lighter API 密钥为仅挂单…” | 密钥创建时设为仅挂单。 | 在 Lighter 上移除该限制或创建标准 API 密钥，然后更新连接。 |
| “您的 Lighter 账户为 Standard。受 Lighter 限制，此机器人需要 Plus 或 Premium 账户。” | 账户为 Standard，且该机器人需支付 MyLiquidBot 费用。 | 更改为 Plus 或 Premium（在 Lighter 上或通过“管理 → 更改等级”），然后在创建页面点击重新检查。 |
| “所选钱包 … 与 Lighter L1 钱包 … 不匹配” | 钱包中选择了另一个账户。 | 选择连接中保存的 L1 钱包并重新签名。 |
| “此 API 密钥的另一项 Lighter 操作正在进行中。” | 同时发送了两项操作。 | 等待一分钟后重试。不要多次重复该操作。 |
| 机器人表单：“此市场没有保存本地杠杆/模式…” | 该市场的杠杆或交易模式尚未同步。 | 在表单中更改杠杆或交易模式（会自动同步），或在“管理 → 杠杆设置”中设置，然后创建机器人。 |
| 订单出现 nonce 或签名错误 | API 密钥已在 Lighter 上被替换或撤销。 | 暂停受影响的机器人，创建新的 API 密钥，编辑连接并在验证通过后恢复。 |