# x402.forgemesh.io Heat Alerts API

> x402.forgemesh.io Heat Alerts API is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-15).

Returns all currently active US heat advisories, extreme heat warnings, and excessive heat warnings as normalized JSON, including affected zones, severity, urgency, and full alert text.

## Facts

- Endpoint: POST https://x402.forgemesh.io/heat-alerts
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-forgemesh-io-heat-alerts-api-6e4b13ee
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mU4wnauzP6LBvYtUFRwaJ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402-forgemesh-io-heat-alerts-api-6e4b13ee -d '<json body>'
```

Example prompt: Pull all the heat alerts that are currently active anywhere in the United States — I need the affected zones, severity, urgency, and full alert text so I can decide whether to cancel tomorrow's outdoor construction work.

## When to prefer this

Use this endpoint when you need a real-time, aggregated snapshot of all active US heat alerts in a single normalized JSON call — ideal for outdoor labor safety systems, public health notification agents, event management bots, or any workflow that needs to react to active heat emergencies without parsing raw NWS feeds. Prefer over scraping NWS directly since data is pre-normalized and returned as structured JSON.

## Known failure modes

- Empty list returned when no heat alerts are active (not an error — legitimate state outside heat season or during mild weather)
- Payment failure if x402 USDC payment of $0.004 is not provided or rejected
- Network timeout if NWS upstream data source is slow or unavailable
- Stale data up to 5 minutes old due to cache refresh interval

## How this service works

Heat alert API: every Heat Advisory, Extreme Heat Warning, and Excessive Heat Warning currently active anywhere in the United States — affected zones, severity, urgency, and full alert text — as normalized JSON. Use for outdoor-labor safety, public-health notification, and event-cancellation agents. Public-domain government data, cached 5 minutes. Legitimately returns an empty list outside of active heat events.

## Output

A normalized JSON list of all currently active US heat alerts (Heat Advisory, Extreme Heat Warning, Excessive Heat Warning), each with affected geographic zones, severity level, urgency level, event type, and full alert text. Returns an empty list when no heat events are active. Data is cached and refreshed every 5 minutes from NWS.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "type": "FeatureCollection",
   "features": [
    {
     "properties": {
      "event": "Extreme Heat Warning",
      "areaDesc": "Coachella Valley",
      "severity": "Severe"
     }
    }
   ]
  },
  "attribution": "US National Weather Service (public domain)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-forgemesh-io-heat-alerts-api-6e4b13ee/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)