v1

latestOpenAPI 3.0.02026-07-2471143147.5 KB
Stats

Get user volume leaderboard

Get top users ranked by volume category within a time range

get/v1/stats/user-volume/leaderboard

Query parameters

category'USER_VOLUME_CATEGORY_TRADED' | 'USER_VOLUME_CATEGORY_LIQUIDATION' | 'USER_VOLUME_CATEGORY_TOTAL_FEE'

Category to rank users by. Default: TRADED (regular trading volume)

Ranking category (TRADED, LIQUIDATION, TOTAL_FEE). Default: TRADED

  • USER_VOLUME_CATEGORY_TRADED: Rank by regular trading volume (default; includes TPSL fills, excludes liquidations)
  • USER_VOLUME_CATEGORY_LIQUIDATION: Rank by liquidation volume
  • USER_VOLUME_CATEGORY_TOTAL_FEE: Rank by total fees paid (maker + taker + liquidation fees)
windowstring

Time window (1h, 24h, 7d, 2w). Default: 24h

limitinteger

Maximum number of entries to return. Default: 10, Max: 100

Limit entries (default: 10, max: 100)

Response

A successful response.

category'USER_VOLUME_CATEGORY_TRADED' | 'USER_VOLUME_CATEGORY_LIQUIDATION' | 'USER_VOLUME_CATEGORY_TOTAL_FEE'
  • USER_VOLUME_CATEGORY_TRADED: Rank by regular trading volume (default; includes TPSL fills, excludes liquidations)
  • USER_VOLUME_CATEGORY_LIQUIDATION: Rank by liquidation volume
  • USER_VOLUME_CATEGORY_TOTAL_FEE: Rank by total fees paid (maker + taker + liquidation fees)
windowstring
start_timestring int64
end_timestring int64