Lighter 协议

在 Lighter 上交易——一个基于零知识证明的 Rollup 订单簿型去中心化交易所（DEX），延迟低至毫秒级，且对散户交易者完全免收手续费。

快速开始（只读模式）

# 市场数据为公开信息，无需认证凭据
curl "https://mainnet.zklighter.elliot.ai/api/v1/orderBooks"

什么是 Lighter？

• 面向散户交易者的零手续费机制
• 毫秒级延迟
• 所有操作均通过 ZK 证明验证
• 由 Founders Fund、Robinhood 和 Coinbase Ventures 联合支持

API 终端地址： https://mainnet.zklighter.elliot.ai
链 ID： 300

⚠️ 安全注意事项

第三方依赖

本技能在仅执行只读操作时，**仅需 requests 库**。若需签名下单，则有两种选择：

选项 A：最小化依赖（仅只读）

pip install requests

仅适用于获取公开数据（如市场列表、订单簿、价格等）。

选项 B：完整交易功能
需使用官方 Lighter SDK。请在安装前审阅并验证该 SDK：

• SDK 仓库地址：https://github.com/elliottech/lighter-python
• 请务必确认仓库所有者身份、Star 数量及源代码内容，再运行任何安装或配置命令

外部代码

仅当您满足以下全部条件时，才可使用外部 SDK：

1. 已完整审阅 GitHub 仓库代码
2. 充分理解该代码的功能与行为
3. 使用专用的临时钱包（burner wallet）进行操作，切勿使用主钱包

环境变量

配置认证凭据

步骤 1：获取您的 L1 地址

• 即您的以太坊地址（例如：0x1234...abcd）
• 请使用与登录 Lighter 控制台时相同的钱包

步骤 2：获取您的账户索引

curl "https://mainnet.zklighter.elliot.ai/api/v1/accountsByL1Address?l1_address=YOUR_ETH_ADDRESS"

响应中返回的 sub_accounts[].index 字段即为您的账户索引（主账户通常为 0）。

步骤 3：获取您的 API 密钥

1. 安装 Lighter Python SDK：pip install lighter-python
2. 参照设置指南操作：https://github.com/elliottech/lighter-python/blob/main/examples/system_setup.py
3. SDK 将为您账户生成绑定的 API 密钥
4. 请妥善保管私钥——切勿提交至 Git 仓库

快速测试（只读，无需凭据）：

curl "https://mainnet.zklighter.elliot.ai/api/v1/orderBooks"

API 使用方法

公开接口（无需鉴权）

# 获取全部市场列表
curl "https://mainnet.zklighter.elliot.ai/api/v1/orderBooks"

# 获取指定市场的订单簿
curl "https://mainnet.zklighter.elliot.ai/api/v1/orderBook?market_id=1"

# 获取最新成交记录
curl "https://mainnet.zklighter.elliot.ai/api/v1/trades?market_id=1"

需鉴权的接口

# 查询账户余额（需在请求头中提供 API 密钥）
curl -H "x-api-key: $LIGHTER_API_KEY" 
  "https://mainnet.zklighter.elliot.ai/api/v1/account?by=index&value=$LIGHTER_ACCOUNT_INDEX"

获取您的账户索引

请参见上方“配置认证凭据”表格中的快速 curl 命令。

获取 API 密钥

请参见上方“配置认证凭据”表格中的分步指南。

常见问题

“受限司法管辖区”错误：

• Lighter 对部分国家/地区存在地理访问限制，请确保您的操作符合其服务条款

SDK 签名异常：

• 建议优先使用 create_market_order() 而非 create_order()，以获得更稳定的执行效果

市场 ID 列表

相关链接

• API 文档：https://mainnet.zklighter.elliot.ai
• 控制台（Dashboard）：https://dashboard.zklighter.io
• SDK 仓库：https://github.com/elliottech/lighter-python

更多示例

请查阅本技能目录下的 USAGE.md 文件，其中包含：

• 所有 API 接口的详细 curl 示例命令
• 订单簿与成交记录查询方法
• 账户余额与持仓情况检查方式
• 已签名交易流程（nonce → 签名 → 广播）

免责声明： 运行任何外部代码前，请务必先行审阅；交易时请始终使用专用钱包。