> ## Documentation Index > Fetch the complete documentation index at: https://docs.bravadotrade.com/llms.txt > Use this file to discover all available pages before exploring further. # Volume charts > Hourly, daily or weekly traded volume for one Polymarket wallet or one market. Predexon-compatible names, with the volume basis, exchange scope and effective bucket range stated in every response. > [!NOTE] > > Sign each request with a fresh HMAC signature. The cURL and HTTP header values below are placeholders, not reusable credentials. For runnable signing code, use [request signing examples](https://docs.bravadotrade.com/authentication-examples.md). Two charts share one parameter set: a **wallet's** volume and a **market's** volume, bucketed by hour, day or week. Both routes take your **Data API** credential (`analytics.read`). Each successful response costs **1 API credit**. * **Venue: Polymarket only.** There is no `venue` parameter. * **Exchange scope: CTF Exchange V1 and V2** (`exchange_scope: "ctf_v1_v2"`). ExchangeV3 (combo) fills are not included yet. * **The two charts measure different things.** Read `volume_basis` before you compare them. See [Volume basis](#volume-basis). * **Predexon-compatible names.** `data[]` with `timestamp`, `total_volume`, `buy_volume` / `sell_volume` (wallet), `yes_volume` / `no_volume` (market) and `trades_count`, plus the echoed `granularity`, `start_time` and `end_time`. The other fields are additions. ### Shared parameters | Parameter | Rule | | - | - | | `granularity` | `hour` (default), `day` or `week`. Buckets are whole UTC hours, days, or weeks starting Monday. | | `start_time` | **Required.** Range start in unix **seconds**. It is floored to a bucket boundary. | | `end_time` | **Required.** Range end in unix **seconds**. It is ceiled to a bucket boundary. Must be after `start_time`. | The range is capped per granularity: **hour 90 days, day 366 days, week 1096 days**. A wider range is refused with `400`. It is never truncated. Empty buckets are returned as zeros, and the newest bucket can be partial. The response echoes the times you requested in `start_time` / `end_time`, and the bucket range actually served in `bucket_start_time` / `bucket_end_time`. Unknown query parameters, and parameters given twice, are refused with `400`. They are never ignored. ## `GET /v2/polymarket/wallet/volume-chart/{wallet}` ```text theme={null} GET https://partner-api.bravadotrade.com/v2/polymarket/wallet/volume-chart/{wallet}?granularity=day&start_time=1793404800&end_time=1794009600 ``` **wallet** `string` *required* Wallet address: `0x` followed by 40 hex characters. **granularity** `string` (default: hour) `hour`, `day` or `week`. **start\_time** `integer` *required* Range start, unix seconds. **end\_time** `integer` *required* Range end, unix seconds. **wallet\_address** `string` *required* The wallet (lowercase `0x`). **granularity** `string` *required* The bucket width applied. **start\_time · end\_time** `integer` *required* The times you requested, echoed. **bucket\_start\_time · bucket\_end\_time** `integer` *required* The whole-bucket range actually served (start floored, end ceiled). **data** `array` *required* One point per bucket, oldest first: `timestamp` (bucket start), `total_volume`, `buy_volume`, `sell_volume`, `trades_count`. **venue** `string` *required* Always `polymarket`. **exchange\_scope** `string` *required* Always `ctf_v1_v2`. **volume\_basis** `string` *required* Always `wallet_clob_fills`. See [Volume basis](#volume-basis). **trades\_count\_basis** `string` *required* Always `on_chain_fact_rows`: `trades_count` counts every on-chain event row of the wallet, including split, merge, convert and redeem rows that are not volume. It can exceed the wallet's number of CLOB fills. **buy\_sell\_split\_source** `string` *required* Always `unavailable`: `buy_volume` and `sell_volume` are `null` in every point. The volume is real. Only the buy/sell split is not served yet. Do not read `null` as zero buying or selling. **source** `string` *required* The rollup that was read: `pm_wallet_hourly` for `hour`, `pm_wallet_daily` for `day` and `week`. ## `GET /v2/polymarket/volume-chart/{condition_id}` ```text theme={null} GET https://partner-api.bravadotrade.com/v2/polymarket/volume-chart/{condition_id}?granularity=hour&start_time=1794096000&end_time=1794182400 ``` **condition\_id** `string` *required* The market's CTF condition id: `0x` followed by 64 hex characters. **granularity** `string` (default: hour) `hour`, `day` or `week`. **start\_time** `integer` *required* Range start, unix seconds. **end\_time** `integer` *required* Range end, unix seconds. **condition\_id** `string` *required* The requested condition id. **market\_id** `string` *required* The Polymarket market id, or `null` if it is not known. **granularity** `string` *required* The bucket width applied. **start\_time · end\_time** `integer` *required* The times you requested, echoed. **bucket\_start\_time · bucket\_end\_time** `integer` *required* The whole-bucket range actually served. **data** `array` *required* One point per bucket, oldest first: `timestamp`, `total_volume`, `yes_volume` (outcome 0), `no_volume` (outcome 1), `trades_count`. `total_volume = yes_volume + no_volume`. **venue** `string` *required* Always `polymarket`. **exchange\_scope** `string` *required* Always `ctf_v1_v2`. **volume\_basis** `string` *required* Always `all_fill_legs`. See [Volume basis](#volume-basis). ## Volume basis `volume_basis` tells you what `total_volume` sums. The two charts use different bases. | `volume_basis` | Chart | What it sums | Matches | | - | - | - | - | | `wallet_clob_fills` | Wallet | The wallet's on-chain CLOB fills, in USD. Split, merge, convert and redeem legs are not volume. Neither are legacy FPMM fills. | The wallet's `volume` on the [leaderboard](https://docs.bravadotrade.com/api/polymarket/leaderboard.md) for the same whole buckets. | | `all_fill_legs` | Market | Every `OrderFilled` leg of the market's outcome tokens: the taker order's row **and** each maker order's row. | About **2× the matched volume**, because each match is counted once per side. Divide by about 2 for an estimate of matched volume. Do not compare it 1:1 with a venue's "volume" figure. | In both charts `trades_count` counts rows, not matches. For the market chart it is the number of fill legs. ## Errors | Status | Code | Meaning | | - | - | - | | `400` | `unknown_param` | A query parameter these routes do not accept. | | `400` | `invalid_param` | A malformed `wallet`, `condition_id`, `granularity`, `start_time` or `end_time`, a missing `start_time` or `end_time`, or a repeated parameter. | | `400` | `BAD_REQUEST` | Refused by the analytics service: `end_time` not after `start_time`, or a range over the cap for the granularity. | | `404` | `NOT_FOUND` | Market chart: the condition id is not a known Polymarket market. | | `401` / `403` / `402` / `429` | | Signature, scope, credit allowance, rate limit. | | `503` | `UNAVAILABLE` | The analytics source is unavailable. Retry. | Two layers answer a `400`, and their envelopes differ. The API edge sends `{"error": "", "code": "unknown_param" | "invalid_param", "param": ""}`. The analytics service sends `{"error": "BAD_REQUEST" | "NOT_FOUND" | "UNAVAILABLE", "message": ""}`. Read the typed code from `code` when it is present, otherwise from `error`. ## Related * [Top holders](https://docs.bravadotrade.com/api/polymarket/top-holders.md): who holds the market. * [Wallet profile](https://docs.bravadotrade.com/api/polymarket/wallet.md): a wallet's volume and PnL per window. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.