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
gm

We will be performing scheduled maintenance for https://robinhoodchain.lighter.xyz on Friday, August 21 at 11:00 AM UTC. Expected downtime is under 15 minutes.

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

You can also subscribe to https://robinhoodstatus.lighter.xyz to receive notifications and updates.
👍2
Builders can now leverage https://fun.xyz/ routes to deposit to Lighter Core programmatically. Initially, USDC and ETH (which is swapped to USDC) are supported as deposit assets, from 15 chains. Full implementation details are available here: https://apidocs.lighter.xyz/docs/deposits-transfers-and-withdrawals#deposit-via-funxyz

Each builder will be issued an api key to be used in headers. You can reach out via the #support channel on Discord including details on your project to receive one: https://discord.gg/lighterxyz

Currently, the integration is enabled on Lighter Core, with plans on expanding it to the Robinhood Chain instance in the near future. Support for withdrawals is also planned.
👍3
gm

We will be performing a network upgrade on Sunday, August 23 at 12:00 PM UTC. Expected downtime is under 15 minutes.

Please manage your positions in advance, as order placement will be unavailable during the upgrade.
👍2
This media is not supported in your browser
VIEW IN TELEGRAM
gm

If you're a market maker interested in participating in Lighter's RFQ flow, you can find the integration docs here. We expect RFQ flow to increase meaningfully now that the feature is open to all traders.


https://x.com/Lighter_xyz/status/2090905273065955741
👍4
gm

Advanced Order Fee Update

As a reminder, Standard accounts will now have a 0.01% (1 bp) fee on RFQ, Chase Limit, and TWAP orders.

Plus and Premium accounts will continue to have their normal tier fees.

Limit and Market orders remain free.
👍6
The following changes have been deployed to both Lighter Core, and the Robinhood Chain instance:

• An order_version parameter can now be specified when modifying an order, with both available SDKs supporting it. This guarantees correct ordering, where the sequencer will reject any version that is not strictly greater than the order's current stored version, returning AppErrInvalidOrderOrderVersion.
Order events now include order_version
Trade events now include ask_order_version, bid_order_version

The above remains optional, and existing workflows will not break. Examples on how to use order_version are available here (http) and here (ws)
👍2
The following changes have been deployed to Lighter Core:

sendTx/sendTxBatch rate limits for the best premium tier have been increased by 20%, now at 48,000 transactions per minute
• Trades executed through the partner attribution program, with non-zero integrator fees, will not be considered for kickbacks and rebates: https://docs.lighter.xyz/referral-program

The following change has been deployed to the Robinhood Chain instance:

• Volume tier thresholds (which determine rate limits for premium accounts) have been temporarily lowered, requiring $500M volume in the last 14 days to access the best tier: https://apidocs.rh.lighter.xyz/docs/account-types. Thresholds will be adjusted upwards as venue activity increases
👍2
- Latency-sensitive traders on the best premium tier will be able to directly access our APIs by skipping AWS CloudFront, starting September 4th, 1 PM UTC (timestamp : 1788526800). Alternatively, Fee Credits used to access staking benefits must have at least 90 days remaining before expiry. Whitelisting can be processed via Discord #support, or existing communication channels. Only Premium accounts will be supported, on both Lighter Core and the Robinhood Chain instance.

- Starting September 14th, 1 PM UTC (timestamp: 1789390800), trades via Partner Attribution with non-zero integrator fees coming from Standard accounts will be rejected, as well as integrator approvals. Existing partners should update their logic, so that their clients' account types are set to Plus or Premium accounts (changes can be processed using changeAccountTier). See account types and related fees for Lighter Core and the Robinhood Chain instance.

- Deposits via fun.xyz now support 22 assets across 12 blockchains, including native assets such as Bitcoin. Builders can decide whether USDC, or ETH, gets credited: https://apidocs.lighter.xyz/docs/deposits-transfers-and-withdrawals#deposit-via-funxyz
2👍2
gm

We will be performing a network upgrade on Sunday, August 30 at 11:00 AM UTC. Expected downtime is under 15 minutes.

Please manage your positions in advance, as order placement will be unavailable during the upgrade.
👍1
The following changes to account types have been deployed to Lighter Core,

Standard Accounts:
- Latency: 300ms (taker), 300ms (cancel), 0ms (post-only)
- Fast withdrawals: $3 flat, where staking no longer waives this fee
- Active orders: 250 (total), 30 (per market)
- Pending orders: 50 (total), 10 (per market)
- New accounts will be able to create up to 4 sub-accounts

Plus Accounts:
- Fast withdrawals: 10 free per day, $1 flat afterwards
- Active orders: 750 (total), 250 (per market)
- Pending orders: 500 (total), 100 (per market)
- SendTx(Batch) limit set to 4000 per minute
- Read-only requests match those of Premium accounts, 24000 weighted per minute
- Traders can now create up to 16 sub-accounts

Premium accounts:
- Latency: 140ms (taker), for all tiers. Maker and cancel orders stay at 0ms
- Fast withdrawals: unlimited, free
- Active orders: 1500 (total), 1000 (per market)
- Pending orders: 1000 (total), 100 (per market)
- Traders can now create up to 64 sub-accounts, regardless of tier

Sub-accounts cannot be deleted, so they should be created with care, as switching to account types that allow fewer of them will not be permitted.

Changing account type is now permitted without having to close positions, or orders.

Additionally, public pools can now be created after reaching $10M in traded volume via a Plus o Premium account, without any sort of whitelist required.

