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

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.

since
string
default:1h
limit
integer<int32>
default:50
Required range: 1 <= x <= 500

Response

object[] | null

OK

address
string
required
coin
string
required
direction
string
required
fee
number<double>
required
pnl
number<double>
required
price
number<double>
required
rawTime
integer<int64>
required
side
string
required
size
number<double>
required
startPosition
number<double>
required
tid
integer<int64>
required
tradeTime
string
required
volume
number<double>
required
displayName
string