# Ranked Mints Endpoint

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

<mark style="color:green;">**`POST`**</mark> `https://api.getfomo.bot/mints`

**Request**

```bash
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**

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

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
  "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
    }
    ...
  ]
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "Invalid base mints supplied",
  "invalid": ["InvalidMint123"]
}
```

{% endtab %}

{% tab title="429" %}

```json
{
  "error": "Rate limit exceeded",
  "limit": 50,
  "unit": "requests/second"
}
```

{% endtab %}
{% endtabs %}