Skip to main content
A cohort is a named group of wallets you track and analyze together. Cohorts are the lens for the rest of Datadash: point Smart Money or Signals at a cohort and every view is scoped to just those wallets.

Static and rule-based cohorts

A cohort’s members can be defined two ways:
  • Static: an explicit list of wallets you add by hand.
  • Rule-based: criteria that automatically match wallets and refresh over time. Rules combine portfolio properties and performance windows, for example:
    Users in Tennis category where totalPnl100,000  and  winRate70totalPnl \geq 100,000 \;and\; winRate \geq 70 % during Last Year
Rule-based cohorts re-evaluate on a schedule; each cohort shows when it was last refreshed. Cohorts are either Featured (curated and shared, such as “High Stakes Traders” or “Crypto Whales”) or Private (yours alone).

The cohort view

Every cohort opens on a set of headline stats, then a leaderboard of its wallets:

Traders

Number of wallets in the cohort.

Total PnL

Combined realized profit and loss across the cohort.

ROI

Return on investment for the selected window.

Total Volume

Total trading volume across the cohort.
The leaderboard ranks each wallet by PnL, ROI, win rate, positions, profit factor, volume and hold time, over a selectable window (1D, 1W, 1M, 1Y, or all time). Additional tabs break the same cohort down by Portfolio (open and closed positions), Activity (the trade log), Category (performance per tag), and Signals (the cohort’s highest-conviction bets).

Cohort IDs

A cohort ID is a TSID — 13 characters of Crockford base32 (I, L, O and U are excluded):
For example 0J9XQ4M7B2K5T. IDs are time-sortable, so ordering by ID orders by creation.

API endpoints

Cohort analytics are served by the profiles endpoints, scoped to the cohort’s wallets. The positions, activity and signals endpoints back the corresponding tabs.

User Profile

POST /api/v1/profiles/user: per-wallet PnL, win rate, volume, ROI, hold time and trade counts.

User Tag Profile

POST /api/v1/profiles/user-tag: the same performance broken down by category tag.