> ## Documentation Index
> Fetch the complete documentation index at: https://motiontrade.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Conflicts

> Geopolitical conflict intelligence endpoints

## List Conflicts

<ParamField path="GET" method="/api/conflicts">
  Get active geopolitical conflicts with threat levels and market exposure.
</ParamField>

### Response

```json theme={null}
{
  "success": true,
  "conflicts": [
    {
      "slug": "ukraine-russia",
      "displayName": "Ukraine-Russia Conflict",
      "threatLevel": "high",
      "escalationScore": 0.75,
      "participantCount": 8,
      "marketCount": 25
    }
  ]
}
```

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.marketmotion.xyz/api/conflicts"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.marketmotion.xyz/api/conflicts');
  const { conflicts } = await response.json();
  ```
</CodeGroup>

***

## Get Conflict

<ParamField path="GET" method="/api/conflicts/:slug">
  Get detailed conflict information including participants, attributes, and recent events.
</ParamField>

### Path Parameters

<ParamField path="slug" type="string" required>
  Conflict slug (e.g., `ukraine-russia`)
</ParamField>

### Response

```json theme={null}
{
  "success": true,
  "conflict": {
    "slug": "ukraine-russia",
    "displayName": "Ukraine-Russia Conflict",
    "threatLevel": "high",
    "escalationScore": 0.75,
    "participants": [
      {
        "slug": "ukraine",
        "displayName": "Ukraine",
        "role": "participant"
      },
      {
        "slug": "russia",
        "displayName": "Russia",
        "role": "participant"
      }
    ],
    "attributes": {
      "region": "Eastern Europe",
      "start_date": "2022-02-24",
      "conflict_type": "interstate"
    },
    "recentEvents": [
      {
        "title": "Peace talks scheduled",
        "source": "ACLED",
        "happenedAt": "2025-01-28T10:00:00Z"
      }
    ]
  }
}
```

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.marketmotion.xyz/api/conflicts/ukraine-russia"
  ```
</CodeGroup>

***

## Conflict Signals

<ParamField path="GET" method="/api/conflicts/:slug/signals">
  Get intelligence signals for a conflict from ACLED, GDELT, and OSINT sources.
</ParamField>

### Path Parameters

<ParamField path="slug" type="string" required>
  Conflict slug
</ParamField>

### Query Parameters

<ParamField query="limit" type="number">
  Maximum results
</ParamField>

<ParamField query="offset" type="number">
  Pagination offset
</ParamField>

### Response

```json theme={null}
{
  "success": true,
  "signals": [
    {
      "id": "signal-uuid",
      "source": "ACLED",
      "type": "escalation",
      "title": "Increased shelling in Donetsk region",
      "severity": "high",
      "happenedAt": "2025-01-28T10:00:00Z",
      "location": "Donetsk, Ukraine"
    }
  ],
  "total": 150
}
```

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.marketmotion.xyz/api/conflicts/ukraine-russia/signals?limit=20"
  ```
</CodeGroup>

***

## Conflict Markets

<ParamField path="GET" method="/api/conflicts/:slug/markets">
  Get prediction markets affected by a conflict.
</ParamField>

### Path Parameters

<ParamField path="slug" type="string" required>
  Conflict slug
</ParamField>

### Response

```json theme={null}
{
  "success": true,
  "markets": [
    {
      "id": "market-uuid",
      "title": "Ceasefire in Ukraine by 2025",
      "venue": "polymarket",
      "price": 0.15,
      "volume": 500000
    }
  ],
  "total": 25
}
```

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.marketmotion.xyz/api/conflicts/ukraine-russia/markets"
  ```
</CodeGroup>