Skip to main content
GET
Trader Metrics

Path Parameters

tradingPairId
string
default:893d2add-2f36-4ee7-b660-893d2add2f36
required

Response

OK

Current public long/short account positioning and active trader aggregates. Accounts are classified by net position across OPEN risk buckets. Account identifiers are never returned; position metrics are null when either side has fewer than five accounts. Responses may be reused from a per-pair cache for up to 30 seconds.

tradingPairId
string<uuid> | null

Trading pair UUID

quoteAssetSymbol
string | null

Quote asset symbol for this trading pair

Example:

"USDC"

asOf
integer<int64> | null

Snapshot calculation time in Unix milliseconds

Required range: x >= 0
Example:

1736742000000

positionMetricsSuppressed
boolean | null

True when either net-long or net-short side has fewer than five margin accounts; all position split fields are then null

longAccountCount
integer<int64> | null

Distinct margin accounts with positive net position across OPEN risk buckets; null when suppressed

shortAccountCount
integer<int64> | null

Distinct margin accounts with negative net position across OPEN risk buckets; null when suppressed

longAccountShare
string | null

Long account count divided by long plus short account counts, rounded to six decimal places; null when suppressed

shortAccountShare
string | null

Short account count divided by long plus short account counts, rounded to six decimal places; null when suppressed

accountRatio
string | null

Net-long account count divided by net-short account count, rounded to six decimal places; null when suppressed

activeTraderWindows
object[] | null

Active-trader counts grouped by rolling time window.