Skip to main content

​
Total Score

For any given market, a liquidity provider’s TSTS (Total Score) in an epoch is calculated as: TSMarket=(LSEpoch)a⋅(UptimeEpoch)b⋅(Volumeepoch)cTS_{Market} = (LS_{Epoch})^a \cdot (Uptime_{Epoch})^b \cdot (Volume_{epoch})^c where LSepochLS_{epoch} is the liquidity provider’s Liquidity Score in the market in the epoch, UptimeEpochUptime_{Epoch}is the liquidity provider’s Uptime score in the market in the epoch, and VolumeepochVolume_{epoch} is the liquidity provider’s total volume (maker and taker) in the market in the epoch.
aa, bb, and cc are exponent parameters that weight the different components of the formula.

​
Liquidity Score

LSEpoch=∑N=140,320min⁡(LSNBid,LSNAsk)LS_{Epoch} = \sum \limits_{N=1}^{40,320} \min(LS_{N_{Bid}}, LS_{N_{Ask}}) The liquidity provider’s Liquidity Score for a market in an epoch, LSEpochLS_{Epoch}, is the sum of the minimum between the Bid and Ask Liquidity Scores (see below) across all order book snapshots in the epoch for the relevant market, multiplied by a bespoke volatility parameter for each market (represented by Θ). This promotes dual-sided liquidity since single-sided liquidity will earn a Liquidity Score of 0 under the min⁡()\min() function. A snapshot of the order book is taken randomly every 10-100 blocks. This is approximately every minute on average, which means there are approximately 40,320 snapshots in an epoch (60⋅24⋅28=40,320).(60 \cdot 24 \cdot 28 = 40,320). In practice, the upper bound of the summation will vary depending on the actual number of snapshots in the epoch. For the purposes of this guide, we will assume that there were exactly 40,320 snapshots in the epoch. LSNBid=BidDepth1Spread1⋅Θvol+BidDepth2Spread2⋅Θvol+…∀ BidDepthi≥MinDepth and Spreadi≤MaxSpreadLS_{N_{Bid}} = \frac{BidDepth_1}{Spread_1} \cdot \Theta_{vol} + \frac{BidDepth_2}{Spread_2} \cdot \Theta_{vol} + \ldots \newline \forall \ BidDepth_i \geq MinDepth \text{ and } Spread_i \leq MaxSpread LSNAsk=AskDepth1Spread1⋅Θvol+AskDepth2Spread2⋅Θvol+…∀ AskDepthi≥MinDepth and Spreadi≤MaxSpreadLS_{N_{Ask}} = \frac{AskDepth_1}{Spread_1} \cdot \Theta_{vol} + \frac{AskDepth_2}{Spread_2} \cdot \Theta_{vol} + \ldots \newline \forall \ AskDepth_i \geq MinDepth \text{ and } Spread_i \leq MaxSpread LSNBidLS_{N_{Bid}} is the sum of all bid order depths divided by the spread of the order, multiplied by the volatility parameter for that snapshot, for all limit orders placed by the liquidity provider in snapshot NN that exceed MinDepthMinDepth in size and are within the MaxSpread.MaxSpread. LSNAskLS_{N_{Ask}} follows the same logic as LSNBidLS_{N_{Bid}}, but on the ask side of the order book. The volatility parameter is calculated as follows: Θvol(Sb)  =  min⁡ ⁣( Θmax⁡,  max⁡ ⁣{ 1,  eα σb ∣Sb−μbSb∣})\Theta_{\text{vol}}(S_b)\;=\; \min\!\bigl(\,\Theta_{\max},\; \max\!\{\,1,\; e^{\alpha\,\sigma_b\,|\frac{S_b-\mu_b}{S_b}|}\}\bigr) where μb\mu_b is the oracle price moving average over NN blocks (1000 blocks, or roughly 10 minutes), SbS_b represents the oracle price of the current block, and σb\sigma_b represents the realized volatility over NN blocks. This function has a clamp and scales well if the current oracle price deviates from the moving average, or if there is a spike in volatility over the last NN blocks. The range of Θvol∈[1,Θmax]\Theta_{\text{vol}} \in [1, \Theta_{\text{max}}] - so we bound it within a finite field. We introduce two new parameters (α,Θmax)(\alpha, \Theta_{\text{max}}) which monitor the sensitivity to volatility and a clamp. Because Θmax\Theta_{\text{max}} should trend towards the cap of 10 as described above for a 3% price move within a 10-minute span, α\alpha is currently set at 2,500. A higher value α\alpha means Θ\Theta trends towards Θmax\Theta_{\text{max}} faster, but as Θmax\Theta_{\text{max}} is currently set to 10 per market (and can be modified on a per-market basis), a higher α\alpha would not bypass that maximum. SpreadSpread is calculated from the mid-price (distance from mid-price divided by mid-price).
For the current values of MinDepthMinDepth and MaxSpreadMaxSpread, see the Formula Parameters page.

