# Volume history > On-chain volume per hour or per day, in your time zone (tz), plus a weekday × hour pattern over pattern_days. Source: https://docs.crius.sh/reference/chain/volume-history/ · Updated 2026-10-28 GET https://api.crius.sh/v1/{chain}/volume On-chain volume per hour or per day, in your time zone (`tz`), plus a weekday × hour pattern over `pattern_days`. > Organic DEX volume (wash round trips and mispriced outliers excluded, reported separately) for 1s, 30s, 1m, 5m, 1h, 6h, 24h, 7d, 30d, 90d, 180d with the previous window and change %; hourly and daily series; average volume by day of week and hour of day with the peak / quietest day and hour. ## Path parameters `chain`stringrequired Chain slug (`robinhood`) or chain id (`4663`). ## Query parameters `tz`string Default `UTC` IANA time zone for series and patterns, e.g. Asia/Dubai `hours`integer Default `48` Hourly series length (max 4320) `days`integer Default `30` Daily series length (max 365) `pattern_days`integer Default `90` Lookback for weekday / hour-of-day patterns (7..365) ## Guides that use this endpoint [**Build a Robinhood Chain stats dashboard**Build a Robinhood Chain analytics dashboard with the Crius API: DEX volume, trades, TVL, launches, gas and volume history in your time zone, with code.](https://docs.crius.sh/guides/build-a-chain-stats-dashboard/)[**Robinhood Chain API for analytics dashboards**Build Robinhood Chain dashboards with the Crius API: DEX volume without wash trades, TVL, launches per launchpad, hourly patterns and token charts.](https://docs.crius.sh/use-cases/analytics-dashboards/) ## Errors Errors come back as `{ "error": { "code", "message" } }` with the matching HTTP status: `400` bad parameter, `401` missing or invalid key, `403` endpoint above your plan, `404` unknown token or address, `429` rate limit or credits used up (with `Retry-After`). See [Errors](https://docs.crius.sh/errors/). ## More chain stats & status endpoints [GET/statsChain statsAnonymous · 1 cr](https://docs.crius.sh/reference/chain/chain-stats/)[GET/v1/statusService statusAnonymous · 0 cr](https://docs.crius.sh/reference/chain/service-status/)[GET/v1/chainsSupported chainsAnonymous · 0 cr](https://docs.crius.sh/reference/chain/supported-chains/) Request No key needed **cURL** ```bash curl "https://api.crius.sh/v1/robinhood/volume?days=3" \ -H "x-api-key: $CRIUS_API_KEY" ``` **JavaScript** ```js const res = await fetch("https://api.crius.sh/v1/robinhood/volume?days=3", { headers: { "x-api-key": process.env.CRIUS_API_KEY }, }); const { data, meta } = await res.json(); ``` **Python** ```python import os, requests r = requests.get( "https://api.crius.sh/v1/robinhood/volume?days=3", headers={"x-api-key": os.environ["CRIUS_API_KEY"]}, ) body = r.json() print(body["data"]) ``` Response 200 · captured Oct 28, 2026 ```json { "data": { "as_of_ts": 1793225074000, "by_hour": { "lookback_days": 90, "peak_hour": 14, "quietest_hour": 4, "rows": [ { "avg_trades": 171529, "avg_volume_usd": 37907414, "days_counted": 89, "hour": 0, "share_pct": 3.69344 }, { "avg_trades": 160908, "avg_volume_usd": 37815486, "days_counted": 89, "hour": 1, "share_pct": 3.68448 }, { "avg_trades": 154787, "avg_volume_usd": 36420348, "days_counted": 89, "hour": 2, "share_pct": 3.54855 } ] }, "by_weekday": { "lookback_days": 90, "peak_day": "wednesday", "quietest_day": "saturday", "rows": [ { "avg_trades": 4116146, "avg_volume_usd": 1013038326, "day": "monday", "days_counted": 13, "share_pct": 14.4174, "total_volume_usd": 13169498233 }, { "avg_trades": 4180257, "avg_volume_usd": 1002030520, "day": "tuesday", "days_counted": 13, "share_pct": 14.2607, "total_volume_usd": 13026396763 }, { "avg_trades": 4330613, "avg_volume_usd": 1440396094, "day": "wednesday", "days_counted": 12, "share_pct": 18.9226, "total_volume_usd": 17284753124 } ] }, "chain": "robinhood", "daily": { "busiest_day": { "ts": 1792972800000, "volume_usd": 556198238 }, "days": 3, "rows": [ { "buy_volume_usd": 247729766, "sell_volume_usd": 218992798, "trades": 1389513, "ts": 1792886400000, "volume_usd": 466722564, "wash_volume_usd": 50319274 }, { "buy_volume_usd": 286515806, "sell_volume_usd": 269682432, "trades": 1621146, "ts": 1792972800000, "volume_usd": 556198238, "wash_volume_usd": 50493821 }, { "buy_volume_usd": 237548924, "sell_volume_usd": 204145666, "trades": 1521812, "ts": 1793059200000, "volume_usd": 441694590, "wash_volume_usd": 50553407 } ] }, "hourly": { "busiest_hour": { "ts": 1793210400000, "volume_usd": 60323335 }, "hours": 48, "rows": [ { "buy_volume_usd": 6716118, "sell_volume_usd": 6323281, "trades": 53655, "ts": 1793052000000, "volume_usd": 13039399, "wash_volume_usd": 105689 }, { "buy_volume_usd": 9419407, "sell_volume_usd": 7621334, "trades": 59499, "ts": 1793055600000, "volume_usd": 17040740, "wash_volume_usd": 12295.4 }, { "buy_volume_usd": 8410243, "sell_volume_usd": 7053796, "trades": 60264, "ts": 1793059200000, "volume_usd": 15464040, "wash_volume_usd": 75408.9 } ] }, "method": { "caught_up": true, "data_since_ts": 1779484440000, "live": "windows up to 1h from the live trade flow (chain time); longer windows from complete minutes plus the live flow", "outliers": "excluded: single trades valued above $25000000 (mispriced quotes), counted in outlier_trades", "table_through_ts": 1793224500000, "volume": "organic DEX volume in USD at trade time (Uniswap V2/V3/V4, launchpad curves)", "wash": "excluded: same-tx round trips — buys and sells of one token in one pool inside one tx that cancel within 2%" }, "tz": "UTC", "windows": { "180d": { "buy_volume_usd": 54358559462, "buys": 253826654, "change_pct": null, "complete": false, "outlier_trades": 762, "prev_volume_usd": null, "sell_volume_usd": 52435524640, "sells": 204573895, "tokens": 1738934, "traders": 8246046, "traders_note": "unique traders / tokens: approximate (HyperLogLog), up to the last complete minute", "trades": 458400549, "volume_usd": 106794084102, "wash_trades": 1140815, "wash_volume_usd": 43228252019 }, "1h": { "buy_volume_usd": 13832591, "buys": 73433, "change_pct": -12.0881, "complete": true, "outlier_trades": 0, "prev_volume_usd": 31025009, "sell_volume_usd": 13442088, "sells": 75039, "tokens": 1747, "traders": 20684, "trades": 148472, "volume_usd": 27274679, "wash_trades": 27, "wash_volume_usd": 2621.56 }, "1m": { "buy_volume_usd": 437276, "buys": 2297, "change_pct": -6.49047, "complete": true, "outlier_trades": 0, "prev_volume_usd": 912411, "sell_volume_usd": 415915, "sells": 2293, "tokens": 181, "traders": 1326, "trades": 4590, "volume_usd": 853191, "wash_trades": 0, "wash_volume_usd": 0 }, "1s": { "buy_volume_usd": 3078.99, "buys": 36, "change_pct": -50.5284, "complete": true, "outlier_trades": 0, "prev_volume_usd": 22701.8, "sell_volume_usd": 8151.96, "sells": 52, "tokens": 21, "traders": 49, "trades": 88, "volume_usd": 11230.9, "wash_trades": 0, "wash_volume_usd": 0 }, "24h": { "buy_volume_usd": 286730820, "buys": 902381, "change_pct": 20.2008, "complete": true, "outlier_trades": 0, "prev_volume_usd": 445610023, "sell_volume_usd": 248895996, "sells": 868651, "tokens": 13008, "traders": 153221, "traders_note": "unique traders / tokens: approximate (HyperLogLog), up to the last complete minute", "trades": 1771032, "volume_usd": 535626816, "wash_trades": 17601, "wash_volume_usd": 100833980 }, "30d": { "buy_volume_usd": 12247569095, "buys": 34846699, "change_pct": -51.5393, "complete": true, "outlier_trades": 69, "prev_volume_usd": 48875200678, "sell_volume_usd": 11437699166, "sells": 31074225, "tokens": 291323, "traders": 2263899, "traders_note": "unique traders / tokens: approximate (HyperLogLog), up to the last complete minute", "trades": 65920924, "volume_usd": 23685268262, "wash_trades": 296158, "wash_volume_usd": 5483273594 }, "30s": { "buy_volume_usd": 185288, "buys": 1118, "change_pct": -25.6305, "complete": true, "outlier_trades": 0, "prev_volume_usd": 489301, "sell_volume_usd": 178603, "sells": 1202, "tokens": 124, "traders": 790, "trades": 2320, "volume_usd": 363891, "wash_trades": 0, "wash_volume_usd": 0 }, "5m": { "buy_volume_usd": 1526559, "buys": 7394, "change_pct": 45.1834, "complete": true, "outlier_trades": 0, "prev_volume_usd": 2700471, "sell_volume_usd": 2394075, "sells": 9124, "tokens": 464, "traders": 4438, "trades": 16518, "volume_usd": 3920634, "wash_trades": 0, "wash_volume_usd": 0 }, "6h": { "buy_volume_usd": 105598591, "buys": 321121, "change_pct": 52.3693, "complete": true, "outlier_trades": 0, "prev_volume_usd": 133649465, "sell_volume_usd": 98042204, "sells": 329945, "tokens": 5441, "traders": 63519, "traders_note": "unique traders / tokens: approximate (HyperLogLog), up to the last complete minute", "trades": 651066, "volume_usd": 203640796, "wash_trades": 541, "wash_volume_usd": 359759 }, "7d": { "buy_volume_usd": 1909691103, "buys": 5753033, "change_pct": -31.3766, "complete": true, "outlier_trades": 0, "prev_volume_usd": 5322350520, "sell_volume_usd": 1742687772, "sells": 5560924, "tokens": 58647, "traders": 500833, "traders_note": "unique traders / tokens: approximate (HyperLogLog), up to the last complete minute", "trades": 11313957, "volume_usd": 3652378875, "wash_trades": 66125, "wash_volume_usd": 453119545 }, "90d": { "buy_volume_usd": 46760389080, "buys": 208523175, "change_pct": null, "complete": true, "outlier_trades": 343, "prev_volume_usd": null, "sell_volume_usd": 45143857321, "sells": 166892984, "tokens": 1441104, "traders": 7052878, "traders_note": "unique traders / tokens: approximate (HyperLogLog), up to the last complete minute", "trades": 375416159, "volume_usd": 91904246401, "wash_trades": 953623, "wash_volume_usd": 41341982607 } } }, "meta": { "block": 100406767, "block_age_ms": 1146, "block_ts": 1793225074000, "chain": "robinhood", "finalized_block": 100397649, "lag_ms": 3, "safe_block": 100401329 } } ``` [Report an issue](mailto:support@crius.sh?subject=Docs%20issue%3A%20GET%20%2Fv1%2F%7Bchain%7D%2Fvolume&body=Page%3A%20https%3A%2F%2Fdocs.crius.sh%2Freference%2Fchain%2Fvolume-history%2F%0A%0AWhat's%20wrong%20or%20missing%3F%0A%0A)