# Market Sentiment Endpoint

Returns real-time arbitrage market sentiment from recent transaction activity — so you know when it’s hot and when to sit it out.

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

**Request**

```bash
curl -X POST https://api.getfomo.bot/market-sentiment \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key-here" \
  -d '{
    "aggregation_window": "12hr"
  }'
```

**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>aggregation_window</strong></td><td>string</td><td>12hr</td><td>Time window for sentiment. Options: <code>1hr</code>, <code>6hr</code>, <code>12hr</code></td></tr></tbody></table>

**Sentiment Levels**

<table><thead><tr><th width="100.8671875">Level</th><th width="138.44140625">Label</th><th width="116.078125">Tx/Min</th><th>Description</th></tr></thead><tbody><tr><td><strong>3</strong></td><td>wagmi</td><td>≥ 278</td><td>Massive volume. Heavy market activity and consistent opportunities.</td></tr><tr><td><strong>2</strong></td><td>neutral</td><td>≥ 243</td><td>Decent volume, nothing crazy. You'll find wins, but don't expect infinite freebies.</td></tr><tr><td><strong>1</strong></td><td>meh</td><td>≥ 168</td><td>Light volume. Markets not moving much, triggers are sparse, and most opportunities are basically dust.</td></tr><tr><td><strong>0</strong></td><td>ngmi</td><td>&#x3C; 168</td><td>Dead tape. Volume sucks, opportunities are thin (non-existent), and you're more likely to burn fees than print.</td></tr><tr><td><strong>null</strong></td><td>none</td><td>--</td><td>Insufficient activity for reliable sentiment.</td></tr></tbody></table>

**Response**

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

```json
{
  "success": true,
  "market_sentiment": {
    "sentiment_level": 3,
    "label": "wagmi",
    "description": "Massive volume. Heavy market activity and consistent opportunities.",
    "window": "12hr",
    "total_transactions": 315000,
    "total_volume_usd": 4500000.0,
    "avg_roi_bps": 185.5,
    "tx_per_min": 327.3
  }
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "Invalid window",
  "invalid": ["24hr"]
}
```

{% endtab %}

{% tab title="429" %}

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

{% endtab %}
{% endtabs %}