Get API public v1 live cohort bias history by coin
Changed onRequest
- Base URLhttps://api.coinversa.ai
- AuthAPI key in header X-API-Key
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
Market symbol, e.g. BTC or xyz:GOLD. Case and surrounding whitespace are normalized.
Query parameters
Window in hours ending now (UTC), silently clamped to 1..2160.
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).
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.
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.
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.
Response
OK
Changes
- info
added the new optional
queryrequest parameterformat - info
added the new optional
queryrequest parametertiers - info
added the new enum value
pnl_recentto thequeryrequest parametertierType
- info
- info
added the non-success response with the status
- info
removed the non-success response with the status
- info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status
- info