Changes can be reviewed here: Account Types, Rate Limits.
5👎5
- Users should make sure to provide a properly formatted memo in their fast withdrawal requests, stating their l1 address in it, as in the following example: https://github.com/elliottech/lighter-python/blob/main/examples/transfers/withdraw_fast.py. Starting September 7th, 1 PM UTC (timestamp: 1788786000), wrongly formatted memos will be rejected.

- Lighter's WASM has been updated, now supporting the approval of integrators, and relevant integrator fee attributes: https://github.com/elliottech/lighter-go/commit/f9829c1f26d4761226b875c15b79b9730f60e0b9
👍1
gm

We will be performing scheduled maintenance for Lighter on Robinhood Chain on Saturday, September 5 at 12:00 PM UTC (your local time. Expected downtime is under 5 minutes.

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

You can also subscribe to https://robinhoodstatus.lighter.xyz to receive notifications and updates.
2
gm

We will be performing a network upgrade on Sunday, September 6 at 11:00 AM UTC. Expected downtime is under 15 minutes.

Please manage your positions in advance, as order placement will be unavailable during the upgrade.
2
- Users can now export individual days of global trade events with the newly added historicalTrade endpoint, which returns a pre-signed S3 URL that includes a parquet file. Details can be found here: https://apidocs.lighter.xyz/docs/historical-data (Lighter Core), https://apidocs.rh.lighter.xyz/docs/historical-data (RHC instance). We're planning to open access to an AWS S3 Bucket via Requester Pays as well, and provide more datasets down the road - we're keen to hear what data you'd like to access next.

- Following the next upgrade on Saturday: https://t.me/lighter_api_updates/170, the Plus account type will be made available on the Robinhood Chain instance as well. Builders should be aware of the upcoming breaking changes on September 14th: https://t.me/lighter_api_updates/166

- The Lighter Python SDK now includes examples on how to set up TWAP, market TP, and market SL orders: https://github.com/elliottech/lighter-python/commit/fd4ee2530f78940cbed3dd80131d0fa66f74ad2a

- Direct access to skip AWS CloudFront has been enabled for the initial cohort of users. Interested parties that meet requirements (best staking tier, premium accounts) can contact us via #support on Discord to get access.
1
- Rate limits for L1Withdrawal have been increased to 10 per hour, per user

- Fees for fast withdrawals have been reduced to $1 for Standard accounts

- Starting September 13th, 11 AM UTC (timestamp:1789297200) the smallClampedPremium formula will be updated as follows: https://docs.lighter.xyz/trading/funding#funding-rate-calculation
👍1
Legacy market IDs were bounded to [0, 255) for perp markets, and [2048, 4096) for spot markets. Testnet now adopts a new logic for assigning IDs to new markets, using 64 bit integers, starting at 4095. It is expected for market IDs to differ from mainnet, with current ones on testnet visible here: https://testnet.zklighter.elliot.ai/api/v1/orderBookDetails

This change will be deployed to Lighter Core Mainnet this Sunday (the exact time will be shared shortly), there will be no breaking changes for existing markets, which will maintain their current index - however, newly deployed markets (both perpetual, and spot ones) will pick the next free index >= 4095. For both cases, no other changes are required.

Traders can differentiate the type of market using the "market_type" field returned by the orderBookDetails, orderBooks endpoints - we strongly advise against making assumptions based on IDs going forward, e.g. assuming that whenever market_id >= 2048, it'll be a spot market.

That is particularly important for using WebSockets, as some channels are specific to a certain type of markets (e.g. spot_market_stats; market_stats); or when updating perp-specific parameters, such as isolated/cross margining of a position.

Mind that you're required to update your SDK to the latest version in order to support trading for these newly deployed markets.
👍4
gm

We will be performing a network upgrade on Sunday, September 13 at 11:00 AM UTC. Expected downtime is under 20 minutes.

Please manage your positions in advance, as order placement will be unavailable during the upgrade.
👍1
- Starting tomorrow, the following changes to partner attribution will be deployed: https://t.me/lighter_api_updates/166. Make sure to update your logic beforehand to avoid disruptions - rejected trades and approvals will start returning error 21520.

- We have open-sourced a TypeScript client demo, so that builders can now easily access the building blocks necessary to feed lighter data into their apps: https://x.com/Lighter_xyz/status/2098121539082187043
- The fun.xyz deposit flow now allows to generate a quote to estimate fees, received amount, and time to credit to the deposit: https://apidocs.lighter.xyz/docs/deposits-transfers-and-withdrawals#generate-a-quote-optional
- Arc Mainnet deposits are now supported via the CCTP deposit flow: https://apidocs.lighter.xyz/docs/deposits-transfers-and-withdrawals#legacy-deposit-usdc-via-other-evm-compatible-chains
- @lighter_testnet (#testnet-updates on Discord) will be used to share testnet-specific updates, such as hard resets and upcoming features up for testing

Changes to endpoint weights:
- accountOrders and accountActiveOrders decreased from 300 to 100
- trades decreased from 600 to 200
- exchangeMetrics decreased from from 300 to 120

Find complete details about rate limits and weights here: https://apidocs.lighter.xyz/docs/rate-limits

The above applies to the Lighter Core instance. The testnet channels will be used for both instances.
👍1
gm

We will be performing a network upgrade on Sunday, September 20 at 11:00 AM UTC. Expected downtime is under 20 minutes.

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