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

# Disruptions

> GDELT-sourced news signals about commodity trade disruptions — endpoints for events, trends, and per-region indicators feeding supply chain risk models.

GDELT-sourced news signals about commodity trade disruptions.

## `GET` `/api/v1/disruptions`

<Note>Requires API key.</Note>

Real-time disruption signals from global news: port closures, sanctions, trade disputes, weather events, canal blockages.

**Parameters**

| Name    | Type   | Required | Description                  |
| ------- | ------ | -------- | ---------------------------- |
| `hours` | number |          | Lookback window (default 24) |
| `query` | string |          | Title text filter            |
| `limit` | number |          | Max results (default 20)     |

**Response**

```json theme={null}
{ "signals": [{ "title", "url", "source_name", "published_at", "tone" }], "count", "timespan_hours" }
```

**Example**

```bash theme={null}
curl -X GET -H "X-API-Key: YOUR_KEY" \
  https://axiomoverwatch.io/api/v1/disruptions?hours=VALUE&query=VALUE
```