COcoinversa
Cohort intelligence

Compare trader cohort positioning

Changed on

Compare long and short positions across all-time PnL cohorts for one exact market. Long share by count is longCount / (longCount + shortCount); do not substitute notional bias. Zero denominator means no observed positions, not a neutral trading signal. Responses retain legacy cohort slugs (smart_money = Sharps, exit_liquidity = The Crowd). An empty array means no matching cohort rows, not an error. Suitable as structured agent context; include these definitions when interpreting the result.

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

Request

Path parameters

coinstring required

Exact indexed market symbol, e.g. BTC or xyz:GOLD. No matching rows returns an empty array.

Query parameters

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

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

Response

OK

biasLabelstring required

Qualitative label computed from netBiasByNotional; not an independent signal.

coinstring required

Exact market symbol queried.

longCountinteger required

Number of long positions in this cohort and market.

longNotionalnumber double required

Sum of long position notional, USD.

netBiasnumber double required

Compatibility alias of netBiasByNotional, not long-share percentage.

netBiasByCountnumber double required

(longCount - shortCount) / (longCount + shortCount), from -1 to +1; zero when denominator is zero. Long share is a different quantity.

netBiasByNotionalnumber double required

(longNotional - shortNotional) / (longNotional + shortNotional), from -1 to +1; zero when denominator is zero.

pnlTierstring required

All-time PnL cohort legacy slug; smart_money = Sharps, exit_liquidity = The Crowd.

shortCountinteger required

Number of short positions in this cohort and market.

shortNotionalnumber double required

Sum of short position notional, USD.

Changes

  • e668ee30bd24Revision changes
    • info

      added the new optional query request parameter minRecentSharpe

    • info

      added the new optional query request parameter minTotalSharpe

  • f2eba29805e5Revision changes
    • info

      api tag Cohort intelligence added

    • 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