# 'Gimme The Loot' Endpoint

The all-in-one endpoint that returns hot mints, their markets, ALUTs, priority fees, and Jito tips in a single call. Highly configurable, actionable arbitrage markets.

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

**Request**

```bash
curl -X POST https://api.getfomo.bot/loot \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key-here" \
  -d '{
    "base_mints": ["So11111111111111111111111111111111111111112"],
    "exclude_mints": [],
    "max_mint_count": 1,
    "aggregation_window": 300,
    "rank_by": "momentum",
    "min_roi": 100,
    "min_volume": 2000,
    "min_txs": 15,
    "min_market_cap": 0,
    "max_market_cap": 100000000,
    "markets_per_mint": {
      "min_count": 2,
      "max_count": 4,
      "min_liquidity_usd": 500,
      "min_vol": 0,
      "min_txs": 10,
      "rank_by": "volume"
    },
    "from_wallets": [],
    "from_bots": [],
    "include_aluts": true,
    "include_priority_fees": true,
    "include_jito_tips": false,
    "exclude_dexes": ["whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc"]
  }'
```

**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>exclude_mints</strong></td><td>string[]</td><td>[]</td><td>Quote mints to exclude from results</td></tr><tr><td><strong>max_mint_count</strong></td><td>number</td><td>10</td><td>Maximum mints to return (max 20)</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>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><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>markets_per_mint</strong></td><td>object</td><td>See below</td><td>Market filtering and ranking options (see below)</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>include_aluts</strong></td><td>boolean</td><td>false</td><td>Include Address Lookup Tables</td></tr><tr><td><strong>include_priority_fees</strong></td><td>boolean</td><td>false</td><td>Include priority fee estimates</td></tr><tr><td><strong>include_jito_tips</strong></td><td>boolean</td><td>false</td><td>Include jito tip estimates</td></tr><tr><td><strong>include_dexes / exclude_dexes</strong></td><td>string[]</td><td>[]</td><td>Options: 'include_dexes' or 'exclude_dexes'. Array of program IDs to include/exclude from computed results.</td></tr></tbody></table>

**'Markets Per Mint' Object**

<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>min_count</strong></td><td>number</td><td>2</td><td>Minimum markets required per mint (2-10)</td></tr><tr><td><strong>max_count</strong></td><td>number</td><td>4</td><td>Maximum markets per mint (2-10)</td></tr><tr><td><strong>min_liquidity_usd</strong></td><td>number</td><td>100</td><td>Minimum pool liquidity in USD (0 = disabled)</td></tr><tr><td><strong>min_vol</strong></td><td>number</td><td>0</td><td>Minimum USD volume (arbitrage) in aggregation window (0 = disabled)</td></tr><tr><td><strong>min_txs</strong></td><td>number</td><td>0</td><td>Minimum transaction count in window (0 = disabled)</td></tr><tr><td><strong>rank_by</strong></td><td>string</td><td>"volume"</td><td>How to rank markets: <code>volume</code>, <code>liquidity</code>, <code>txs</code></td></tr></tbody></table>

**Response**

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

```json
{
  "success": true,
  "total_mints": 1,
  "total_markets": 4,
  "total_aluts": 2,
  "mints": [
    {
      "mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "symbol": null,
      "image": null,
      "win_count": 150,
      "volume_usd": 50000.0,
      "market_cap_usd": 25000000.0,
      "roi": 500,
      "hit_rate": 12.5,
      "market_density": 4,
      "momentum": 7.5,
      "fomometer": 0.85,
      "markets": [
        {
          "rank": 1,
          "market": "5Q544fKrFoe6tsEbD7S8EmxGTJYAKtTVhAW5Q5pge4j1",
          "dex": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
          "intermedium_mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
          "base_mint": "So11111111111111111111111111111111111111112",
          "liquidity_usd": 150000.0,
          "total_volume_usd": 1000.0,
          "total_txs": 20,
          "updated_at": "2026-01-17T12:00:00Z",
          "alut": "2immgwYNHBbyVQKVGCEkgWpi53bLwWNRMB5G2nbgYV17",
          "raw_data": ...
        }
        ...
      ]
    }
  ],
  "priority_fees": {
    "min": 1000,
    "low": 5000,
    "medium": 10000,
    "high": 25000,
    "very_high": 100000,
    "recommended": 12000
  },
  "jito_tips": {
    "min": 1000,
    "low": 5000,
    "medium": 10000,
    "high": 25000,
    "very_high": 100000,
    "recommended": 12000
  }
}
```

{% 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 %}