VWAP

Use client.vwap() when you need volume-weighted average price data for execution benchmarking and price smoothing. This method calculates VWAP over fixed time intervals.

Method signature

vwap(source, market, from_, to, interval, limit=1000)

Parameters

Parameter	Type	Required	Notes
source	str	Yes	Source ID
market	str	Yes	Normalized market or instrument ID
from_	str/datetime/date/int	Yes	Inclusive start time (ISO 8601, datetime, date, or epoch milliseconds)
to	str/datetime/date/int	Yes	Exclusive end time (same formats as from_)
interval	str	Yes	Duration token such as `1m`, `5m`, `1h`
limit	int	No	Page size (default: 1000)

Return value

List of bucketed VWAP series rows.

Example response

[
    {
        'timestamp': 1704067200000,
        'source': 'hyperliquid',
        'market': 'BTC',
        'symbol': 'BTCUSD',
        'vwap': 43252.35,
        'volume': 125.5,
        'interval': '1m'
    }
]

Fields

VWAP records include:

timestamp: bucket start time in UTC milliseconds since the Unix epoch
source: source identifier
market: normalized market ID
symbol: venue-native, human-friendly symbol
vwap: volume-weighted average price for the interval
volume: total traded base volume for the interval
interval: duration token such as 1m, 5m, or 1h

VWAP is calculated as the sum of (price × quantity) divided by total quantity for all trades in the interval.

Example

from datetime import datetime, timedelta, timezone
from polaris_data import PolarisClient

end = datetime.now(timezone.utc)
start = end - timedelta(hours=6)

with PolarisClient() as client:
    vwap_data = client.vwap(
        source="hyperliquid",
        market="SPX",
        from_=start,
        to=end,
        interval="5m",
    )

print(vwap_data[:2])

How it works

client.vwap() calculates VWAP from standardized trade data using snapshot-first replay. See Snapshots for the full flow.

OHLCV if you need price data alongside volume
Volume if you only need volume profiles
Trades if you need execution-level data
Quickstart

Foundation

Trade & Price Data

Orderbook & Liquidity

Derivatives Data

Method signature

Parameters

Return value

Example response

Fields

Example

How it works

​Method signature

​Parameters

​Return value

​Example response

​Fields

​Example

​How it works

​Related documentation

Method signature

Parameters

Return value

Example response

Fields

Example

How it works

Related documentation