Perps daily activity
Perps Market Data
Perps Daily Activity
Chart complete UTC-day perps notional and taker flow for the platform and selected instruments.
GET
Perps daily activity
GET /v3/perps/activity/daily returns one UTC-day row for the complete perps
trade archive, plus matching rows for any instruments you select. One request
can therefore power a platform-total chart and up to 20 instrument series.
Trade coverage begins on 2026-07-08. The current UTC day has
complete: false because more trades can still arrive.
Request
Query parameters
An explicit range can contain at most 30 days, including both endpoints. It
cannot begin before
2026-07-08 or end after the current UTC date.
Examples
Get the platform total for the last seven UTC days:period is returned as custom. Every requested day is
present even when its counts and decimal strings are zero.
Metric semantics
The platform
total deliberately has no base-quantity fields. BTC, ETH, gold,
and other base units are not additive, while pUSD notional is.
Completeness and freshness
complete_throughis yesterday in UTC. The current UTC day hascomplete: false.first_returned_dateandlast_returned_datedescribe days with archived trades; they arenullfor an entirely empty range. Thedaysarrays still contain the requested zero-filled rectangle.latest_trade_atis Unix seconds for the newest archived trade in the response, ornullfor an empty range.- When a requested window includes today, the whole request returns
503if the market trade archive tip is more than 15 minutes old. A stale current window is never presented as complete or as zero activity.
No-go interpretations
- Taker BUY/SELL is market-side direction, not maker direction and not a wallet-attributed action.
- The trade archive does not attribute these rows to wallets. Do not derive a trader leaderboard, wallet flow, or wallet P&L from this route.
- Notional is pUSD, not base quantity. Base quantities can be compared only within the same instrument.
- This route is trade activity, not open interest, funding, positions, or liquidations.
Errors
Retry a
503; do not render it as a zero-activity window.Authorizations
Query Parameters
Rolling UTC window. Do not combine with start_date or end_date.
Available options:
1d, 7d, 30d Inclusive UTC start date. Requires end_date; coverage begins 2026-07-08.
Inclusive UTC end date. Requires start_date; the range can contain at most 30 days.
Bucket interval. Only day is supported.
Available options:
day Comma-separated instrument ids, full symbols, or bare assets. At most 20 values.
Maximum array length:
20Response
Complete bounded platform and selected-instrument UTC-day series.
Available options:
day Available options:
UTC Available options:
1d, 7d, 30d, custom Available options:
2026-07-08 Newest archived trade timestamp in Unix seconds.
Available options:
pUSD Maximum array length:
20
