> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hypedexer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Completed trades summary



## OpenAPI

````yaml /api-reference/openapi.json get /completed-trades/summary
openapi: 3.0.3
info:
  title: 'Hypedexer API: Indexed Data'
  version: 1.0.0
  description: >-
    API to query indexed Hyperliquid trading data.


    This API provides access to stored/indexed trading data:

    - **Fills**: Executed orders and fills (Spot-only or All = Spot + Perp)

    - **Analytics**: Aggregations and statistics based on indexed data

    - **Completed Trades**: Trade objects and their related fills

    - **Users**: User overviews, performance and activity

    - **Social Trading**: Per-trader equity curve, PnL calendar, account
    leverage and top trades

    - **Funding**: Funding rate history, user funding payments, predicted rates

    - **Liquidations**: Liquidation events with filters

    - **Overview**: Market dashboard metrics (volume, fees, traders, PnL)

    - **Spot**: Spot token metadata, pairs, and auctions

    - **TWAPs**: TWAP orders, execution stats and fills

    - **Vaults**: Vault details, summaries, equity, ledger


    > Note: No live streaming. Responses are computed from indexed data.
servers:
  - url: https://api.hypedexer.com
    description: Production, routed to the nearest region (EU or JP)
security:
  - ApiKeyAuth: []
tags:
  - name: Fills
    description: Fills endpoints.
  - name: Analytics
    description: Aggregations and stats.
  - name: Completed Trades
    description: Trades and fills.
  - name: Users
    description: User profiles.
  - name: Funding
    description: Funding rates and payments (HL-compatible).
  - name: Liquidations
    description: Liquidation events.
  - name: Overview
    description: Market dashboard metrics.
  - name: Spot
    description: Spot token metadata, pairs and auctions.
  - name: TWAPs
    description: TWAP orders, stats and fills.
  - name: Vaults
    description: Vault details, summaries, equity and ledger.
  - name: Social Trading
    description: >-
      Per-trader equity, PnL calendar, performance, account leverage and top
      trades.
  - name: Market history
    description: >-
      Historical Hyperliquid market microstructure: best bid/offer aggregates
      and spread statistics (April 2024 to February 2026), and the order book
      reconstructed minute by minute: April 2024 to February 2026 from our
      archive (top ~20 levels per side) and, since 23 September 2026, the full
      order book replayed from our own node. Served from the EU region.
paths:
  /completed-trades/summary:
    get:
      tags:
        - Completed Trades
      summary: Completed trades summary
      parameters:
        - name: user
          in: query
          schema:
            type: string
        - name: coin
          in: query
          schema:
            type: string
        - name: direction
          in: query
          schema:
            type: string
            enum:
              - long
              - short
        - name: start_time
          in: query
          schema:
            type: string
            format: date-time
        - name: end_time
          in: query
          schema:
            type: string
            format: date-time
        - name: X-API-Key
          in: header
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  data:
                    type: object
                  total_count:
                    type: integer
                    nullable: true
                  next_cursor:
                    type: string
                    nullable: true
                  has_more:
                    type: boolean
                    nullable: true
              example:
                success: true
                message: Summary generated
                data:
                  total_trades: 85944
                  total_pnl: 385654.17053600005
                  avg_pnl_pct: 0.11990387188704589
                  avg_duration_s: 48837.822977752956
                  total_fees: 0
                  total_volume: 14274964822.116814
                  time_range:
                    start: '2025-09-19T05:47:54.934000'
                    end: '2026-09-19T06:57:17.368000'
                  direction_breakdown:
                    - direction: short
                      count: 43017
                      total_pnl: 2597619.3502979986
                    - direction: long
                      count: 42927
                      total_pnl: -2211965.1797620025
                  top_coins:
                    - coin: HYPE
                      trade_count: 3205
                      total_pnl: 448136.66844500153
                      total_volume: 693806621.120858
                    - coin: ZEC
                      trade_count: 3082
                      total_pnl: -410406.15864799946
                      total_volume: 608141577.2059263
                    - coin: FARTCOIN
                      trade_count: 2025
                      total_pnl: 101328.0988959996
                      total_volume: 267412414.6500905
                    - coin: ASTER
                      trade_count: 1903
                      total_pnl: -29518.903476000072
                      total_volume: 174467002.2072597
                    - coin: TAO
                      trade_count: 1726
                      total_pnl: -19617.718512000265
                      total_volume: 236191474.12447086
                    - coin: PUMP
                      trade_count: 1630
                      total_pnl: 78542.41807199981
                      total_volume: 251821744.80018547
                    - coin: PENGU
                      trade_count: 1464
                      total_pnl: 42647.75580599979
                      total_volume: 138108600.38720602
                    - coin: VVV
                      trade_count: 1380
                      total_pnl: -5828.120728000908
                      total_volume: 150137458.0669882
                    - coin: VIRTUAL
                      trade_count: 1360
                      total_pnl: 73639.813303
                      total_volume: 169135754.4882354
                    - coin: ENA
                      trade_count: 1258
                      total_pnl: -16683.619559999755
                      total_volume: 169977050.53480107
                total_count: null
                execution_time_ms: null
                next_cursor: null
                has_more: null
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        Your Hypedexer API key. Create one in the console at
        https://app.hypedexer.com. `Authorization: Bearer <key>` and the
        `api_key` query parameter are accepted as well.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.