---
title: "Compare trader cohort positioning"
method: GET
path: "/api/public/v1/live/cohort-bias/{coin}"
tags: ["Cohort intelligence"]
---

# Compare trader cohort positioning

`GET /api/public/v1/live/cohort-bias/{coin}`

## Request

- Base URL: `https://api.coinversa.ai`
- URL: `https://api.coinversa.ai/api/public/v1/live/cohort-bias/{coin}`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/coinversa/apis/coinversa-api/docs/api/public/v1/live/cohort-bias/:coin/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Path parameters

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

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

## Response `200`

OK

- CohortBiasBody[], nullable
  - `biasLabel` string, required: Qualitative label computed from netBiasByNotional; not an independent signal.
  - `coin` string, required: Exact market symbol queried.
  - `longCount` integer, required: Number of long positions in this cohort and market.
  - `longNotional` number, double, required: Sum of long position notional, USD.
  - `netBias` number, double, required: Compatibility alias of netBiasByNotional, not long-share percentage.
  - `netBiasByCount` number, double, required: (longCount - shortCount) / (longCount + shortCount), from -1 to +1; zero when denominator is zero. Long share is a different quantity.
  - `netBiasByNotional` number, double, required: (longNotional - shortNotional) / (longNotional + shortNotional), from -1 to +1; zero when denominator is zero.
  - `pnlTier` string, required: All-time PnL cohort legacy slug; smart_money = Sharps, exit_liquidity = The Crowd.
  - `shortCount` integer, required: Number of short positions in this cohort and market.
  - `shortNotional` number, double, required: Sum of short position notional, USD.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error
- `504`: Gateway Timeout

## Changes

- **2026-10-14** `e668ee30bd24`: 2 info
  - added the new optional `query` request parameter `minRecentSharpe`
  - added the new optional `query` request parameter `minTotalSharpe`
- **2026-09-23** `f2eba29805e5`: 8 info
  - api tag `Cohort intelligence` added
  - added the non-success response with the status `403`
  - removed the non-success response with the status `401`
  - added the optional property `reason` to the response with the `400` status
  - …4 more

[Operation history](https://skmtc.dev/coinversa/apis/coinversa-api/changes/api/public/v1/live/cohort-bias/:coin/get.md)

---

[API](https://skmtc.dev/coinversa/apis/coinversa-api.md) - [All operations](https://skmtc.dev/coinversa/apis/coinversa-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coinversa/apis/coinversa-api/revisions/3454317a5830?raw)