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

# Cohort positioning of every market at one hour

> Every market's long and short notional per trader cohort (size and PnL families) at one UTC hour, the latest complete hour by default, with distinct wallets per side where recorded (from 2026-10-26 11:00 UTC).

Pricing: flat. Scope: `analytics:read`.



## OpenAPI

````yaml /data-api/openapi.json get /v1/cohorts/positioning/markets
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/markets:
    get:
      tags:
        - Cohorts
      summary: Cohort positioning of every market at one hour
      description: >-
        Every market's long and short notional per trader cohort (size and PnL
        families) at one UTC hour, the latest complete hour by default, with
        distinct wallets per side where recorded (from 2026-10-26 11:00 UTC).


        Pricing: flat. Scope: `analytics:read`.
      operationId: getCohortPositioningMarkets
      parameters:
        - name: time
          in: query
          required: false
          description: >-
            Hour (epoch ms, rounded down to the hour). Default: the latest
            complete hour.
          schema:
            type: integer
        - name: cohort_type
          in: query
          required: false
          description: Cohort family.
          schema:
            type: string
            default: all
            enum:
              - all
              - size
              - pnl
        - 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
                        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/markets?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.