Skip to main content
GET
List API public v1 pulse cohorts recent by tier type by tier lifecycle stats

Authorizations

X-API-Key
string
header
required

Create an API key at https://developers.coinversa.ai/keys. REST limits are shared across keys by account; access uses the effective tier of the presented key.

Path Parameters

tierType
enum<string>
required
Available options:
pnl,
size
tier
string
required

Cohort tier slug. Accepts both vocabularies — new PnL slugs apex, sharps, grinders, scrapers, crowd, bleeders, trapped, blown_out and new size slugs heavyweights, cruiserweights, middleweights, welterweights, lightweights, featherweights, flyweights, strawweights are normalized to their legacy equivalents (money_printer, smart_money, grinder, humble_earner, exit_liquidity, semi_rekt, full_rekt, giga_rekt / leviathan, tidal_whale, whale, small_whale, apex_predator, dolphin, fish, shrimp). Responses continue to emit legacy slugs.

Query Parameters

minRecentSharpe
number<double>

Optional inclusive minimum stored annualized realized-PnL Sharpe over 30 completed UTC days (refreshed hourly). Finite values only, including zero and negatives. Undefined/unpopulated scores are excluded when set. Fees, funding and unrealized PnL are excluded; this is not equity-return Sharpe. Applied with minTotalSharpe using AND, before limits and aggregation.

minTotalSharpe
number<double>

Optional inclusive minimum stored annualized realized-PnL Sharpe from first available daily history through yesterday UTC (refreshed daily). Finite values only, including zero and negatives. Undefined/unpopulated scores are excluded when set. Uses the current wallet score, not a historical score. Applied with minRecentSharpe using AND; omitted thresholds do not filter.

limit
integer<int32>
default:50
Required range: 1 <= x <= 500
offset
integer<int32>
default:0
Required range: x >= 0

Response

object[] | null

OK

avgDurationMs
number<double>
required
biggestLoss
number<double>
required
biggestWin
number<double>
required
lifecycles
integer<int32>
required
liquidations
integer<int32>
required
losses
integer<int32>
required
totalFees
number<double>
required
totalPnl
number<double>
required
wallet
string
required
wins
integer<int32>
required
pnlTierRecent
string
sizeTierRecent
string