# Worldmonitor — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Monitor global events and geopolitical developments in real-time by accessing live conflict reports, military movements, cyber threats, economic indicators, maritime activity, and 15 other critical intelligence categories. Track everything from supply chain disruptions and infrastructure status to market quotes, weather patterns, and displacement data to stay ahead of worldwide geopolitical shifts.

**Category:** Government & Public Data | **Website:** [worldmonitor.app/](https://worldmonitor.app/) | **Docs:** [parse.bot/marketplace/ee7d80ad-0818-4bdf-9d23-b0fca8f9af66/worldmonitor-app-api](https://parse.bot/marketplace/ee7d80ad-0818-4bdf-9d23-b0fca8f9af66/worldmonitor-app-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### aviation

Get airport delay alerts, closures, and cancellation data for major airports worldwide.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/aviation \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### bootstrap

Get comprehensive dashboard data in bulk. Returns multiple categories at once: earthquakes, outages, service statuses, market quotes, commodity quotes, macro signals, chokepoints, sectors, ETF flows, BIS policy rates, exchange rates, shipping rates, minerals, climate anomalies, wildfires, cyber threats.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tier` | string | No | Data tier: 'fast' (earthquakes, outages, services, market/commodity quotes, macro signals, chokepoints), 'slow' (sectors, ETF flows, BIS policy/exchange rates, shipping, minerals, climate, wildfires, cyber threats), or 'all' (both combined) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/bootstrap \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tier":"<string>"}'
```

### climate_weather

Get climate anomaly data by zone or satellite wildfire/fire detection data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `type` | string | No | Data type: 'anomalies' for climate anomalies, 'wildfires' for fire detections |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/climate_weather \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"<string>"}'
```

### conflict_events

Get conflict event data: ACLED armed conflict, UCDP conflict, civil unrest, or Israel OREF alerts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `oref_endpoint` | string | No | OREF sub-endpoint for Israel alerts |
| `source` | string | No | Data source: 'acled', 'ucdp', 'unrest', 'oref' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/conflict_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"oref_endpoint":"<string>","source":"<string>"}'
```

### cyber_threats

Get active cyber threats including malware hosts, C2 servers, and threat indicators with geolocation data.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/cyber_threats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### displacement

Get global displacement and refugee data with country-level statistics and displacement flows.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `flow_limit` | integer | No | Maximum displacement flows to return |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/displacement \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"flow_limit":"<integer>"}'
```

### earthquakes

Get recent earthquake data globally with magnitude, depth, and location from USGS.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/earthquakes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### economic

Get economic data: energy/commodity prices or BIS credit-to-GDP data by country.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `type` | string | No | Data type: 'energy' or 'bis_credit' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/economic \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"<string>"}'
```

### infrastructure

Get infrastructure status: internet outages by country or service operational statuses (AWS, Azure, GCP, GitHub, etc).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `type` | string | No | Data type: 'outages' for internet outages, 'services' for service statuses |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/infrastructure \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"<string>"}'
```

### intelligence

Get intelligence data: CII risk scores per region, DEFCON/pizza intelligence status, country intel briefs, or event classification.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country name (required for country_brief type) |
| `include_gdelt` | string | No | Include GDELT data for defcon type ('true'/'false') |
| `title` | string | No | Event title to classify (required for classify type) |
| `type` | string | No | Intelligence type: 'risk_scores', 'defcon', 'country_brief', 'classify' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/intelligence \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","include_gdelt":"<string>","title":"<string>","type":"<string>"}'
```

### maritime

Get GPS jamming/spoofing detection data by H3 hex regions worldwide.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/maritime \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### markets

Get market quotes: Gulf/Middle East stock markets, cryptocurrency prices, or stablecoin data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `type` | string | No | Market type: 'gulf', 'crypto', 'stablecoins' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/markets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"<string>"}'
```

### military

Get military data: theater posture levels per region, US Navy fleet tracking, or military base locations.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `type` | string | No | Data type: 'theater_posture', 'fleet', 'bases' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/military \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"<string>"}'
```

### news_feed

Get categorized news digest from CNN, BBC, Reuters, AP, Al Jazeera, etc. Categories include politics, US, Europe, Middle East, tech, AI, finance, energy, and more.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language code |
| `variant` | string | No | Feed variant: 'full' for complete digest |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/news_feed \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>","variant":"<string>"}'
```

### prediction_markets

Get prediction market data from Polymarket. Markets can be filtered by category tag (geopolitical, tech, finance) or returned as a combined set.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum markets to return |
| `tag` | string | No | Filter by category: 'geopolitical', 'tech', 'finance'. If omitted, returns all markets combined. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/prediction_markets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","tag":"<string>"}'
```

### research_tech

Get upcoming research and technology events: conferences, earnings reports, product launches, and IPOs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `days` | integer | No | Look-ahead window in days |
| `limit` | integer | No | Maximum events to return |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/research_tech \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"days":"<integer>","limit":"<integer>"}'
```

### supply_chain

Get supply chain data: maritime chokepoint status (Suez, Hormuz, Malacca, Panama) or critical minerals market data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `type` | string | No | Data type: 'chokepoints' or 'minerals' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/supply_chain \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"<string>"}'
```

### telegram_feed

Get Telegram channel feed with breaking news and early signal intelligence from monitored OSINT channels.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of messages to return |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/telegram_feed \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### trade

Get international trade data: restrictions/tariffs or trade barriers. Returns recent trade policy actions from various countries.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum results to return |
| `type` | string | No | Data type: 'restrictions' or 'barriers' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-worldmonitor-app-api-ee7d80ad/trade \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","type":"<string>"}'
```