Skip to main content
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:
Add selected instrument series:
With explicit dates, 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_through is yesterday in UTC. The current UTC day has complete: false.
  • first_returned_date and last_returned_date describe days with archived trades; they are null for an entirely empty range. The days arrays still contain the requested zero-filled rectangle.
  • latest_trade_at is Unix seconds for the newest archived trade in the response, or null for an empty range.
  • When a requested window includes today, the whole request returns 503 if 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

x-api-key
string
header
required

Query Parameters

period
enum<string>
default:30d

Rolling UTC window. Do not combine with start_date or end_date.

Available options:
1d,
7d,
30d
start_date
string<date>

Inclusive UTC start date. Requires end_date; coverage begins 2026-07-08.

end_date
string<date>

Inclusive UTC end date. Requires start_date; the range can contain at most 30 days.

interval
enum<string>
default:day

Bucket interval. Only day is supported.

Available options:
day
instruments
string[]

Comma-separated instrument ids, full symbols, or bare assets. At most 20 values.

Maximum array length: 20

Response

Complete bounded platform and selected-instrument UTC-day series.

interval
enum<string>
required
Available options:
day
timezone
enum<string>
required
Available options:
UTC
period
enum<string>
required
Available options:
1d,
7d,
30d,
custom
start_date
string<date>
required
end_date
string<date>
required
coverage_start
enum<string>
required
Available options:
2026-07-08
complete_through
string<date>
required
first_returned_date
string<date> | null
required
last_returned_date
string<date> | null
required
latest_trade_at
integer<int64> | null
required

Newest archived trade timestamp in Unix seconds.

notional_unit
enum<string>
required
Available options:
pUSD
side_semantics
string
required
total
object
required
instruments
object[]
required
Maximum array length: 20