> ## 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. # Trader screener > Ranked traders with their stats: PnL per window, trade counts, win rates, Sharpe and Sortino, drawdowns, GPR, copy scores, account value, open notional, unrealized PnL, profile and top assets. The top 2,000 per sort and filter set, paged; like hyperdash.com's Explore, it leaves out the 13 accounts the site excludes (e.g. the Assistance Fund). Explore's filters as fixed choices: smallest account value, smallest PnL in the timeframe, smallest copy score and style tag (all optional, combined with AND). `rank` is the wallet's rank on the perp-PnL leaderboard of `timeframe` (Explore's # column; display only, it does not change the order). Explore's Win Rate column is `winrate_30d`; `winrate` is lifetime. Pricing: base + per row. Scope: `analytics:read`. ## OpenAPI ````yaml /data-api/openapi.json get /v1/traders/screener 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/traders/screener: get: tags: - Traders summary: Trader screener description: >- Ranked traders with their stats: PnL per window, trade counts, win rates, Sharpe and Sortino, drawdowns, GPR, copy scores, account value, open notional, unrealized PnL, profile and top assets. The top 2,000 per sort and filter set, paged; like hyperdash.com's Explore, it leaves out the 13 accounts the site excludes (e.g. the Assistance Fund). Explore's filters as fixed choices: smallest account value, smallest PnL in the timeframe, smallest copy score and style tag (all optional, combined with AND). `rank` is the wallet's rank on the perp-PnL leaderboard of `timeframe` (Explore's # column; display only, it does not change the order). Explore's Win Rate column is `winrate_30d`; `winrate` is lifetime. Pricing: base + per row. Scope: `analytics:read`. operationId: traderScreener parameters: - name: sort in: query required: false description: >- Sort field. Default pnlPerpMonth (30-day perp PnL), as hyperdash.com's Explore traders. schema: type: string default: pnlPerpMonth enum: - pnlPerpDay - pnlPerpWeek - pnlPerpMonth - pnlPerpAllTime - winrate30d - winrate7d - winrateLifetime - totalTrades - accountValue - notional - sharpe30d - copyScore - copyScoreV2 - maxDrawdownPerpWeek - maxDrawdownPerpMonth - name: order in: query required: false description: Sort order. schema: type: string default: desc enum: - desc - asc - name: timeframe in: query required: false description: >- Window of `rank` and of `min_pnl`. Default: the sort's window (pnlPerpDay 24h, pnlPerpWeek 7d, pnlPerpMonth 30d, so 30d for the default sort, pnlPerpAllTime alltime), else alltime. schema: type: string enum: - 24h - 7d - 30d - alltime - name: min_account_value in: query required: false description: >- Only traders with at least this account value (USD; Explore's equity filter). schema: type: string enum: - '1000' - '10000' - '100000' - '1000000' - '10000000' - name: min_pnl in: query required: false description: >- Only traders with at least this perp PnL (USD) in `timeframe`'s window (pnl_day, pnl_week, pnl_month or pnl_alltime); 0 = profitable. schema: type: string enum: - '0' - '10000' - '100000' - '1000000' - name: min_copy_score in: query required: false description: >- Only traders with at least this copy score (`copy_score_v2`, Explore's copy-score filter). schema: type: string enum: - '50' - '70' - '90' - name: tag in: query required: false description: Only traders with this style tag (Explore's trader-type filter). schema: type: string enum: - algo - scalp - intraday - swing - position - name: limit in: query required: false description: Rows (≤ 1000). schema: type: integer minimum: 1 maximum: 1000 default: 100 - name: cursor in: query required: false description: Opaque cursor from next_cursor. schema: type: string - 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: address: type: string description: Wallet rank: type: - integer - 'null' description: >- Rank on the perp-PnL leaderboard of `timeframe` (null: not ranked in that window) pnl_day: type: string description: >- Perp PnL, 24 h (decimal string; may carry extra trailing zeros) pnl_week: type: string description: >- Perp PnL, 7 d (decimal string; may carry extra trailing zeros) pnl_month: type: string description: >- Perp PnL, 30 d (decimal string; may carry extra trailing zeros) pnl_alltime: type: string description: >- Perp PnL, all time (decimal string; may carry extra trailing zeros) total_trades: type: integer description: Completed trades trades_7d: type: integer description: Trades, 7 d trades_30d: type: integer description: Trades, 30 d long_trades: type: integer description: Long trades short_trades: type: integer description: Short trades winning_trades: type: integer description: Winning trades losing_trades: type: integer description: Losing trades winrate: type: string description: >- Win rate, lifetime (all completed trades) (decimal string; may carry extra trailing zeros) winrate_7d: type: - string - 'null' description: >- Win rate, 7 d (decimal string; may carry extra trailing zeros) winrate_30d: type: - string - 'null' description: >- Win rate, 30 d (hyperdash.com Explore's Win Rate column) (decimal string; may carry extra trailing zeros) winrate_90d: type: - string - 'null' description: >- Win rate, 90 d (decimal string; may carry extra trailing zeros) last_trade_at: type: - integer - 'null' description: Last trade, epoch ms last_fill_at: type: - integer - 'null' description: Last fill, epoch ms account_value: type: - string - 'null' description: >- Account value (USD) (decimal string; may carry extra trailing zeros) notional: type: - string - 'null' description: >- Open notional (USD) (decimal string; may carry extra trailing zeros) unrealized_pnl: type: - string - 'null' description: >- Unrealized PnL (USD) (decimal string; may carry extra trailing zeros) display_name: type: - string - 'null' description: Display name twitter: type: - string - 'null' description: Twitter handle tag: type: - string - 'null' description: Tag verified: type: boolean description: Verified profile label: type: - string - 'null' description: Label sharpe_7d: type: - string - 'null' description: >- Sharpe, 7 d (decimal string; may carry extra trailing zeros) sharpe_30d: type: - string - 'null' description: >- Sharpe, 30 d (decimal string; may carry extra trailing zeros) sortino_7d: type: - string - 'null' description: >- Sortino, 7 d (decimal string; may carry extra trailing zeros) sortino_30d: type: - string - 'null' description: >- Sortino, 30 d (decimal string; may carry extra trailing zeros) sortino_90d: type: - string - 'null' description: >- Sortino, 90 d (decimal string; may carry extra trailing zeros) max_drawdown_week: type: - string - 'null' description: >- Max drawdown, 7 d (decimal string; may carry extra trailing zeros) max_drawdown_month: type: - string - 'null' description: >- Max drawdown, 30 d (decimal string; may carry extra trailing zeros) max_drawdown_90d: type: - string - 'null' description: >- Max drawdown, 90 d (decimal string; may carry extra trailing zeros) gpr_7d: type: - string - 'null' description: >- Gain-to-pain, 7 d (decimal string; may carry extra trailing zeros) gpr_30d: type: - string - 'null' description: >- Gain-to-pain, 30 d (decimal string; may carry extra trailing zeros) gpr_90d: type: - string - 'null' description: >- Gain-to-pain, 90 d (decimal string; may carry extra trailing zeros) gpr_all_time: type: - string - 'null' description: >- Gain-to-pain, all time (decimal string; may carry extra trailing zeros) copy_score: type: - string - 'null' description: >- Copy score (decimal string; may carry extra trailing zeros) copy_score_v2: type: - string - 'null' description: >- Copy score v2 (decimal string; may carry extra trailing zeros) top_assets: type: string description: 'Top assets (JSON: coin, volume, pnl)' total_volume: type: - string - 'null' description: >- Volume (USD) (decimal string; may carry extra trailing zeros) updated_at: type: integer description: Stats updated, 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/traders/screener?sort=sharpe30d&limit=100' 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.