---
title: "Get Quant Positioning"
method: GET
path: "/api/v1/quant/positioning"
tags: ["Quant"]
---

# Get Quant Positioning

`GET /api/v1/quant/positioning`

## Request

- Base URL: `https://cryptodataapi.com`
- URL: `https://cryptodataapi.com/api/v1/quant/positioning`
- Auth: API key in header `X-API-Key`

Per-coin trader positioning by account type (Pro).

Aggregates the full HL account universe (every account >= $100k holding a
position; active accounts re-polled every liq-map cycle — 15 min on the
public path, 5 min once batch RPC is armed) into per-coin
long/short/net/gross notional split by
**trader type** — `market_maker`, `whale`, `other`, and `all` — using a
behavioral classifier (turnover, market breadth, leverage, PnL consistency).
The `market_maker` bucket is the basis for the dealer-gamma view at
`/quant/gex`. Each bucket also reports the distinct account count.

`by_type` is a partition (each account in exactly one class). `by_tag`
(`smart_money`, `high_leverage`; same shape) are orthogonal overlays — an
account can carry both tags or neither, in any class — so they are NOT a
breakdown of any `by_type` bucket. `positions_as_of` (unix ms) is the
liqmap poll cycle the positions come from (top level) and, per coin, the
newest poll time among that coin's contributing accounts.
`meta.classifier_version` is the tagging rule-set id (CalVer); a bump
there, not the market, may move accounts between classes.

`symbol` (alias `coin`) matches Hyperliquid names case-insensitively (`kPEPE`,
`kpepe`). An unrecognised query parameter is a 400.

## Query parameters

- `symbol` string, nullable: Filter to one coin (BTC) or a comma list (BTC,ETH,kPEPE)
- `coin` string, nullable: Alias for `symbol` (the Hyperliquid routes call it `coin`).

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cryptodataapi/apis/crypto-data-api.md) · [All operations](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/revisions/8628b754ca81?raw)