{"uid":"cap_h9SiH5GJQ5c82Yt36MrKr","slug":"4sec-cvd-history-crypto-cumulative-volume-delta-history-a8730775","name":"4SEC CVD History — Crypto Cumulative Volume Delta History","description":"Real-time multi-DEX aggregated crypto market data. Pay per request with USDC on Base via x402 protocol.","url":"https://api.foursec.xyz/cvd/history/%7Bsymbol%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"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"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mGnTsR4O7wlMTGFAPo4ys","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical cumulative volume delta (CVD) data for a crypto trading pair, aggregated across multiple DEXes, bucketed over time.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"DEX order flow trend analysis","prompt":"Get me the cumulative volume delta history for WBTC on 4SEC — I want to see the buying versus selling pressure across all DEXes over the past week, broken into hourly buckets."},{"title":"DeFi token momentum check","prompt":"Fetch the CVD history for ARB from 4SEC's multi-DEX data — I'm trying to see if there's been consistent buying pressure in the last 48 hours before I make a trade."},{"title":"Automated trading signal pipeline","prompt":"Every hour, grab the latest CVD history for SOL/USDC from 4SEC and tell me if the delta has been consistently positive or negative over the last 12 data points."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T11:28:13.264Z","isFirstParty":false}