# Vedetta Narrative Detection

> Vedetta Narrative Detection is a paid API for AI agents from vedetta.dethboy.com, paid per call via x402, $0.09/call, status unknown (last checked 2026-09-14).

Returns the dominant narrative for a single crypto asset and whether that narrative rotated in the last 24 hours

## Facts

- Endpoint: GET https://vedetta.dethboy.com/v1/narrative
- Price: $0.09/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vedetta-narrative-detection-18d54a55
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gAl8FecfAlvNBQF423bA_

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 vedetta-narrative-detection-18d54a55
```

Example prompt: What's the dominant narrative for BTC right now on Vedetta, and has it rotated in the last 24 hours?

## When to prefer this

Use this endpoint when you need to detect whether the dominant market narrative for a specific crypto asset has shifted in the last 24 hours, enabling narrative-driven trade timing or position review. Prefer this over the sentiment or social endpoints when the core question is 'what story is driving this asset and has it changed?' rather than raw sentiment scores or price signals.

## Known failure modes

- Missing or invalid asset ticker returns a 400 or error response
- Unsupported asset symbols may return no narrative data or an empty result
- Stale cached data may not reflect the very latest narrative if cache has not refreshed
- Rate limiting or payment failure (x402) if USDC payment is not properly attached
- Network timeout if the upstream data source is temporarily unavailable

## How this service works

Dominant narrative on one crypto asset and whether it rotated in the last 24h (?asset=BTC) — narrative-change detection for trading agents. Descriptive research, not financial advice.

## Output

Returns the dominant narrative label or theme for the specified crypto asset (e.g. 'inflation hedge', 'risk-on', 'regulatory fear') and a boolean or signal indicating whether that narrative rotated within the last 24 hours, enabling trading agents to detect story-driven regime changes.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "asset"
     ],
     "properties": {
      "asset": {
       "type": "string",
       "description": "Ticker symbol, e.g. BTC, ETH, SOL, AI"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asset": {
       "type": "string"
      },
      "quality": {
       "type": "string"
      },
      "summary": {
       "type": "string"
      },
      "narrative": {
       "type": "string"
      },
      "disclaimer": {
       "type": "string"
      },
      "changed_24h": {
       "type": "boolean"
      },
      "previous_narrative": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asset": "BTC",
  "quality": "structured",
  "summary": "Narrative rotated from reserve momentum to the FOMC floor watch.",
  "narrative": "64K floor into FOMC",
  "disclaimer": "Descriptive market intelligence, not financial advice.",
  "changed_24h": true,
  "previous_narrative": "Strategic Reserve momentum"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vedetta-narrative-detection-18d54a55/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vedetta.dethboy.com](https://www.zero.xyz/host/vedetta.dethboy.com/llms.txt)