> ## 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. # User fills (All = Spot + Perp) > Returns user fills. Each fill includes `priorityGas` (priority fee paid, null if none) and `block_number` (Hyperliquid block number, null for older fills). By default, only recent data (from March 2025 onward) is available. Historical data prior to March 2025 is exclusively available on Scale & Enterprise plans via the `start_time` / `end_time` parameters. This is currently the only endpoint supporting pre-March historical access. **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/user/{user_address} 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: /fills/user/{user_address}: get: tags: - Fills summary: User fills (All = Spot + Perp) description: >- Returns user fills. Each fill includes `priorityGas` (priority fee paid, null if none) and `block_number` (Hyperliquid block number, null for older fills). By default, only recent data (from March 2025 onward) is available. Historical data prior to March 2025 is exclusively available on Scale & Enterprise plans via the `start_time` / `end_time` parameters. This is currently the only endpoint supporting pre-March historical access. **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. parameters: - name: user_address in: path required: true schema: type: string pattern: ^0x[0-9a-fA-F]{40}$ - name: time_range in: query description: Preset time range schema: type: string enum: - 1h - 24h - 7d - 30d - name: coin in: query schema: type: string - name: start_time in: query required: false schema: type: string format: date-time nullable: true description: >- Start time (ISO UTC). Required for Scale/Enterprise historical access. Overrides time_range. example: '2025-01-01T00:00:00' - name: end_time in: query required: false schema: type: string format: date-time nullable: true description: End time (ISO UTC). Defaults to now if start_time is set. example: '2025-03-22T00:00:00' - name: limit in: query required: false schema: type: integer default: 100 minimum: 1 maximum: 10000 description: Max results (cap 10000) - 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: Fills for user 0x010461c1... (compact) data: - user: '0x010461c14e146ac35fe42271bdc1134ee31c703a' coin: OP coinMeaning: OP px: 0.10127 sz: 3944.5 side: B startPosition: -597650.1 time: '2026-09-18 00:04:59.759000' tid: 152988313348231 oid: 548310212171 hash: >- 0x1357b13d54c29f9f14d10444a28a660202860022efc5be71b7205c9013c67989 fee: 0 feeToken: USDC typeTrade: perp isLiquidation: 0 liquidationRole: none liqMarkPx: null liqMethod: null liquidatedUser: null notional: 399.459515 priorityGas: null - user: '0x010461c14e146ac35fe42271bdc1134ee31c703a' coin: USELESS coinMeaning: USELESS px: 0.2646 sz: 125 side: B startPosition: -175430 time: '2026-09-18 00:04:59.356000' tid: 339668818780777 oid: 548310191721 hash: >- 0x4cab9b37844e358c4e250444a28a600202dc001d1f41545ef074468a43420f76 fee: 0 feeToken: USDC typeTrade: perp isLiquidation: 0 liquidationRole: none liqMarkPx: null liqMethod: null liquidatedUser: null notional: 33.075 priorityGas: null total_count: 924 execution_time_ms: 0.76 next_cursor: '1789689899356:339668818780777' 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 ` 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.