Skip to main content
GET
Get API public v1 live cohort bias history by coin

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

coin
string
required

Market symbol, e.g. BTC or xyz:GOLD. Case and surrounding whitespace are normalized.

Query Parameters

hours
integer<int32>
default:168

Window in hours ending now (UTC), silently clamped to 1..2160.

tierType
enum<string>
default:pnl

Cohort axis: pnl (all-time PnL tiers), pnl_recent (same slugs over the last 30 days of PnL; snapshots since 2026-05-14) or size (lifetime volume).

Available options:
pnl,
pnl_recent,
size
tier
string

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.

tiers
string

Comma-separated list of 1 to 8 tier slugs (either vocabulary, whitespace tolerated), e.g. apex,crowd. Answers [{tier, history}] in the order given (duplicates removed) — one call for the chart's Apex vs Crowd sub-pane. Passing both tier and tiers is rejected with 422, as is an unknown slug.

format
enum<string>
default:rows

rows (default): the historical shapes (flat array with tier, grouped array otherwise). layer: the chart envelope {coin, tierType, tiers, windowStart, windowEnd, netBiasUnit, series, source, coverage} with netBias as a -1..1 ratio and provenance/coverage metadata; needs tiers or tier.

Available options:
rows,
layer

Response

OK