Alerts

Alert system endpoints

Alert Inbox

GET

Get the alert inbox with filtering and pagination.

Query Parameters

limit · number · default: "50"

Results per page (max: 100)

offset · number · default: "0"

Pagination offset

type · string

Filter by alert type: injury, arbitrage, political, finance, crowding, conflict, rumor

Response

{
  "success": true,
  "data": {
    "alerts": [
      {
        "id": "alert-uuid",
        "type": "injury",
        "subtype": "nfl",
        "headline": "Patrick Mahomes listed as questionable",
        "sentAt": "2025-01-28T10:00:00Z",
        "entity": {
          "slug": "patrick-mahomes",
          "displayName": "Patrick Mahomes"
        }
      }
    ],
    "pagination": {
      "total": 150,
      "limit": 50,
      "offset": 0
    },
    "unreadCount": 12
  }
}

cURL

curl "https://api.marketmotion.xyz/api/alerts/inbox?type=injury&limit=20"

---

Get Alert

GET

Get full alert details including entity context, related markets, and cross-venue data.

Path Parameters

id · string · required

Alert ID

Response

{
  "success": true,
  "data": {
    "id": "alert-uuid",
    "type": "injury",
    "subtype": "nfl",
    "headline": "Patrick Mahomes listed as questionable",
    "sentAt": "2025-01-28T10:00:00Z",
    "entity": {
      "slug": "patrick-mahomes",
      "displayName": "Patrick Mahomes",
      "entityType": "person",
      "attributes": { ... }
    },
    "relatedMarkets": [
      {
        "title": "Chiefs to win Super Bowl",
        "venue": "polymarket",
        "price": 0.35
      }
    ],
    "crossVenueData": { ... },
    "attribution": { ... },
    "engagement": {
      "read": true,
      "dismissed": false,
      "acted": false
    }
  }
}

cURL

curl "https://api.marketmotion.xyz/api/alerts/alert-uuid"

---

Alert Outcome

GET

Get outcome tracking data for an alert — how the market moved after the alert was sent.

Path Parameters

id · string · required

Alert ID

Response

{
  "success": true,
  "data": {
    "id": "alert-uuid",
    "type": "injury",
    "subtype": "nfl",
    "asset": "patrick-mahomes",
    "headline": "Mahomes listed as questionable",
    "sentAt": "2025-01-28T10:00:00Z",
    "hoursSinceAlert": 24,
    "outcomeTracked": true,
    "outcomeTrackedAt": "2025-01-29T10:00:00Z",
    "priceAtAlert": 0.35,
    "priceAt1h": 0.32,
    "priceAt4h": 0.30,
    "priceAt24h": 0.28,
    "priceAtResolution": 0.25,
    "priceChange1hBps": -300,
    "priceChange4hBps": -500,
    "priceChange24hBps": -700,
    "expectedDirection": "down",
    "actualDirection1h": "down",
    "actualDirection24h": "down",
    "directionCorrect": true,
    "outcomeScore": 0.85,
    "outcomeNotes": "Market moved as expected after injury downgrade"
  }
}

cURL

curl "https://api.marketmotion.xyz/api/alerts/alert-uuid/outcome"

---

Outcome Stats

GET

Get aggregate alert performance statistics.

Query Parameters

days · number · default: "30"

Lookback period in days

type · string

Filter by alert type

entity · string

Filter by entity slug

Response

{
  "success": true,
  "data": {
    "totalAlerts": 500,
    "trackedAlerts": 450,
    "directionAccuracy": 0.72,
    "averageScore": 0.65,
    "byType": {
      "injury": { "count": 200, "accuracy": 0.78 },
      "arbitrage": { "count": 100, "accuracy": 0.85 },
      "political": { "count": 80, "accuracy": 0.60 }
    }
  }
}

cURL

curl "https://api.marketmotion.xyz/api/alerts/outcomes/stats?days=30&type=injury"

---

Top Outcomes

GET

Get top-performing alerts by outcome score.

Query Parameters

limit · number · default: "10"

Maximum results (max: 50)

Response

{
  "success": true,
  "data": [
    {
      "id": "alert-uuid",
      "type": "injury",
      "headline": "Mahomes listed as out",
      "outcomeScore": 0.95,
      "priceChange24hBps": -1200,
      "directionCorrect": true
    }
  ]
}

cURL

curl "https://api.marketmotion.xyz/api/alerts/outcomes/top?limit=10"