# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/worldmonitor/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/worldmonitor/aviation \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldmonitor/bootstrap \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldmonitor/climate-weather \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldmonitor/conflict-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldmonitor/cyber-threats \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldmonitor/displacement \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldmonitor/earthquakes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldmonitor/economic \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldmonitor/infrastructure \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldmonitor/intelligence \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldmonitor/maritime \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldmonitor/markets \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldmonitor/military \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldmonitor/news-feed \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldmonitor/prediction-markets \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldmonitor/research-tech \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldmonitor/supply-chain \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldmonitor/telegram-feed \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/worldmonitor/trade \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","type":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.