# 4SEC Cumulative Volume Delta (CVD) Crypto Market Data API

> 4SEC Cumulative Volume Delta (CVD) Crypto Market Data API is a paid API for AI agents from api.foursec.xyz, paid per call via x402, $0.02/call, status down (last checked 2026-09-15).

Returns real-time cumulative volume delta (CVD) and buy/sell volume data for a given crypto token symbol aggregated across multiple DEXes

## Facts

- Endpoint: GET https://api.foursec.xyz/cvd/%7Bsymbol%7D
- Price: $0.02/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/4sec-cumulative-volume-delta-cvd-crypto-market-data-api-981d0d59
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MXGa3SKAhyGpO6tvCc_vT

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 4sec-cumulative-volume-delta-cvd-crypto-market-data-api-981d0d59
```

Example prompt: What's the current cumulative volume delta and buy/sell signal for ETH right now across DEXes?

## When to prefer this

Choose this endpoint when you need real-time on-chain CVD data aggregated across multiple DEXes for a specific crypto token, especially for trading signal generation, order flow analysis, or DeFi market monitoring. It is particularly useful when you need buy/sell volume pressure metrics rather than simple price data, and when pay-per-request billing via USDC on Base (x402) is acceptable.

## Known failure modes

- Unknown or unsupported token symbol returns an error or empty result
- Payment failure via x402 protocol results in 402 Payment Required response
- Network or DEX data feed outage may cause stale or missing data
- Malformed symbol input may return a 400 Bad Request
- Rate limiting or USDC balance exhaustion blocks subsequent calls

## How this service works

Real-time multi-DEX aggregated crypto market data. Pay per request with USDC on Base via x402 protocol.

## Output

A JSON object containing: the token symbol, a cumulative volume delta (CVD) value, a period CVD, buy volume, sell volume, a trading signal string (e.g. bullish/bearish), a timestamp, and the number of active WebSocket connections feeding the aggregation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "example": {
  "cvd": {
   "type": "number"
  },
  "signal": {
   "type": "string"
  },
  "symbol": {
   "type": "string"
  },
  "timestamp": {
   "type": "string",
   "format": "date-time"
  },
  "buy_volume": {
   "type": "number"
  },
  "period_cvd": {
   "type": "number"
  },
  "sell_volume": {
   "type": "number"
  },
  "active_ws_connections": {
   "type": "integer"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/4sec-cumulative-volume-delta-cvd-crypto-market-data-api-981d0d59/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.foursec.xyz](https://www.zero.xyz/host/api.foursec.xyz/llms.txt)