---
title: "Get Market Volume Time Series"
method: GET
path: "/v2/polymarket/markets/{token_id}/volume"
tags: ["polymarket"]
---

# Get Market Volume Time Series

`GET /v2/polymarket/markets/{token_id}/volume`

Return historical time series of traded volume for a token (day+ granularity).

## Path parameters

- `token_id` string, required — Token ID for the market

## Query parameters

- `granularity` 'day' | 'week' | 'month' | 'year' | 'all' — PnL granularity enum.
- `start_time` integer, nullable — Unix timestamp (seconds) for start
- `end_time` integer, nullable — Unix timestamp (seconds) for end

## Response `200`

Successful Response

- MarketVolumeTimeSeriesResponse — Market volume time series endpoint response.
  - `token_id` string, required
  - `granularity` 'day' | 'week' | 'month' | 'year' | 'all', required — PnL granularity enum.
  - `start_time` integer, required
  - `end_time` integer, required
  - `volume_over_time` VolumeDataPoint[], required
    - `timestamp` integer, required — Unix timestamp in seconds
    - `volume` number, required — Cumulative volume up to this point
    - `buy_volume` number, required — Cumulative buy volume up to this point
    - `sell_volume` number, required — Cumulative sell volume up to this point

## Other responses

- `400` — Bad Request
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.dev/predexon/apis/predexon-api.md) · [All operations](https://skmtc.dev/predexon/apis/predexon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/predexon/predexon-api/revisions/80a306fbdb39/schema)