# Disruption Intelligence Ripple API – Gold Brief

> Disruption Intelligence Ripple API – Gold Brief 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 intelligence brief derived from WARN filings, labor signals, and regional economic events, explaining downstream business ripple effects for a given company, region, or industry.

## Facts

- Endpoint: GET https://disruption.forgemesh.io/gold/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-api-gold-brief-f71659e1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Quqw3ZpTs5mBAJWdddLqz

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-api-gold-brief-f71659e1
```

Example prompt: Pull the Disruption Intelligence Ripple brief focused on logistics companies and give me the top 5 commercial signals — I want to know what downstream business effects are rippling from recent layoffs or regional economic events in that sector.

## When to prefer this

Choose this endpoint when you need a synthesized, ranked commercial intelligence brief about labor disruptions and their downstream business effects — especially for B2B sales, account management, or market intelligence use cases. Prefer this over raw WARN filing lookups when you need interpretation and commercial framing, not just raw data. Ideal when querying by company name, region, or industry sector and wanting a concise actionable readout rather than raw event records.

## Known failure modes

- No signals matched for the given query — returns empty delivered_signals array with inventory counts of zero
- Invalid scope parameter (not 'all', 'gold', or 'watchlist') may return an error or default behavior
- Limit exceeding max of 10 may be silently capped at 10
- Payment not fulfilled (402) if USDC payment on Base is not provided — request blocked
- Coverage lag: real-world events may not yet be reflected in filings or signals
- Stale data if WARN filings or labor signals have not been recently ingested

## How this service works

Deprecated alias of /ripple/brief — use the canonical endpoint. Returns the same Ripple Report payload.

## Output

A JSON object containing a ranked commercial readout with a headline, why-it-matters summary, and compact commercial angle; an inventory of gold/fresh/watchlist signals matched; a list of delivered disruption signals each with ripple path inventory and unlock endpoints for deeper analysis; recommended actions; and navigation hints for refining the query.

## 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."
  ],
  "legacy_product": "commercial_convergence_brief",
  "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-api-gold-brief-f71659e1/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)