Lighter API/MM Updates
1.02K subscribers
1 photo
1 video
78 links
Official Channel for API and Market-maker updates on Lighter
Download Telegram
We're changing the default self-trade behavior on Lighter from reduce both to cancel maker:

Current default (reduce both): when a user's order crosses their own resting order, both orders are reduced by the overlap amount.
New default (cancel maker): the resting order is cancelled in full, and the incoming order continues filling against the rest of the book.

This means that under the new default behavior, your taker order fills as intended against the rest of the book, instead of being silently reduced. The change only affects orders that don't explicitly specify a self-trade behavior. All four modes (cancel maker, cancel taker, cancel both, reduce both) will be allowed as explicit attributes.

The above changes will be effective starting May 31st, 2026 at 8:00 AM ET (timestamp: 1780228800)
6
- Lighter's Python SDK has been updated, including all the latest API changes: https://pypi.org/project/lighter-sdk

- The WebSocket connection cap has been increased from 100 to 200 per IP: https://apidocs.lighter.xyz/docs/rate-limits#websocket-limits

- An RFQ section has been added to our API reference: https://apidocs.lighter.xyz/reference. The program is currently in beta and requires whitelisting to be used, you can reach out to us via Discord #support.

- The syntheticSpotInfo endpoint has been added, allowing users to query the current configuration in use for US equity indices: https://apidocs.lighter.xyz/reference/syntheticspotinfo
6
We're changing the behavior of the trades endpoint: https://apidocs.lighter.xyz/reference/trades

Current behavior: both sides of the trade are returned
New behavior: some counterparty fields will be omitted

For example, if the account_index queried is the maker of the trade, the followings fields won't be returned anymore:

TakerFee
TakerPositionSizeBefore
TakerEntryQuoteBefore
TakerInitialMarginFractionBefore
TakerPositionSignChanged
IntegratorTakerFee
IntegratorTakerFeeCollectorIndex
TakerAllocatedMarginUSDCBefore
TakerAllocatedMarginUSDCAfter

Moreover, only the last 3K trades will be retained, for a given account_index. The export endpoint will still allow to obtain the whole history: https://apidocs.lighter.xyz/reference/export.

The above changes will be effective starting June 7th, 2026 at 8:00 AM ET (timestamp: 1780833600)

Additionally, we have added the markPriceCandles endpoint, allowing users to fetch historical mark price candles: https://apidocs.lighter.xyz/reference/markpricecandles
1
Lighter API/MM Updates
We're changing the default self-trade behavior on Lighter from reduce both to cancel maker: • Current default (reduce both): when a user's order crosses their own resting order, both orders are reduced by the overlap amount. • New default (cancel maker):…
The change for default self-trade behavior on Lighter from reduce both to cancel maker has been moved to May 30th, 2026 at 9:00 AM ET (timestamp: 1780146000). Complete details about the change can be found here in the above post.
- Lighter's Python & GO SDKs have been updated on GitHub, supporting explicit attributes for self-trade behavior, following the recent changes: https://t.me/lighter_api_updates/135

- The account index is now shown in the api keys page, and when assigning a new api key pair to an api key index: https://app.lighter.xyz/apikeys

- Builders can leverage this open-source web app to manage integrator approvals, and see how to handle l1 & l2 signing on their end: https://lighter-integrators.up.railway.app/

- As of recently, a l1 signature is not required anymore to approve integrators capped at zero fees, and when revoking approvals for any type of integrator. SDKs will support this in the next release
👍3
We'll be listing the $SPCX market today. Some notes:

- Global Open Interest Cap: $100M
- Isolated Margin
- Current shares: ~13.08B

Regarding the current pre-IPO $SPACEX market on Lighter:

- The current $SPACEX market on Lighter will get delisted; it should settle next Friday at the close, based on share price × shares outstanding. Once we confirm the final share count, we'll use that to calculate the index price
👍51
- Mark Price Candlesticks are now available via WebSockets: https://apidocs.lighter.xyz/docs/websocket-reference#mark-price-candlesticks

- Starting June 17th, 11am UTC (timestamp: 1781694000), both ws/candle and ws/mark_price_candle will allow for up to 2 candles in the candles[] array to be sent in a single update when a candle period closes (rolls over). If so, candles[0] will be the oldest, just closed candle.

- The Lighter Python SDK has been updated, and now supports approving a zero fees integrator, and revoking all kind of integrator approvals, just using a l2 signature. Moreover, an example has been provided on how to cancel all orders for a single market: https://pypi.org/project/lighter-sdk/

- The market_stats WebSocket channel now returns best_ask_price, best_bid_price (BBO): https://apidocs.lighter.xyz/docs/websocket-reference#market-stats
Forwarded from Lighter Announcements
gm

