Get Hyperliquid cumulative volume delta
Get cumulative volume delta buckets for a Hyperliquid core symbol: taker buy and sell notional per bucket, their difference, and a running total. Intervals of 1h and longer roll up hourly totals; 1m, 5m, 15m and 30m are summed from taker fills. Live responses currently meter this route at 1 credit per request. Use start, end, and interval to bound the returned window.
Buckets: each bucket is labelled by its open time in UTC and is omitted when it holds no trades. 4h, 1d and 1w buckets open on UTC epoch boundaries, so 1w buckets open on Thursdays. Below 1h, a bucket is returned when it opens inside [start, end], and it always covers its full interval. From 1h up, each bucket sums the hours that open inside [start, end], so at 4h, 1d and 1w the first and last buckets of a window can be partial.
Pagination: a page holds up to limit buckets (default 500, max 10000). While more buckets may follow inside [start, end], meta.next_cursor is set: pass it back as cursor with start, end and interval unchanged, and stop when it is absent. Below 1h a page can hold fewer than limit buckets and still carry a cursor, so stop on the cursor, not on a short page. At the default limit, a window of up to 500 buckets is always one page. Without start or cursor, the response is the newest limit buckets of the 24 hours before end (or before now, when end is later), with no cursor.
Running total: cumulative_delta is a running total of delta from the first bucket of each response, so it restarts on every page. To join pages, rebuild it from delta. A response that is one page of several says so in meta.notice.
Request
- Base URL: https://api.0xarchive.io
- URL: https://api.0xarchive.io/v1/hyperliquid/cvd/{symbol}
- Auth: API key in header X-API-Key
Path parameters
Trading pair symbol (e.g., BTC, ETH)
Query parameters
Start timestamp in Unix milliseconds. When omitted, and no cursor is sent, the window is the 24 hours before end and the newest limit buckets of it are returned.
End timestamp in Unix milliseconds. Defaults to now.
Bucket width (default: 1h). Intervals of 1h and longer roll up hourly totals; 1m, 5m, 15m and 30m are summed from taker fills. Any other value returns 400.
Resume point: the previous page's meta.next_cursor, a Unix millisecond timestamp. Returns the buckets that open after it. Send it with the same start, end and interval.
Buckets per page (default: 500, max: 10000)
Response
CVD buckets
Example response
{
"success": true,
"data": [
{
"timestamp": 1781593200000,
"buy_volume": 30160211.46768,
"sell_volume": 32901130.02649,
"delta": -2740918.55881,
"cumulative_delta": -2740918.55881
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.