> ## 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. # Active traders by account size, lifetime volume or size migration > For one finalized UTC period, a week (Monday to Monday) or a calendar month, ended at least 7 days ago so late data has settled; default: the latest finalized one, up to 52 weeks / 12 months back, the wallets that traded perps in the period (vaults and protocol accounts excluded), grouped by `view`: `size` = account size at the close of the period's last day (micro < $10K, small < $100K, medium < $1M, large < $10M, whale $10M+, unknown without a snapshot) with their total account value; `volume` = CURRENT lifetime traded volume as of the request (low < $1M, medium < $10M, high < $100M, very_high < $1B, extreme $1B+, unknown without stats) with the total lifetime volume; `migration` = account-size tier at the close of the day before the period (`from_tier`) → at the close of its last day (`tier`), among the period's active traders, wallet counts only. A period's first released answer is kept (served again unchanged). Each row carries its `tier`'s band (min_usd, max_usd: account value for size / migration, lifetime volume for volume). These are not the cohorts of GET /v1/network/trader-profitability, which share some names (its small is < $10K, its whale $1M–5M). Pricing: flat. Scope: `analytics:read`. ## OpenAPI ````yaml /data-api/openapi.json get /v1/network/trader-distribution 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/network/trader-distribution: get: tags: - Network summary: Active traders by account size, lifetime volume or size migration description: >- For one finalized UTC period, a week (Monday to Monday) or a calendar month, ended at least 7 days ago so late data has settled; default: the latest finalized one, up to 52 weeks / 12 months back, the wallets that traded perps in the period (vaults and protocol accounts excluded), grouped by `view`: `size` = account size at the close of the period's last day (micro < $10K, small < $100K, medium < $1M, large < $10M, whale $10M+, unknown without a snapshot) with their total account value; `volume` = CURRENT lifetime traded volume as of the request (low < $1M, medium < $10M, high < $100M, very_high < $1B, extreme $1B+, unknown without stats) with the total lifetime volume; `migration` = account-size tier at the close of the day before the period (`from_tier`) → at the close of its last day (`tier`), among the period's active traders, wallet counts only. A period's first released answer is kept (served again unchanged). Each row carries its `tier`'s band (min_usd, max_usd: account value for size / migration, lifetime volume for volume). These are not the cohorts of GET /v1/network/trader-profitability, which share some names (its small is < $10K, its whale $1M–5M). Pricing: flat. Scope: `analytics:read`. operationId: getTraderDistribution parameters: - name: view in: query required: false description: Grouping. schema: type: string default: size enum: - size - volume - migration - name: period in: query required: false description: Window. schema: type: string default: week enum: - week - month - name: start in: query required: false description: >- First day of the period, YYYY-MM-DD (UTC): a Monday for weeks, the 1st for months. Default: the latest finalized period. schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ - 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: tier: type: string description: >- Tier (size / volume; migration: tier at the period's close) min_usd: type: - string - 'null' description: >- Band lower bound, inclusive (USD; null: open) (decimal string; may carry extra trailing zeros) max_usd: type: - string - 'null' description: >- Band upper bound, exclusive (USD; null: open) (decimal string; may carry extra trailing zeros) from_tier: type: - string - 'null' description: 'Migration only: tier before the period' wallets: type: integer description: Wallets total: type: - string - 'null' description: >- size: total account value at the close; volume: total lifetime volume (USD); null for migration (decimal string; may carry extra trailing zeros) period_start: type: integer description: Period start, epoch ms period_end: type: integer description: Period end (exclusive), epoch ms 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/network/trader-distribution?view=migration&period=month' 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.