Prediction Market

Polymarket Volume Split (YES/NO)

Volume split by YES/NO outcome sides per interval (hour/day/week), plus total volume and trade count. Use this to see directional volume bias. For aggregate volume without YES/NO breakdown, use volumes instead.

Data refresh: ~30 minutes

get/gateway/v1/prediction-market/polymarket/volume-split/{condition_id}

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Path parameters

condition_idstring required

Polymarket condition ID

Example:0x6fefc0438c7598b23531457c8c60541990d0786bd4bd9dfc3eabc8d95c291092

Query parameters

granularity'hour' | 'day' | 'week'

Time granularity for volume aggregation

start_timeinteger

Start time (Unix seconds). 0 means no lower bound. Cache aligns to 5-minute buckets, so two requests within the same bucket return the same cached result.

end_timeinteger

End time (Unix seconds). 0 means current time. Cache aligns to 5-minute buckets, so two requests within the same bucket return the same cached result.

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

condition_idstring required
end_timeinteger required
granularitystring required
start_timeinteger required

Example response

{
  "$schema": "https://example.com/schemas/V2VolumeChartResponse.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.