Skip to main content
Version: pre-release (v0.79)

Providing active liquidity

To be eligible to receive liquidity fee revenue using an active liquidity strategy, you will need to submit a liquidity commitment transaction, and then place orders to support that commitment.

Once you commit to a market, to receive fee revenue, you need to have a certain percentage of your commitment amount on the order book for a minimum amount of time in each epoch.

These minimums are known as the liquidity SLA. The better your performance is against the SLA, the more fee revenue you'll receive. Not meeting the SLA will result in fee payments being withheld for that epoch, and it will have an impact on future fee revenue earnings.

Liquidity commitments

If you want to provide liquidity and receive a portion of liquidity fees paid, you need to submit a liquidity commitment transaction. The commitment is the amount of stake an LP places as bond on the market, to earn rewards.

You will need enough of the settlement asset to set aside as bond and then to fulfill the orders to meet your commitment.

Liquidity providers using this method will need to actively manage their commitment.

The commitment transaction needs to contain:

Required amount of liquidity

The amount an LP will actually need to have available on the order book is called the liquidity obligation.

That is calculated by:

Commitment * market.liquidity.stakeToCcyVolume (a network parameter), measured in price level x volume, i.e. settlement currency of the market.

Once you commit to a market, you need to meet the minimum set by the liquidity SLA. The percentage of your commitment amount and minimum time are set for each individual market. Exceeding the minimum leads to more fee revenue. Not meeting the minimum means fee revenue is withheld, plus extra penalties.

When to commit liquidity

You can commit liquidity to a market at any time in the market's lifecycle when it is accepting orders.

When a market is in opening auction: It's possible to submit the liquidity commit transaction and start putting orders on the book as soon as a market’s governance proposal is submitted and accepted. That means it can be done even before the governance voting period concludes, as well as at any time while the market is trading. Doing so will give you a higher equity-like share on the market, which can lead to a higher share of fee revenue.

You'll need to submit your orders from the end of the opening auction.

When a market is in normal trading: If you commit once a market is already open for trading, you'll need to submit your orders by the start of the next epoch. SLA performance will be measured from the epoch after the one in which you submitted your liquidity commitment transaction.

Equity-like share

By committing liquidity, a liquidity provider gets a share of the market's fees. Liquidity providers who get into a market early benefit from helping to grow the market. Their share of the market, called the equity-like share, allows them to earn a larger share of the market's trading fees than their actual commitment would imply, assuming the trading volume on the market increases with time. This is called an LP’s equity-like share, and it is used to divide fee revenue between LPs.

A liquidity provider's equity-like share is then carried over to the market’s successor, if a successor market comes to exist. The LP will then need to provide liquidity on the successor market while it's pending to keep that equity-like share active. The equity-like share on a successor market is calculated using the difference between the physical stake present on the parent market and the stake committed to the successor market.

Try it out

Tutorial: Committing liquidity: See sample bot code for setting up and managing a liquidity commitment.

Liquidity bond

When committing liquidity, the commitment amount is set aside as bond, and the orders created for commitment are funded by assets in the LP’s general account.

Bond functions like an extra margin requirement to back up the LP’s commitment to stay with the market. In return for that commitment, liquidity providers get access to proceeds from liquidity fees, which are not available to other market participants.

The bond total will remain in the bond account for as long as the LP chooses to commit to the market. This is a guarantee for the provider's liquidity obligation, to ensure that the commitment is firm and the market can rely on that liquidity in any market conditions, even if the provider's margin and general accounts have been depleted.

The bond committed during the liquidity commitment transaction is stored in a bond account (one per party, per market). Deposits and withdrawals for the bond account are governed by the protocol and cannot be manually triggered.

Liquidity commitment for a spot market

In almost all ways, providing liquidity to a spot market is the same as for other markets. There are minor differences when considering the commitment and how much to have available to support a spot market commitment.

Providing liquidity to a spot market requires setting aside a set amount of commitment as bond, using the market's quote asset. The orders for the commitment need to provide the full amount of assets required to support the liquidity for both the buy and sell side.

Example

An LP has submitted a commitment and has an obligation to provide 100,000 USDT worth of buy orders and sell orders.

If that LP places a BUY order of size 200 at price 500, they have a notional order value of 100,000 USDT. Therefore, they are meeting the obligation for buy orders. They would need to have 100,000 USDT available to cover this.

If that LP places a SELL order of size 50 at price 2000, they have a notional order value of 100,000 USDT. Therefore, they are meeting the obligation for sell orders. They would need to have 50 BTC available to cover this.

Price range for liquidity orders

A market’s governance proposal includes a liquidity provision price range. That range determines which orders count towards the LP meeting their commitment to the market. The range determines the furthest away from the mid-price the orders can be. Anything outside of that range won’t count towards an LP’s commitment, and thus doesn’t count towards meeting the SLA.

When in an auction, the price range is calculated slightly differently, instead of utilising the mid price for both sides:

  • The maximum price is defined by max(last trade price, indicative auction uncrossing price) * (1 + price range).
  • The minimum price is defined by min(last trade price, indicative auction uncrossing price) * (1 - price range).

Target stake for a market

How much a market aims to have in liquidity is called the target stake. It depends on market conditions and how much is already committed.

Target stake is used by the protocol to:

  • Calculate the market's liquidity fee level from the liquidity commitments
  • Determine the maximum amount an LP can reduce their commitment before being penalised for providing too little liquidity
Query for data

Target stake calculation

The market's target stake is calculated using the maximum open interest observed over a rolling time window and a reference price, and then scaled:

target_stake = reference_price x max_oi over market.stake.target.timeWindow x max(risk_factor_short, risk_factor_long) x market.stake.target.scalingFactor

The formula above uses these network parameters:

  • Rolling time window: market.stake.target.timeWindow
  • Scaling factor: market.stake.target.scalingFactor

Amending and cancelling a liquidity commitment

You can also amend or cancel a liquidity commitment.

You can submit the transaction at any time, but the change is only enacted at the start of the following epoch. If you increase your commitment, the extra assets are moved into your bond account immediately.

Decreasing or cancelling your liquidity commitment will lead to penalties if the market needs that liquidity to stay at its target stake.

How much of your bond is forfeited is determined by the early exit penalty, set per each market. You can query a market details or review a market's governance proposal to see the early exit penalty.

Your equity-like share is also reduced in line with a liquidity commitment decrease.

If there are any open positions that were created from your orders, they will not be closed when your liquidity commitment is cancelled.

The transaction to amend a liquidity commitment includes the same fields as submitting a commitment, just modify the fields you want to be amended with your new values. The cancel transaction only requires the market ID for the market that you want stop committing on.