lighter

name	lighter
description	Interact with Lighter protocol - a ZK rollup orderbook DEX. Use when you need to trade on Lighter, check prices, manage positions, or query account data.
env	{"required":["LIGHTER_API_KEY","LIGHTER_ACCOUNT_INDEX"],"optional":["LIGHTER_L1_ADDRESS"]}

Lighter Protocol

Trade on Lighter - a zero-knowledge rollup orderbook DEX with millisecond latency and zero fees.

Quick Start (Read-Only)

# Markets are public - no credentials needed
curl "https://mainnet.zklighter.elliot.ai/api/v1/orderBooks"

What is Lighter?

• Zero fees for retail traders
• Millisecond latency
• ZK proofs of all operations
• Backed by Founders Fund, Robinhood, Coinbase Ventures

API Endpoint: https://mainnet.zklighter.elliot.ai Chain ID: 300

⚠️ Security Considerations

Third-Party Dependencies

This skill can work with just requests library for read-only operations. For signing orders, you have two options:

Option A: Minimal (Read-Only)

pip install requests

Only for public data (markets, order books, prices).

Option B: Full Trading Requires the official Lighter SDK. Review and verify before installing:

• SDK Repository: https://github.com/elliottech/lighter-python
• Verify the repository owner, stars, and code before running any setup

External Code

Only proceed with external SDK if you:

1. Have reviewed the GitHub repository
2. Understand what the code does
3. Use a dedicated burner wallet, not your main wallet

Environment Variables

Variable	Required	Description
LIGHTER_API_KEY	For orders	API key from SDK setup
LIGHTER_ACCOUNT_INDEX	For orders	Your Lighter account index
LIGHTER_L1_ADDRESS	Optional	ETH address for lookups

API Usage

Public Endpoints (No Auth)

# List all markets
curl "https://mainnet.zklighter.elliot.ai/api/v1/orderBooks"

# Get order book
curl "https://mainnet.zklighter.elliot.ai/api/v1/orderBook?market_id=1"

# Get recent trades
curl "https://mainnet.zklighter.elliot.ai/api/v1/trades?market_id=1"

Authenticated Endpoints

# Account balance (requires API key in header)
curl -H "x-api-key: $LIGHTER_API_KEY" \
  "https://mainnet.zklighter.elliot.ai/api/v1/account?by=index&value=$LIGHTER_ACCOUNT_INDEX"

Getting Your Account Index

# Query by ETH address
curl "https://mainnet.zklighter.elliot.ai/api/v1/accountsByL1Address?l1_address=YOUR_ADDRESS"

Response contains sub_accounts[].index - use as your account index.

Getting an API Key

1. Review the official Lighter SDK: https://github.com/elliottech/lighter-python
2. Clone and audit the code
3. Run setup with a dedicated wallet
4. Store the generated API key securely

Common Issues

"Restricted jurisdiction":

• Lighter has geographic restrictions - ensure compliance with their terms

SDK signing issues:

• Use create_market_order() instead of create_order() for more reliable execution

Market IDs

ID	Symbol
1	ETH-USD
2	BTC-USD
3	SOL-USD

Links

• API: https://mainnet.zklighter.elliot.ai
• Dashboard: https://dashboard.zklighter.io
• SDK: https://github.com/elliottech/lighter-python

---

Disclaimer: Review all external code before running. Use dedicated wallets for trading.