​
Uptime Score

UptimeEpoch=∑N=140,320{1if min⁡(LSNBid,LSNAsk)>00otherwiseUptime_{Epoch} = \sum \limits_{N=1}^{40,320} \begin{cases}1&\text{if } \min(LS_{N_{Bid}}, LS_{N_{Ask}}) > 0\\ 0&\text{otherwise} \\\end{cases} UptimeEpochUptime_{Epoch} is the number of order book snapshots throughout the epoch in which the liquidity provider had a positive Bid Liquidity Score and a positive Ask Liquidity Score in the market of interest. This means the liquidity provider quoted on both sides of the order book with order sizes greater than or equal to MinDepthMinDepth with spreads less than or equal to MaxSpreadMaxSpread in the snapshot. For liquidity providers who qualify for OLP rewards (for the first time ever) partway through an epoch, UptimeEpochUptime_{Epoch} is scaled based on the total number of snapshots from the moment of qualification to the end of the epoch. For example, suppose there are exactly 40,320 snapshots in an epoch and a liquidity provider qualifies for the first time with exactly 20,000 snapshots remaining. Also suppose the liquidity provider had an UptimeEpochUptime_{Epoch} of 18,0000 as defined by the scoring formula above during the remainder of the epoch. In this case, UptimeEpochUptime_{Epoch} would be scaled to 1800020000∗40320=36288\frac{18000}{20000}*40320 = 36288.
For addresses that qualify partway through an epoch but have qualified in the past (the address failed to maintain eligibility at some point), UptimeEpochUptime_{Epoch} will not be scaled. This is to disincentivize addresses from losing their eligibility from epoch to epoch.

​
Volume

VolumeVolume is a liquidity provider’s cumulative eligible maker and taker volume in the market during the epoch.

​
Fully Expanded Formula

The fully expanded formula is: TSMarket=TS_{Market} = (∑N=140,320min⁡(LSNBid,LSNAsk))a⋅(∑N=140,320{1if min⁡(LSNBid,LSNAsk)>00otherwise)b⋅Volumec\left(\sum \limits_{N=1}^{40,320} \min(LS_{N_{Bid}}, LS_{N_{Ask}})\right)^a \cdot \left(\sum \limits_{N=1}^{40,320} \begin{cases}1&\text{if } \min(LS_{N_{Bid}}, LS_{N_{Ask}}) > 0\\ 0&\text{otherwise} \\\end{cases} \right)^b \cdot Volume^c where\text {where} LSNBid=BidDepth1Spread1⋅Θvol+BidDepth2Spread2⋅Θvol+…∀ BidDepthi≥MinDepth and Spreadi≤MaxSpreadLS_{N_{Bid}} = \frac{BidDepth_1}{Spread_1} \cdot \Theta_{vol} + \frac{BidDepth_2}{Spread_2} \cdot \Theta_{vol} + \ldots \newline \forall \ BidDepth_i \geq MinDepth \text{ and } Spread_i \leq MaxSpread LSNAsk=AskDepth1Spread1⋅Θvol+AskDepth2Spread2⋅Θvol+…∀ AskDepthi≥MinDepth and Spreadi≤MaxSpreadLS_{N_{Ask}} = \frac{AskDepth_1}{Spread_1} \cdot \Theta_{vol} + \frac{AskDepth_2}{Spread_2} \cdot \Theta_{vol} + \ldots \newline \forall \ AskDepth_i \geq MinDepth \text{ and } Spread_i \leq MaxSpread
For information on individual reward calculations each epoch, see the Reward Allocations page.