> ## Documentation Index > Fetch the complete documentation index at: https://docs.hyperdash.com/llms.txt > Use this file to discover all available pages before exploring further. # Hourly positioning by trader cohort > Per UTC hour and Hyperdash trader cohort, account-size cohorts (`size`: small, medium, large, whale, apex; before 2026-02-07 19:00 UTC: shrimp, fish, large_fish, dolphin, shark, whale, large_whale, kraken) and all-time-PnL cohorts (`pnl`: rekt, very_unprofitable, unprofitable, profitable, very_profitable, extremely_profitable; slightly_profitable / slightly_unprofitable until 2026-02-07), across all markets (omit `coin`) or in one market: long and short notional and, where recorded, the number of distinct wallets on each side. Notional from 2026-01-24; wallet counts from 2026-10-26 11:00 UTC (null before). Within an hour, counts and notional always come from the same sample (the hour's first). `limit` rows per page; window ≤ 30 days. hyperdash.com's Smart Money Bias = `cohort_type=pnl`, cohorts extremely_profitable + very_profitable. Pricing: base + per row. Scope: `analytics:read`. ## OpenAPI ````yaml /data-api/openapi.json get /v1/cohorts/positioning openapi: 3.1.0 info: title: Hyperdash Data API version: v1 description: >- Hyperliquid data from Hyperdash's own nodes. Every response reports the credits it cost. servers: - url: https://data.hyperdash.com security: [] tags: - name: Accounts - name: Async jobs - name: Builders - name: Cohorts - name: HIP-3 DEXs - name: Leaderboards - name: Lending - name: Liquidations - name: Markets - name: Network - name: Outcomes - name: Positions - name: Snapshots - name: Spot - name: Staking - name: Traders paths: /v1/cohorts/positioning: get: tags: - Cohorts summary: Hourly positioning by trader cohort description: >- Per UTC hour and Hyperdash trader cohort, account-size cohorts (`size`: small, medium, large, whale, apex; before 2026-02-07 19:00 UTC: shrimp, fish, large_fish, dolphin, shark, whale, large_whale, kraken) and all-time-PnL cohorts (`pnl`: rekt, very_unprofitable, unprofitable, profitable, very_profitable, extremely_profitable; slightly_profitable / slightly_unprofitable until 2026-02-07), across all markets (omit `coin`) or in one market: long and short notional and, where recorded, the number of distinct wallets on each side. Notional from 2026-01-24; wallet counts from 2026-10-26 11:00 UTC (null before). Within an hour, counts and notional always come from the same sample (the hour's first). `limit` rows per page; window ≤ 30 days. hyperdash.com's Smart Money Bias = `cohort_type=pnl`, cohorts extremely_profitable + very_profitable. Pricing: base + per row. Scope: `analytics:read`. operationId: getCohortPositioning parameters: - name: coin in: query required: false description: One market (omit for all markets combined). schema: type: string pattern: ^[A-Za-z0-9:_\-/@.]{1,40}$ - name: cohort_type in: query required: false description: Cohort family. schema: type: string default: all enum: - all - size - pnl - name: start_time in: query required: false description: 'Start, epoch ms. Default: end_time − 7 days; range ≤ 30 days.' schema: type: integer - name: end_time in: query required: false description: 'End, epoch ms. Default: now.' schema: type: integer - name: X-Max-Credits in: header required: false description: Refuse (free) if the request could cost more. schema: type: integer - name: X-Credit-Price-Version in: header required: false description: Expected price version; 409 price_changed if it differs. schema: type: integer responses: '200': description: OK headers: X-Credits-Charged: schema: type: integer X-Credit-Price-Version: schema: type: integer X-Request-Id: schema: type: string content: application/json: schema: type: object required: - data - has_more - next_cursor - meta properties: data: type: array items: type: object properties: t: type: integer description: Bar start, epoch ms coin: type: string description: Market, or `all` for all markets combined cohort_type: type: string description: size or pnl cohort: type: string description: Cohort id long_notional: type: string description: >- Long notional (USD) (decimal string; may carry extra trailing zeros) long_traders: type: - integer - 'null' description: Distinct wallets long (null before counts exist) short_notional: type: string description: >- Short notional (USD) (decimal string; may carry extra trailing zeros) short_traders: type: - integer - 'null' description: Distinct wallets short (null before counts exist) has_more: type: boolean next_cursor: type: - string - 'null' meta: type: object '400': description: Invalid parameter content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '401': description: Invalid, expired or revoked key content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '403': description: Scope, plan, history or credit limit content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '409': description: Price version changed content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '429': description: Rate limited (Retry-After) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '503': description: Backend at capacity (Retry-After) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' security: - bearer: [] x-codeSamples: - lang: curl source: >- curl -H 'Authorization: Bearer $HD_KEY' 'https://data.hyperdash.com/v1/cohorts/positioning?coin=BTC&cohort_type=size' components: schemas: Problem: type: object required: - type - title - status - code - request_id properties: type: type: string title: type: string status: type: integer code: type: string detail: type: string hint: type: string request_id: type: string securitySchemes: bearer: type: http scheme: bearer description: hdk_sk_live_v1_… or hdk_sk_test_v1_… ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.