Skip to main content
GET
Protocol totals

Query Parameters

window
enum<string>
default:24h

Window: the last 24 hours, 7 days or 30 days before endTime, all time, or custom (startTime to endTime)

Available options:
24h,
7d,
30d,
all,
custom
Minimum string length: 1
startTime
integer<int64>

Custom window start as Unix milliseconds. Required with window=custom and rejected otherwise.

Required range: 0 <= x <= 4102444800000
endTime
integer<int64>

Window end as Unix milliseconds; defaults to now. Buckets starting at or before it count. A window counted in hours (2.5 days or shorter) must start within the last 90 days.

Required range: 0 <= x <= 4102444800000

Response

OK

window
object | null

The window these totals cover

volumeUsd
string | null

Taker volume in USD (USDC 1:1) routed by the builders the explorer displays. Trades of hidden builders are not counted.

Example:

"1250000.5"

spotVolumeUsd
string | null

The spot part of volumeUsd (displayed builders only)

Example:

"250000.5"

perpVolumeUsd
string | null

The perpetual (margin) part of volumeUsd (displayed builders only)

Example:

"1000000"

tradesCount
integer<int64> | null

Trades routed by the displayed builders

Required range: x >= 0
Example:

4210

protocolFeesUsd
string | null

Protocol taker fees in USD over every trade, all builders included. Excludes builder add-ons and maker fees.

Example:

"625.25"

activeTakers
integer<int64> | null

Distinct taker wallets that traded in the window (each wallet once however many buckets it traded in), all builders included

Required range: x >= 0
Example:

312

newTraders
integer<int64> | null

Wallets whose first trade on the protocol fell in the window, each counted once however many builders it traded through

Required range: x >= 0
Example:

27

tvlUsd
string | null

Total value locked in USD at the end of the window (the end of the bucket holding endTime): USDC custody (the opening custody plus deposits less initiated withdrawals), valued 1:1. Null when no custody had been folded by then.

Example:

"536172600"

openingTvlUsd
string | null

Total value locked in USD at the start of the window (the start of its first bucket). tvlUsd less openingTvlUsd is the window's change. Null when no custody had been folded by then.

Example:

"535000000"

depositsUsd
string | null

USDC deposited in the window, in USD (1:1). Other tokens are unvalued and not counted.

Example:

"1250000"

withdrawalsUsd
string | null

USDC withdrawals initiated in the window, in USD (1:1). Other tokens are unvalued and not counted.

Example:

"78000"

netFlowUsd
string | null

depositsUsd less withdrawalsUsd; negative when more left than arrived

Example:

"1172000"

activeAccounts
integer<int64> | null

Distinct wallets active in the window, each once: wallets that took a trade, received a deposit, or were paid out a withdrawal initiated in it (by payout address), all builders included

Required range: x >= 0
Example:

418

volumeBySource
object

A USD volume split by how it executed (RFQ-17): the order-book part and the RFQ part add back exactly to the volumeUsd beside it.

newAccounts
integer<int64> | null

Accounts registered in the window: every account with an application, whether or not it traded, all builders included (newTraders counts first trades instead). Every sign-up counts, in buckets without trades too; window=all starts where the analytics history does.

Required range: x >= 0
Example:

57