Skip to main content
Activity is the signed-in user (x-app-id and Authorization: Bearer). The leaderboard is the app (x-app-id only). Positions and orders are poll targets on Order lifecycle: GET /execution/positions and GET /execution/orders. The UI is Leaderboard. For a profile screen, add user avatars. For backend reporting across all users in your app, use Partner admin with a server API key.

Activity

type is trade, withdrawal, bridge, deposit, user_op, or redeem.
Full shape on Get user activity feed.

Leaderboard

metric is realizedPnl (default) or volume. rank is exact inside the top 100 and null after that. Pass exactly one of userId, externalId, username, or walletAddress to look up one user.
Full shape on Trader leaderboard.

One user’s P&L over time

GET /leaderboard/series returns one user’s daily orders, volume, spent, realizedPnl, and a running cumulativeRealizedPnl, oldest first. Pass exactly one of userId, externalId, username, or walletAddress. The default range is the last 30 days, and the maximum is 366. Days with no activity return 0. Unrealized P&L on open positions is not included.
Full shape on Trader leaderboard series.