CVD History

GET /cvd/history/:symbol

Historical Cumulative Volume Delta bucketed by time period.

Cost: $0.03 USDC

Path Parameters

Param	Type	Description
symbol	string	Token symbol, uppercase (e.g. BTC, ETH)

Query Parameters

Param	Type	Default	Options
period	string	24h	1h, 4h, 24h, 7d

Bucket Sizes

Period	Bucket Size
1h	5 minutes
4h	15 minutes
24h	1 hour
7d	1 hour

Request Example

curl -H "x-payment: <proof>" \
  "https://api.foursec.xyz/cvd/history/BTC?period=24h"

Response

{
  "symbol": "BTC",
  "period": "24h",
  "bucket_size": "1h",
  "data_points": 24,
  "history": [
    {
      "timestamp": "2026-07-08T11:00:00.000Z",
      "cvd_delta": 8200000,
      "buy_volume": 145000000,
      "sell_volume": 136800000
    },
    {
      "timestamp": "2026-07-08T12:00:00.000Z",
      "cvd_delta": -3400000,
      "buy_volume": 98000000,
      "sell_volume": 101400000
    }
  ],
  "timestamp": "2026-07-09T10:30:00Z",
  "cached": false
}

Reading the History

• Positive cvd_delta in a bucket = net buying in that time window
• Negative cvd_delta = net selling
• Consecutive negative buckets during price rally = distribution signal

Data Retention

CVD history is retained for 7 days in rolling memory. Data accumulates from the moment the symbol is first requested.

Related Endpoints

• CVD Real-time — GET /cvd/:symbol
• Liquidation History — recent cascade events