Skip to main content
GET
/
gateway
/
v1
/
prediction-market
/
polymarket
/
volumes
Polymarket Volume History
curl --request GET \
  --url https://api.ask.surf/gateway/v1/prediction-market/polymarket/volumes
{
  "data": [
    {
      "notional_volume_usd": 123,
      "timestamp": 123,
      "trade_count": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "limit": 123,
    "offset": 123,
    "total": 123
  },
  "$schema": "<string>"
}

Query Parameters

condition_id
string
required

Market condition identifier

Example:

"0x1234567890abcdef"

time_range
enum<string>
default:30d

Predefined time range

Available options:
7d,
30d,
90d,
180d,
1y
Example:

"30d"

interval
enum<string>
default:1d

Aggregation interval: 1h (hourly) or 1d (daily)

Available options:
1h,
1d
Example:

"1d"

Response

OK

data
object[] | null
required
meta
object
required
$schema
string<uri>

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DataResponsePolymarketVolumePoint.json"