Ranked Mints Endpoint

Returns ranked quote mints filtered by parameters and sorted by the chosen metric.

POST https://api.getfomo.bot/mints

Request

curl -X POST https://api.getfomo.bot/mints \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key-here" \
  -d '{
    "base_mints": ["So11111111111111111111111111111111111111112"],
    "max_mint_count": 20,
    "aggregation_window": 3600,
    "exclude_mints": [],
    "from_wallets": [],
    "from_bots": [],
    "min_roi": 50,
    "min_volume": 1000,
    "min_txs": 10,
    "min_market_cap": 0,
    "max_market_cap": 50000000,
    "min_markets": 2,
    "rank_by": "momentum"
  }'

Body Fields

Field	Type	Default	Description
base_mints	string[]	["So111..."]	Target base mints (wSOL, USDC, etc.)
max_mint_count	number	10	Maximum mints to return (max 100)
aggregation_window	number	3600	Lookback window in seconds (max 43200)
exclude_mints	string[]	[]	Quote mints to exclude from results
from_wallets	string[]	[]	Only include transactions from these signers
from_bots	string[]	[]	Only include transactions from mev bots. Option: smb, notarb
min_roi	number	0	Minimum ROI in basis points
min_volume	number	0	Minimum USD volume (arbitrage)
min_txs	number	5	Minimum successful arbitrage transactions
min_market_cap	number	0	Minimum market cap in USD (0 = disabled)
max_market_cap	number	100000000	Maximum market cap in USD (0 = disabled, default 100M)
min_markets	number	2	Minimum markets required per mint (2-10)
rank_by	string	"momentum"	Ranking metric (see Mint Filter Metrics)

Response

200

{
  "success": true,
  "count": 1,
  "mints": [
    {
      "mint": "9AvytnUKsLxPxFHFqS6VLxaxt5p6BhYNr53SD2Chpump",
      "win_count": 30,
      "volume_usd": 28627.68,
      "market_cap_usd": 15000000.0,
      "roi": 491,
      "hit_rate": 180.0,
      "market_density": 6,
      "momentum": 1406.79,
      "fomometer": 0.72
    }
    ...
  ]
}

400

429