> ## 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. # Per-market PnL leaderboard > hyperdash.com's per-market board: wallets ranked by total, realized or unrealized PnL, or their ROI, in one market over a window, with the PnL split and capital. 24h / 7d / 30d / ytd rank that market's portfolio PnL (open positions included); all time ranks completed-trade PnL. account_value is the wallet's live perps equity as the site overlays it (one read per page, ≤ 1.5 s, kept 5 s), else the board's hourly snapshot. One wallet's row: GET /v1/accounts/{address}/leaderboard?coin=. Pricing: base + per row + node reads. Scope: `analytics:read`. ## OpenAPI ````yaml /data-api/openapi.json get /v1/markets/{coin}/leaderboard 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/markets/{coin}/leaderboard: get: tags: - Markets summary: Per-market PnL leaderboard description: >- hyperdash.com's per-market board: wallets ranked by total, realized or unrealized PnL, or their ROI, in one market over a window, with the PnL split and capital. 24h / 7d / 30d / ytd rank that market's portfolio PnL (open positions included); all time ranks completed-trade PnL. account_value is the wallet's live perps equity as the site overlays it (one read per page, ≤ 1.5 s, kept 5 s), else the board's hourly snapshot. One wallet's row: GET /v1/accounts/{address}/leaderboard?coin=. Pricing: base + per row + node reads. Scope: `analytics:read`. operationId: getMarketLeaderboard parameters: - name: coin in: path required: true description: Market, e.g. BTC, xyz:TSLA. schema: type: string pattern: ^[A-Za-z0-9:_\-/@.]{1,40}$ - name: window in: query required: false description: Window. Default 30d, as hyperdash.com's per-market board. schema: type: string default: 30d enum: - 24h - 7d - 30d - ytd - alltime - name: sort in: query required: false description: >- Ranked metric: total (net PnL), realized, unrealized, or their ROI (÷ capital; wallets with capital ≥ $1,000). Wallets without that value are not ranked. schema: type: string default: total enum: - total - realized - unrealized - roi - realized_roi - unrealized_roi - name: limit in: query required: false description: Rows (≤ 100). schema: type: integer minimum: 1 maximum: 100 default: 50 - 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: rank: type: integer description: Rank address: type: string description: Wallet display_name: type: - string - 'null' description: Display name net_pnl: type: string description: >- Net PnL (USD) (decimal string; may carry extra trailing zeros) realized_pnl: type: - string - 'null' description: >- Realized PnL over the window (USD): closed PnL − fees + funding, partial closes included (decimal string; may carry extra trailing zeros) unrealized_pnl: type: - string - 'null' description: >- Change in open-position unrealized PnL over the window (USD); all time: open unrealized PnL now (decimal string; may carry extra trailing zeros) capital: type: - string - 'null' description: >- Capital (USD): equity at the window start + peak net external inflow (decimal string; may carry extra trailing zeros) roi: type: - string - 'null' description: >- Net PnL ÷ capital (ratio: 0.417 = 41.7 %) (decimal string; may carry extra trailing zeros) realized_roi: type: - string - 'null' description: >- Realized PnL ÷ capital (ratio) (decimal string; may carry extra trailing zeros) unrealized_roi: type: - string - 'null' description: >- Unrealized PnL ÷ capital (ratio) (decimal string; may carry extra trailing zeros) gross_pnl: type: string description: >- Gross PnL before fees and funding (USD): 24h / 7d / 30d / ytd = price PnL incl. open positions (net_pnl + fees − funding); all time = completed-trade gross PnL (closed round trips) (decimal string; may carry extra trailing zeros) funding_pnl: type: string description: >- Funding PnL (decimal string; may carry extra trailing zeros) fees: type: string description: >- Fees (decimal string; may carry extra trailing zeros) volume: type: string description: >- Volume (USD) (decimal string; may carry extra trailing zeros) trades: type: integer description: Trades winning_trades: type: integer description: Winning trades losing_trades: type: integer description: Losing trades account_value: type: - string - 'null' description: >- Account value (USD) as hyperdash.com's leaderboard shows it: live perps equity, every perp dex's account value summed; unified accounts: their collateral stablecoins (USDC, USDH, USDE, USDT0); portfolio-margin accounts: their signed spot portfolio at mids, else the board's hourly snapshot (see account_value_source) (decimal string; may carry extra trailing zeros) account_value_as_of: type: - integer - 'null' description: >- When the live value was read, epoch ms (null for the snapshot value) account_value_source: type: - string - 'null' description: >- live (read within the last 5 s) or snapshot (the live read did not answer for this wallet within 1.5 s) 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/markets/BTC/leaderboard?window=30d' 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.