Cumulative stats across all builders

{ "block": 1, "ts": 1, "volume_usd": 123, "buy_volume_usd": 123, "sell_volume_usd": 123, "unique_traders": 1, "unique_makers": 1, "unique_takers": 1, "txn_count": 1, "buy_count": 1, "sell_count": 1, "fees_usd": 123, "builder_fees": 123, "shares_volume": 123, "yes_volume_usd": 123, "no_volume_usd": 123, "yes_count": 1, "no_count": 1, "buy_dist_under_10": 1, "buy_dist_10_100": 1, "buy_dist_100_1k": 1, "buy_dist_1k_10k": 1, "buy_dist_10k_50k": 1, "buy_dist_50k_plus": 1, "distinct_builders": 1, "new_users": 1, "avg_rev_per_user": 123, "avg_vol_per_user": 123 }

Query Parameters

timeframe

enum<string>

Window: lifetime, 1d, 24h, 7d, 30d, 1mo. Default: lifetime. Time window for cumulative builder stats.

Available options:

lifetime,

1d,

7d,

30d

Response

200 - application/json

Global builder snapshot

Cumulative stats across all builders.

block

integer<int64>

required

Latest block number for the metric snapshot.

Required range: x >= 0

integer<int32>

required

Unix timestamp in seconds.

Required range: x >= 0

volume_usd

number<double>

required

Volume in USD.

buy_volume_usd

number<double>

required

Buy volume in USD.

sell_volume_usd

number<double>

required

Sell volume in USD.

unique_traders

integer<int64>

required

Unique traders.

Required range: x >= 0

unique_makers

integer<int64>

required

Unique makers.

Required range: x >= 0

unique_takers

integer<int64>

required

Unique takers.

Required range: x >= 0

txn_count

integer<int64>

required

Transaction count.

Required range: x >= 0

buy_count

integer<int64>

required

Buy count.

Required range: x >= 0

sell_count

integer<int64>

required

Sell count.

Required range: x >= 0

fees_usd

number<double>

required

Fees in USD.

builder_fees

number<double>

required

Builder fees.

shares_volume

number<double>

required

Shares volume.

yes_volume_usd

number<double>

required

Yes volume in USD.

no_volume_usd

number<double>

required

No volume in USD.

yes_count

integer<int64>

required

Yes count.

Required range: x >= 0

no_count

integer<int64>

required

No count.

Required range: x >= 0

buy_dist_under_10

integer<int64>

required

Buy trade count in the under-10 USD bucket.

Required range: x >= 0

buy_dist_10_100

integer<int64>

required

Buy trade count in the 10-100 USD bucket.

Required range: x >= 0

buy_dist_100_1k

integer<int64>

required

Buy trade count in the 100-1k USD bucket.

Required range: x >= 0

buy_dist_1k_10k

integer<int64>

required

Buy trade count in the 1k-10k USD bucket.

Required range: x >= 0

buy_dist_10k_50k

integer<int64>

required

Buy trade count in the 10k-50k USD bucket.

Required range: x >= 0

buy_dist_50k_plus

integer<int64>

required

Buy trade count in the 50k-plus USD bucket.

Required range: x >= 0

distinct_builders

integer<int64>

required

Distinct builder codes ever observed.

Required range: x >= 0

new_users

integer<int64>

required

Onboarding metric — traders whose first ever builder-attributed trade occurred within the chosen window. Each trader contributes at most once globally.

Required range: x >= 0

avg_rev_per_user

number<double>

required

Average revenue per user — builder_fees / unique_traders.

avg_vol_per_user

number<double>

required

Average volume per user — volume_usd / unique_traders.