Skip to main content
GET
/
v1
/
polymarket
/
markets
/
{token_id}
/
volume
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/polymarket/markets/21742633.../volume?granularity=day"

{
  "token_id": "21742633143463906290569050155826241533067272736897614950488156847949938836455",
  "granularity": "day",
  "start_time": 1704067200,
  "end_time": 1706745600,
  "volume_over_time": [
    {
      "timestamp": 1704067200,
      "volume": 1250000.00
    },
    {
      "timestamp": 1704153600,
      "volume": 1450000.00
    },
    {
      "timestamp": 1704240000,
      "volume": 1680000.00
    },
    {
      "timestamp": 1704326400,
      "volume": 1920000.00
    }
  ]
}

​
Overview

Fetch historical time series of cumulative trading volume for a specific token. Useful for analyzing market activity trends over time.
​
token_id
string
required
The token ID for the market
​
granularity
string
default:"day"
Time granularity: day, week, month, year, or all
​
start_time
integer
Unix timestamp (seconds) for start of range
​
end_time
integer
Unix timestamp (seconds) for end of range
​
token_id
string
The requested token ID
​
granularity
string
The time granularity used
​
start_time
integer
Actual start time of returned data
​
end_time
integer
Actual end time of returned data
​
volume_over_time
array
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/polymarket/markets/21742633.../volume?granularity=day"

{
  "token_id": "21742633143463906290569050155826241533067272736897614950488156847949938836455",
  "granularity": "day",
  "start_time": 1704067200,
  "end_time": 1706745600,
  "volume_over_time": [
    {
      "timestamp": 1704067200,
      "volume": 1250000.00
    },
    {
      "timestamp": 1704153600,
      "volume": 1450000.00
    },
    {
      "timestamp": 1704240000,
      "volume": 1680000.00
    },
    {
      "timestamp": 1704326400,
      "volume": 1920000.00
    }
  ]
}

​
Granularity Options

GranularityDescriptionUse Case
dayDaily data pointsShort-term analysis
weekWeekly aggregationMedium-term trends
monthMonthly aggregationLong-term analysis
yearYearly aggregationMulti-year comparison
allSingle lifetime valueTotal market volume

Authorizations

​
x-api-key
string
header
required

API key for authentication. Get your free key at dashboard.predexon.com

Path Parameters

​
token_id
string
required

Token ID for the market

Query Parameters

​
granularity
enum<string>
default:day

Time granularity

Available options:
day,
week,
month,
year,
all
​
start_time
integer | null

Unix timestamp (seconds) for start

​
end_time
integer | null

Unix timestamp (seconds) for end

Response

Successful Response

Market volume time series endpoint response.

​
token_id
string
required
​
granularity
enum<string>
required

PnL granularity enum.

Available options:
day,
week,
month,
year,
all
​
start_time
integer
required
​
end_time
integer
required
​
volume_over_time
VolumeDataPoint · object[]
required