Toncoin ($TON) has been renamed to Gram ($GRAM), effective today. This is a rebrand only and does not affect the underlying market. The update will be reflected across the Lighter frontend and backend later today.

On the API side, updates will now be delivered as GRAM, while the market ID remains unchanged. No action is required.
👍3
re: Liquidity Partner Program

Docs have been updated to reflect changes to the incentive program. Instead of using tiers, each market now has its own set of requirements. The tracking sheet remains the same, and this week's updates have been applied.

Weekly Incentives Sheet

Docs: https://docs.lighter.xyz/liquidity-partner-program
👍2
re: XCU (Copper)

To maintain parity with other venues, we are updating the XCU (Copper) underlying from the spot price methodology previously used to a rolling futures-based methodology, effective immediately.

The documentation has been updated accordingly and can be found here
👍2
- Support for maker-only api keys per L1 has been increased from 200 to 251 per account_index

- Whitelisted operators can now create up to 6 public pools per L1

- The last_updated_at field on the ticker WebSocket channel now always reflects the latest transaction_time impacting the best bid & offer
👍1
Fast withdrawals are now limited at ten per hour per address. If that creates any operational issue, you can contact us via Discord support.
👍4
Forwarded from Lighter Announcements
gm

Story Protocol ($IP) has been renamed to Data Network ($DATA). This is a rebrand only and does not affect the underlying market. The update will be reflected across the Lighter frontend and backend tomorrow, June 30, at 11:00 AM UTC.

On the API side, updates will be delivered as DATA starting at that time, while the market ID remains unchanged. No action is required.

https://x.com/datafdn/status/2070180640251666788
👍2
re: Liquidity Partner Program

Docs have been updated to reflect changes to the incentive program.

Weekly Incentives Sheet

Docs: https://docs.lighter.xyz/liquidity-partner-program
👍2
re: $LIT spot/perp

Maker fees will be enabled for Premium accounts on the $LIT perp and spot markets, effective Thursday, July 9, at 1:00 PM UTC
👍2
- The Lighter Python SDK has been updated, now supporting mainnet & testnet environments for the RHC instance, as well as lazy nonce initialization: https://pypi.org/project/lighter-sdk/

- WebSocket total connections, and connections per minute, have been increased to 255 per IP: https://apidocs.lighter.xyz/docs/rate-limits

- The export endpoint now allows to aggregate trades: https://apidocs.lighter.xyz/reference/export

- We're removing internal price caps for the below markets before today's market close. To prevent price manipulation attacks, we are going to monitor other liquid venues and cap the price in case of a manipulation attempt. For the other markets, no changes apply.

SPY, US500, QQQ, US100, XAU, XAG, NVDA, TSLA, AAPL, AMZN, MSFT, GOOGL, META, XCU, SNDK, WTI, XPD, XPT, BRENTOIL, MU, EWY, SPCX, DRAM, SOXL, SKHYNIXUSD, SAMSUNGUSD, INTC, NATGAS, IBM, AMD, MSTR
👍1
- The accountOrders endpoint has been added, allowing to query the status of up to 20 client_order_index, separated by a comma. The order json(s) will be returned: https://apidocs.lighter.xyz/reference/accountorders

- mark_price and index_price have been added to the orderBookDetails endpoint: https://apidocs.lighter.xyz/reference/orderbookdetails
2👍1
- Front-end now allows editing multiple api keys at once to toggle maker-only status: https://apidocs.lighter.xyz/reference/apikeys. For latency-sensitive traders we strongly recommend their usage, more details can be found here: https://apidocs.lighter.xyz/docs/api-keys#maker-only-api-keys

- The positionFunding endpoint now accepts a market_ids query parameter, which can contain a list of market indexes separated by commas: https://apidocs.lighter.xyz/reference/positionfunding

- The fundings endpoint caching has been improved, fixing some edge cases where the last funding payment was showing up as empty: https://apidocs.lighter.xyz/reference/fundings

These changes apply to both Lighter Core, and the Robinhood Chain instance (https://apidocs.rh.lighter.xyz/).
1
- We have released v1.0.7 of the Lighter Go SDK. Release notes are available here: https://github.com/elliottech/lighter-go/releases/tag/v1.0.7

- The remaining_usage field will not be returned anymore by the referral/get and referral/create endpoints, starting Monday, Jul 27th. Currently, both Lighter Core and the RHC instance allow for unlimited invites
1
We will be performing a network upgrade on August 9, 2026 at 1:00 PM UTC. Expected downtime is under 15 minutes.

Please manage your positions in advance, as order placement will be unavailable during the upgrade.