# Halowerk Narrative Velocity

> Halowerk Narrative Velocity is a paid API for AI agents from research.halowerk.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-13).

Computes topic coverage growth rate over a recent vs. baseline window and reports language and publishing-country spread to distinguish local events from globally spreading narratives.

## Facts

- Endpoint: POST https://research.halowerk.com/v1/narrative-velocity
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-narrative-velocity-1c32c435
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cYC1BLcr_J12RVfJXyRRj

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 halowerk-narrative-velocity-1c32c435 -d '<json body>'
```

Example prompt: Can you measure how fast coverage of 'bird flu outbreak' has grown in the last 7 days compared to the prior 30-day baseline, and tell me how many languages and countries the story is spreading across — I want to know if this is a local scare or a global news wave.

## When to prefer this

Choose this endpoint when you need to distinguish between a topic that is merely trending in one country vs. one that is genuinely spreading across global media landscapes. It is uniquely suited for detecting virality patterns, early-warning geopolitical signals, or narrative diffusion analysis where both velocity and geographic/linguistic spread matter. Prefer it over a simple news search when the dimension of interest is momentum and spread rather than content retrieval.

## Known failure modes

- Topic too obscure to have measurable baseline coverage, returning zero or null growth rate
- Time windows too short to capture meaningful signal
- Ambiguous topic keyword matching unrelated stories, inflating or deflating counts
- API returns error if required time window parameters are missing or malformed
- Rate limiting or payment failure for high-volume polling use cases

## How this service works

Computes the growth of coverage for a topic between a recent window and a baseline, and reports the spread across languages and publishing countries alongside it. The spread is the more informative half: a topic exploding in one language is a national event, one rising simultaneously across eight languages is something else entirely, and a growth rate alone cannot tell them apart.

## Output

Returns a growth rate quantifying how much coverage of the topic has expanded in the recent window relative to the baseline, plus a breakdown of the spread across languages and publishing countries — indicating whether the narrative is concentrated in one region or diffusing broadly across the global media ecosystem.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "topic": {
   "type": "string",
   "maxLength": 200,
   "minLength": 3
  },
  "window": {
   "type": "string",
   "default": "3d",
   "maxLength": 6
  },
  "baseline": {
   "type": "string",
   "default": "4w",
   "maxLength": 6
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-narrative-velocity-1c32c435/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from research.halowerk.com](https://www.zero.xyz/host/research.halowerk.com/llms.txt)