# 4SEC CVD History — Crypto Cumulative Volume Delta History

> 4SEC CVD History — Crypto Cumulative Volume Delta History 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 historical cumulative volume delta (CVD) data for a crypto trading pair, aggregated across multiple DEXes, bucketed over time.

## Facts

- Endpoint: GET https://api.foursec.xyz/cvd/history/%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-cvd-history-crypto-cumulative-volume-delta-history-a8730775
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h9SiH5GJQ5c82Yt36MrKr

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-cvd-history-crypto-cumulative-volume-delta-history-a8730775
```

Example prompt: Pull the CVD history for ETH/USDC from 4SEC — I want to see how cumulative volume delta has moved across DEXes over the last 24 hours.

## When to prefer this

Choose this endpoint when you need historical cumulative volume delta data aggregated across multiple decentralized exchanges for a specific crypto trading pair. It is particularly valuable for order flow analysis, momentum detection, and understanding buy/sell pressure trends in DeFi markets. Prefer this over single-DEX data sources when cross-DEX aggregation is important for accuracy.

## Known failure modes

- Invalid or unsupported symbol returns an error or empty history array
- Payment failure via x402 protocol results in 402 Payment Required response
- Symbol format mismatch (e.g. wrong delimiter or casing) may return no data
- Request for a period with no available data returns empty history array
- Rate limiting or payment not processed causes request rejection

## How this service works

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

## Output

Returns a structured object containing the trading symbol, the requested time period, bucket size, a timestamp for the response, the number of data points, and an array of historical CVD records — each representing aggregated buy/sell volume delta across multiple DEXes for that time bucket.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "example": {
  "period": {
   "type": "string"
  },
  "symbol": {
   "type": "string"
  },
  "history": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "timestamp": {
   "type": "string",
   "format": "date-time"
  },
  "bucket_size": {
   "type": "string"
  },
  "data_points": {
   "type": "integer"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/4sec-cvd-history-crypto-cumulative-volume-delta-history-a8730775/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)