# Vessel Mileage for Liquidity Providing

## How to Earn?

Vessel will take one random snapshot of the orderbook **every 5 minutes** and distribute rewards based on that snapshot. Users providing liquidity within reward price range will receive Vessel Mileage. The more liquidity provided, the more Vessel Mileage collected.

Reward Spread Ratio $$R$$ for Trading Pairs

Reward Price Range

*Note: Actual reward ranges may vary based on dynamic market conditions. Please stay updated with the latest information in our community.*

### **Adding Liquidity to AMM Pool**

* Open [Voyage Page](https://trade.vessel.finance/voyage) or [Pool Page](https://trade.vessel.finance/pools) and start adding liquidity.
* Select the trading pair you wish to add liquidity.
* Confirm the price range and amount you want to provide as liquidity.
* Your liquidity will be added to the AMM pool, and you will start earning Vessel Mileage based on the effective quantity within the reward price range.

### **Referral Program**

* Invite friends to join as voyagers, and when they earn Vessel Mileage by adding liquidity to the AMM pool, you'll receive an extra 16% Vessel Mileage bonus as the inviter. (Learn more about [Referral Coins](https://vesselfinance.gitbook.io/vessel/vessel-voyage/vessel-coins-for-referral) )

## What is Navigator Boost?

Users ranking high on the leaderboard will receive additional boost. The leaderboard ranks users based on the total Vessel Mileage obtained in the last 24 hours, including both self-provided liquidity and transferred mileage from invited users. The boost for the leaderboard are as follows:

<table><thead><tr><th width="290">Navigator Leaderboard Rank</th><th>Boost</th></tr></thead><tbody><tr><td>1-10</td><td>2.5 x</td></tr><tr><td>11-20</td><td>2 x</td></tr><tr><td>21-50</td><td>1.5 x</td></tr><tr><td>51-100</td><td>1.2 x</td></tr><tr><td>100+</td><td>1 x</td></tr></tbody></table>

## What is Pool Boost?

Vessel will provide boost rewards for different pools based on market conditions and promotional plans. Voyagers can choose to participate in pools with higher boost.

## **Reward Calculation**

### **Effective Quantity Q for Rewards**

$$
P\_m = (A\_1 + B\_1)/2
$$

$$
Price Range = \[P\_m *(1-R), P\_m*(1+R)]
$$

$$
Q = min(Q\_a, Q\_b)
$$

Understanding the parameters

* $$A\_1$$: The lowest asking prices available in the orderbook.
* $$B\_1$$: The highest bidding prices available in the orderbook.
* $$P\_m$$: The average price derived from the best bid price $$B\_1$$ and ask price $$A\_1$$. It establishes the midpoint for the reward price range.
* $$R$$: The spread ratio within which liquidity provision qualifies for Vessel rewards. It varies for each trading pair.
* $$Price Range$$: The acceptable range around the market price within which liquidity provision qualifies for rewards.
* $$Q\_a$$: This represents the total amount of the base token available for sell orders within the reward $$Price Range$$.
* $$Q\_b$$: This represents the total amount of the base token available for buy orders within the reward $$Price Range$$.
* $$Q$$: The effective amount of the base token within the reward $$Price Range$$.

### **Calculation Example for** $$Q$$

* One snapshot of the BTC/USDC orderbook

  <table><thead><tr><th width="173">Side</th><th width="204">Price</th><th>BTC amount at this price</th></tr></thead><tbody><tr><td><mark style="color:red;">Sell</mark></td><td>70,040</td><td>0.9 BTC</td></tr><tr><td><mark style="color:red;">Sell</mark></td><td>70,030</td><td>1 BTC</td></tr><tr><td><mark style="color:red;">Sell</mark></td><td>70,020</td><td>1.2 BTC</td></tr><tr><td><mark style="color:red;">Sell</mark></td><td>70,010</td><td>1.5 BTC</td></tr><tr><td><mark style="color:green;">Buy</mark></td><td>69,990</td><td>1.6 BTC</td></tr><tr><td><mark style="color:green;">Buy</mark></td><td>69,980</td><td>1.2 BTC</td></tr><tr><td><mark style="color:green;">Buy</mark></td><td>69,970</td><td>0.9 BTC</td></tr><tr><td><mark style="color:green;">Buy</mark></td><td>69,960</td><td>0.7 BTC</td></tr></tbody></table>
* $$P\_m = (70010+69990)/2 = 70000$$.
* Under the assumption of a reward spread ratio of 0.05%, the reward price range would be calculated as follows:

  The reward $$PriceRange=70000\*0.0005=35$$.
* Considering the provided orderbook, the effective prices are 70030, 70020, 70010, 69990, 69980 and 69970.
* For voyager Alice, who placed a sell order at 70030 for 0.2 BTC and a buy order at 69980 for 0.3 BTC, the effective amount  is 0.2 BTC.

### **Distribution of Vessel Mileage Across Different Trading Pairs**

$$VesselMileage\_{x,s}$$ is allocated based on the trading volume. Trading Pairs with higher trading volumes receive a greater share of the total Vessel Mileage.

$$
VesselMileage\_{x,s} = \frac{V\_{x,s}\*P\_{x,s}} {\sum\_{x \in allPairs}V\_{x,s}\*P\_{x,s}}
$$

Understanding the parameters

* $$x$$: A trading pair.
* $$s$$: A snapshot.
* $$V\_{x,s}$$: The effective Volume of pair $$x$$ for snapshot $$s$$. Currently, the volume used for snapshot $$s$$based on the trading volume from the past 24 hours.
* $$P\_{x,s}$$: The pool boost of pair  for snapshot $$s$$.

### **Vessel Mileage for a Voyager in One Snapshot**

Rewards are then distributed based on the proportion of the user's effective quantity $$Q$$ to the total effective quantity across all users. To ensure a balance between the interests of Automated Market Maker (AMM) users and Market Maker (MM) users, we apply a weight  and $$w\_2$$ to the effective quantities $$Q$$ of both types of users based on market conditions.

$$
VoyagerMileage\_s= \sum\_{x \in allPairs}\frac{Q\_{AMM,u,x,s}*L\_{u,s-1}* VesselMileage\_{x,s}}{\sum^{u \in allUsers}Q\_{AMM,u,x,s}\*L\_{u,s-1}}
$$

* Understanding the parameters
  * $$u$$: A voyager.
  * $$Q\_{AMM,u,x,s}$$: The effective quantity provided by adding liquidity in AMM pool of one user $$u$$ in the trading pair $$x$$ in one snapshot $$s$$.
  * $$L\_{u,s}$$: The rank boost of the user $$u$$ in the Navigator Leaderboard in snapshot.
  * $$VesselMileage\_{x,s}$$: Total Vessel Mileage in trading pair $$x$$ in one snapshot $$s$$.
  * $$Voyager Mileage\_s$$: The Mileage distributed to one voyager in one snapshot $$s$$ according to the liquidity provided.

If you are professional market makers and want to earn rewards through limit order liquidity provision, please contact us.

Discord: <https://discord.com/invite/medhf7skKS>

Twitter: <https://twitter.com/VesselFinance>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://vesselfinance.gitbook.io/vessel/vessel-voyage/vessel-mileage-for-liquidity-providing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.