Mint 'Rank By' Filter Metrics

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

Note: this applies ONLY to ranking mints. Not the "rank_by" parameter in the markets_per_mint object found in the /loot endpoint.

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