# Mint 'Rank By' Filter Metrics

Parameter `rank_by` options available are: `roi`, `volume`, `win_count`, `hit_rate`, `market_density`, `momentum`, and `fomometer`.

{% hint style="warning" %}
**Note:** this applies ONLY to ranking mints. Not the "rank\_by" parameter in the **`markets_per_mint`** object found in the /loot endpoint.
{% endhint %}

**ROI (Transaction-Weighted)**

* **Description:** Average return per arbitrage swap across all qualifying swaps. Each successful transaction is weighted equally regardless of trade size. In basis points, i.e. 100 = 1%.
* **Description For Dummies:** add up the profit percentage from each winning swap, divide by how many wins you had. Tells you the typical success rate per swap.
* **Formula:** `μ_roi = ( Σ roi_bps ) / win_count`

**Volume (Total)**

* **Description:** Total base-side dollars that flowed through the mint in the window after filters.
* **Description For Dummies:** count how many dollars you actually pushed through that mint — like adding water you poured through a pipe.
* **Formula:** `Σ base_usd (after commitment filters)`

**Transactions (Win Count)**

* **Description:** Total number of successful swaps captured in the window.
* **Description For Dummies:** how many times you actually pulled off the trick. Think of score tally on the arcade machine.
* **Formula:** `count of arbitrage swaps in window (Σ 1)`

**Hit Rate (per-hour density)**

* **Description:** Frequency of successful trades normalized per hour.
* **Description For Dummies:** instead of total tickets, how many you win each hour you play. Higher means the machine pays out often.
* **Formula:** `hits_per_hour = total_txs / (decay_window_seconds / 3600)`

**Market Density (DEX count)**

* **Description:** Number of distinct DEX programs offering this mint.
* **Description For Dummies:** how many different rides your token can hop on. More rides mean more ways to win.
* **Formula:** `breadth = |{ dex_program }| for a mint`

**Momentum (ROI × Win Count)**

* **Description:** Blends profitability with consistency; higher when ROI stays sturdy and the wins keep rolling in.
* **Description For Dummies:** take the profit percentage of each win and pile up how many wins you stacked — steady grinders float to the top.
* **Formula:** `score = (μ_roi_bps / 10_000) × win_count`

**Fomometer (Composite Rank)**

* **Description:** Weighted z-score blend that favours ROI, momentum, and market density, so the hottest mints bubble to the top without extreme outliers.
* **Description For Dummies:** Imagine four judges — profit, power, speed, and crowd size — each holding score cards. Mix their grades, keep the wild ones tame, and you get the final edge score for the token.
* **Formula:** `MYOB`
