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

# Recent fills

> Recent fills (live table, 24h TTL): same filters as `/fills`, faster responses for the recent time window. Each fill includes `priorityGas` (priority fee paid, null if none) and `block_number` (Hyperliquid block number, null for older fills).

**Order type (opt-in):** set `include_order_type=true` to add `orderType` (string or null) to each fill: the originating order's type (`Limit`, `Market`, `Stop Market`, `Take Profit Limit`, …: open set), resolved server-side from the order status by (user, oid). See `GET /fills/` for full semantics. Default `false` leaves the response byte-identical (key absent). `orderType` is `null` for orders placed before 2026-06-27 (start of order-status coverage) or when the order status is unknown. Adds roughly tens of milliseconds per page of 1000 fills.



## OpenAPI

````yaml /api-reference/openapi.json get /fills/recent
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.
paths:
  /fills/recent:
    get:
      tags:
        - Fills
      summary: Recent fills
      description: >-
        Recent fills (live table, 24h TTL): same filters as `/fills`, faster
        responses for the recent time window. Each fill includes `priorityGas`
        (priority fee paid, null if none) and `block_number` (Hyperliquid block
        number, null for older fills).


        **Order type (opt-in):** set `include_order_type=true` to add
        `orderType` (string or null) to each fill: the originating order's type
        (`Limit`, `Market`, `Stop Market`, `Take Profit Limit`, …: open set),
        resolved server-side from the order status by (user, oid). See `GET
        /fills/` for full semantics. Default `false` leaves the response
        byte-identical (key absent). `orderType` is `null` for orders placed
        before 2026-06-27 (start of order-status coverage) or when the order
        status is unknown. Adds roughly tens of milliseconds per page of 1000
        fills.
      operationId: get_fills_recent
      parameters:
        - name: user
          in: query
          description: User address
          schema:
            type: string
        - name: coin
          in: query
          description: Coin symbol
          schema:
            type: string
        - name: side
          in: query
          description: Side (B=Buy, A=Sell)
          schema:
            type: string
            enum:
              - B
              - A
        - name: size_usd
          in: query
          description: Minimum notional amount in USD
          schema:
            type: number
        - name: start_time
          in: query
          schema:
            type: string
            format: date-time
        - name: end_time
          in: query
          schema:
            type: string
            format: date-time
        - name: limit
          in: query
          schema:
            type: integer
            default: 100
        - name: cursor
          in: query
          schema:
            type: string
        - name: order
          in: query
          schema:
            type: string
            default: DESC
            enum:
              - ASC
              - DESC
        - name: has_priority_gas
          in: query
          required: false
          description: >-
            Filter by priority gas: `true` = only fills with priorityGas > 0,
            `false` = only fills without, omit = no filter.
          schema:
            type: boolean
            nullable: true
        - name: include_order_type
          in: query
          required: false
          description: >-
            Set to `true` to add `orderType` to each fill: the originating
            order's type (e.g. `Limit`, `Market`, `Stop Market`, `Take Profit
            Limit`), resolved server-side from the order status by (user, oid);
            `null` when unknown. Default `false`: response unchanged, key
            absent.
          schema:
            type: boolean
            default: false
        - 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: array
                    items:
                      type: object
                  total_count:
                    type: integer
                    nullable: true
                  next_cursor:
                    type: string
                    nullable: true
                  has_more:
                    type: boolean
                    nullable: true
              example:
                success: true
                message: Fetched 2 recent fills (compact)
                data:
                  - user: '0x654086857e1fad6dcf05cf6695cce51ea3984268'
                    coin: ETH
                    coinMeaning: ETH
                    px: 2630.9
                    sz: 0.419
                    side: B
                    time: '2026-09-19T07:10:19.398999'
                    startPosition: -7.0988
                    dir: Close Short
                    closedPnl: -0.9637
                    hash: >-
                      0x0f8965b4bc18ff8d11030444ba78d301e2007d9a571c1e5fb35211077b1cd977
                    oid: 549645125989
                    tid: 382659237386851
                    fee: 0.011023
                    feeToken: USDC
                    typeTrade: perp
                    isLiquidation: 0
                    liquidationRole: none
                    liqMarkPx: null
                    liqMethod: null
                    liquidatedUser: null
                    notional: 1102.3471
                    priorityGas: null
                  - user: '0x46c9a4d12683041a1e279367e124ccc09f96a453'
                    coin: DOGE
                    coinMeaning: DOGE
                    px: 0.087304
                    sz: 1718
                    side: B
                    time: '2026-09-19T07:10:19.332000'
                    startPosition: 18932
                    dir: Open Long
                    closedPnl: 0
                    hash: >-
                      0x66a957b34d6493f468230444ba78d20203840098e867b2c60a7203060c686ddf
                    oid: 549645143541
                    tid: 996404197999085
                    fee: 0.059995
                    feeToken: USDC
                    typeTrade: perp
                    isLiquidation: 0
                    liquidationRole: none
                    liqMarkPx: null
                    liqMethod: null
                    liquidatedUser: null
                    notional: 149.98827200000002
                    priorityGas: null
                total_count: null
                execution_time_ms: 1622.44
                next_cursor: '1789801819332:996404197999085'
                has_more: true
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.

````