# Markets Endpoint

Returns market/pool data for specified mints. Returned markets are ranked by `volume`.

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

**Request**

```bash
curl -X POST https://api.getfomo.bot/markets \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key-here" \
  -d '{
    "mints": ["DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"],
    "include_dexes": ["675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8"],
    "base_mints": ["So11111111111111111111111111111111111111112"],
    "min_liquidity_usd": 100,
    "max_markets_per_mint": 4,
    "aggregation_window": 3600,
    "include_raw_market_data": 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>mints</strong></td><td>string[]</td><td>["Fbmm..."]</td><td>Intermedium mints to fetch markets for</td></tr><tr><td><strong>include_dexes</strong></td><td>string[]</td><td>["so11..."]</td><td>DEX program IDs to include. See <a href="../../readme"><strong>overview</strong></a> for list of available.</td></tr><tr><td><strong>base_mints</strong></td><td>string[]</td><td>["so11..."]</td><td>Base mints (wSOL, USDC, USD1)</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>max_markets_per_mint</strong></td><td>number</td><td>4</td><td>Maximum markets per mint (2-10)</td></tr><tr><td><strong>aggregation_window</strong></td><td>number</td><td>3600</td><td>Lookback window in seconds for volume/tx stats</td></tr><tr><td><strong>include_raw_market_data</strong></td><td>boolean</td><td>false</td><td>Include raw market data bytes</td></tr><tr><td><strong>exclude_dexes</strong></td><td>string[]</td><td>[]</td><td>DEX program IDs to exclude</td></tr></tbody></table>

**Response**

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

```json
{
  "success": true,
  "count": 1,
  "markets": [
    {
      "mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "markets": [
        {
          "pubkey": "5Q544fKrFoe6tsEbD7S8EmxGTJYAKtTVhAW5Q5pge4j1",
          "owner": "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",
          "raw_data": ...
        }
        ...
      ]
    }
  ]
}
```

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