Get API public v1 live cohort bias history by coin

Changed on
get/api/public/v1/live/cohort-bias-history/{coin}

Request

Path parameters

coinstring required

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

Query parameters

hoursinteger

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

tierType'pnl' | 'pnl_recent' | 'size'

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).

tierstring

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.

tiersstring

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'rows' | 'layer'

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

unknown required

Changes

    • info

      added the new optional query request parameter format

    • info

      added the new optional query request parameter tiers

    • info

      added the new enum value pnl_recent to the query request parameter tierType

    • 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