# Disruption Intelligence Ripple Brief API

> Disruption Intelligence Ripple Brief API is a paid API for AI agents from disruption.forgemesh.io, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-14).

Returns a ranked commercial readout of downstream business disruption signals derived from WARN filings, labor events, and regional economic data

## Facts

- Endpoint: GET https://disruption.forgemesh.io/ripple/brief
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/disruption-intelligence-ripple-brief-api-4c6e91da
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zFGLIZnj-Cm4HiJUvHoqF

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 disruption-intelligence-ripple-brief-api-4c6e91da
```

Example prompt: Pull me a disruption intelligence ripple brief focused on the logistics industry — give me up to 5 gold-tier signals so I can see which downstream businesses are most exposed right now.

## When to prefer this

Use this endpoint when you need a fast commercial intelligence brief on labor disruption ripple effects — particularly when selling into or monitoring accounts exposed to WARN filings, regional layoffs, or economic contraction events. Prefer this over generic news APIs or economic data feeds when you need pre-interpreted commercial angles and downstream impact paths, not raw data.

## Known failure modes

- Invalid scope value (not 'all', 'gold', or 'watchlist') returns a validation error
- limit exceeding 10 is clamped or rejected
- No matching signals for the given query returns empty delivered_signals array with inventory counts of zero
- Payment failure (insufficient USDC balance or x402 protocol error) prevents response
- Stale or lagging data may result in signals that do not reflect the most recent real-world filings

## How this service works

Returns the Disruption Intelligence Ripple Report: a ranked brief with headline, top regions, recommended actions, and delivered signals on downstream business effects from workforce disruption

## Output

A JSON object containing a headline commercial signal, a why-it-matters summary, a compact commercial angle, signal inventory counts (gold, fresh, watchlist, matches), a list of delivered disruption signals with ripple path inventory and unlock endpoints, recommended actions, and navigational hints for deeper investigation.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string",
       "description": "Optional commercial angle, company, region, or industry search query"
      },
      "limit": {
       "type": "number",
       "description": "Maximum delivered signals to include (max 10, default 5)"
      },
      "scope": {
       "type": "string",
       "description": "all, gold, or watchlist"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "product": "disruption_intelligence_ripple_report",
  "readout": {
   "headline": "Commercial signal headline",
   "why_it_matters": "Why the buyer should care now.",
   "commercial_angle": "A compact commercial interpretation."
  },
  "inventory": {
   "gold": 0,
   "fresh": 0,
   "matches": 0,
   "watchlist": 0
  },
  "navigation": {
   "message": "Use q to focus the brief; use delivered_signals[].ripple_path_inventory.unlock_endpoint for deeper downstream impact paths.",
   "examples": [
    "/ripple/brief?q=Meta&limit=5",
    "/ripple/brief?q=logistics&scope=gold&limit=5"
   ]
  },
  "report_name": "Disruption Intelligence Ripple Report",
  "why_not_high": [
   "The brief is a ranked commercial readout, not proof that a buyer, vendor, or region will act.",
   "Coverage can lag real-world changes, filings, local updates, and follow-on commercial activity."
  ],
  "delivered_signals": [],
  "recommended_actions": [
   "Review exposed accounts, territories, or sales motion."
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/disruption-intelligence-ripple-brief-api-4c6e91da/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from disruption.forgemesh.io](https://www.zero.xyz/host/disruption.forgemesh.io/llms.txt)