# Cumulative Volume Delta (CVD) Divergence API

> Cumulative Volume Delta (CVD) Divergence API is a paid API for AI agents from nonvisceral-eloisa-mousily.ngrok-free.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns real-time taker buy vs sell volume divergence signals for BTC and ETH, detecting bullish accumulation and bearish exhaustion patterns from Hyperliquid DEX trade flow.

## Facts

- Endpoint: GET https://nonvisceral-eloisa-mousily.ngrok-free.dev/api/cvd
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nonvisceral-eloisa-mousily-ngrok-free-dev-a1c06fe7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Wy3ySMPEsyHWJAvU5Ehp2

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 nonvisceral-eloisa-mousily-ngrok-free-dev-a1c06fe7
```

Example prompt: Are BTC or ETH showing any CVD divergence right now — like price dropping while taker buy volume is actually rising, or price pumping but sellers dominating the flow on Hyperliquid?

## When to prefer this

Use this endpoint when you need real-time order flow divergence analysis specifically from Hyperliquid DEX trade data for BTC and ETH. Prefer this over generic price APIs when you want to detect smart money accumulation or distribution patterns using CVD methodology — especially for 1h and 4h timeframe signals. Distinct from funding rate or liquidation APIs on the same host; this focuses purely on taker buy/sell volume imbalance and its divergence from price action.

## Known failure modes

- Hyperliquid DEX data feed unavailable — stale or missing snapshot
- ngrok tunnel down — connection refused or 502/504
- Payment not processed (x402) — 402 Payment Required before data is served
- Rate limiting if too many calls without payment
- Empty divergence signals if insufficient recent trade data

## How this service works

Cumulative Volume Delta CVD API: real-time taker buy vs sell volume divergence for Bitcoin BTC and Ethereum ETH. Detects bullish accumulation (price down + CVD up) and bearish exhaustion (price up + CVD down). 1h and 4h divergence signals from Hyperliquid DEX trade flow.

## Output

Returns per-coin CVD divergence signals including signal type (bullish accumulation, bearish exhaustion, or neutral), strength score, 1h and 4h CVD and price change deltas, plus a latest snapshot with taker buy/sell volume, net CVD, trade count, and current price for both BTC and ETH. Includes an updated_at timestamp.

## 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": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "divergence": {
       "type": "object",
       "description": "Per-coin CVD divergence signals: signal type, strength, 1h/4h CVD and price change"
      },
      "updated_at": {
       "type": "string"
      },
      "latest_snapshot": {
       "type": "object",
       "description": "Current taker buy/sell volume, net CVD, trade count, and price per coin"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nonvisceral-eloisa-mousily-ngrok-free-dev-a1c06fe7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from nonvisceral-eloisa-mousily.ngrok-free.dev](https://www.zero.xyz/host/nonvisceral-eloisa-mousily.ngrok-free.dev/llms.txt)
