# Onvexia Narrative Rotation

> Onvexia Narrative Rotation is a paid API for AI agents from onvexia.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-19).

Returns which crypto narratives are gaining or losing capital rotation over a configurable time window, across thousands of assets and ten chains.

## Facts

- Endpoint: GET https://onvexia.com/v1/narratives/rotation
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/onvexia-narrative-rotation-625bdfa4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0R8f1uMRJpL--pC-kjgik

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 onvexia-narrative-rotation-625bdfa4
```

Example prompt: Pull the Onvexia narrative rotation data for the last 30 days and tell me which crypto sectors are gaining the most capital inflow — include legacy narratives like Metaverse so I can see if anything old is making a comeback.

## When to prefer this

Choose this endpoint when you need a cross-asset, multi-chain view of which thematic narratives are rotating in or out of favor, backed by on-chain analytics and half a million analysed documents. Prefer it over generic price APIs when the question is about sector momentum or narrative cycles rather than individual asset prices. It is especially useful when you need provenance metadata alongside the signal.

## Known failure modes

- days parameter exceeds max of 90 — likely returns a 400 or clamped result
- Payment not attached or insufficient — 402 Payment Required response
- No rotation data in the requested window — returns empty data array (not an error)
- Invalid include_legacy value — may default or return validation error
- Service unavailable or rate limited — 429 or 503 response

## How this service works

Thousands of assets across ten chains, half a million analysed documents, labelled addresses and supply-age history reaching back to 2008 — fused into one reading per asset. REST, SQL, GraphQL and MCP.

## Output

A JSON object with a `data` array containing narrative rotation entries (narrative labels, rotation metrics, directionality) for the specified window, and a `meta` object describing coverage scope, endpoint provenance, and what data is not held. Empty data array means no rows in range, not that the metric is unsupported.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "days": {
       "type": "string",
       "description": "Window length, default 7, max 90"
      },
      "include_legacy": {
       "type": "string",
       "description": "true to include retired narratives (Metaverse)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "description": "The result — an array or object depending on the endpoint. An empty array means no rows in range, never that the metric is unsupported."
      },
      "meta": {
       "type": "object",
       "description": "Coverage and provenance: what was measured, and what is not held. A null label means no label is held, never that the subject is safe."
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [],
  "meta": {
   "docs": "https://onvexia.com/openapi.json",
   "endpoint": "/v1/narratives/rotation"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/onvexia-narrative-rotation-625bdfa4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from onvexia.com](https://www.zero.xyz/host/onvexia.com/llms.txt)