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

# userFillsByTime

> Native Hyperliquid `/info` operation. Returns the user's fills within a time range.



## OpenAPI

````yaml /reference/api-json/hyperliquid-info-api-json.json post /v1/hyperliquid/info#42
openapi: 3.0.0
info:
  title: Uniblock Hyperliquid Info API
  description: >-
    Per-operation request/response docs for the Raw Hyperliquid Info dispatch
    endpoint. Each Hyperliquid Info `type` is a synthetic path through the
    single `POST /v1/hyperliquid/info` unified route.
  version: '1.0'
servers:
  - url: https://api.uniblock.dev/uni
    description: Gateway
security:
  - ApiKeyAuth: []
tags:
  - name: Hyperliquid
paths:
  /v1/hyperliquid/info#42:
    post:
      tags:
        - Hyperliquid
      summary: userFillsByTime
      description: >-
        Native Hyperliquid `/info` operation. Returns the user's fills within a
        time range.
      operationId: userFillsByTime_HyperliquidInfo
      parameters:
        - name: chainId
          required: true
          in: query
          description: Unique identifier for a blockchain network.
          schema:
            type: number
            enum:
              - 999
              - 998
            default: 999
            example: 999
        - name: provider
          required: false
          in: query
          description: >-
            Specify which provider to use. The project's provider priority list
            is used by default if no providers are selected. (Priority list can
            be managed on Uniblock's dashboard)
          schema:
            type: string
            enum:
              - Dwellir
              - Chainstack
              - Covalent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HyperliquidInfo_userFillsByTime_Request'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HyperliquidInfo_userFillsByTime_Response'
components:
  schemas:
    HyperliquidInfo_userFillsByTime_Request:
      type: object
      required:
        - type
        - user
        - startTime
      properties:
        type:
          type: string
          enum:
            - userFillsByTime
          default: userFillsByTime
          example: userFillsByTime
        user:
          type: string
          description: The account address to query (0x-prefixed).
          example: '0x000000000000000000000000000000000000dEaD'
        startTime:
          type: number
          description: Inclusive start time, epoch milliseconds.
          example: 1704067200000
        endTime:
          type: number
          description: Optional exclusive end time, epoch milliseconds. Defaults to now.
          example: 1706745600000
      example:
        type: userFillsByTime
        startTime: 1704067200000
        user: '0x000000000000000000000000000000000000dEaD'
    HyperliquidInfo_userFillsByTime_Response:
      type: array
      description: The user's fills, most recent first.
      items:
        type: object
        required:
          - coin
          - px
          - sz
          - side
          - time
          - hash
          - oid
          - tid
        properties:
          coin:
            type: string
            example: BTC
          px:
            type: string
            example: '63786.0'
          sz:
            type: string
            example: '0.028766'
          side:
            type: string
            description: '`A` for ask (sell), `B` for bid (buy).'
            example: A
          time:
            type: number
            example: 1779580800038
          startPosition:
            type: string
            example: '0.028766'
          dir:
            type: string
            example: Spot Dust Conversion
          closedPnl:
            type: string
            example: '0.0'
          hash:
            type: string
            example: '0x0000000000000000000000000000000000000000000000000000000000000000'
          oid:
            type: number
            example: 439553311407
          crossed:
            type: boolean
            example: true
          fee:
            type: string
            example: '0.0'
          tid:
            type: number
            example: 0
          feeToken:
            type: string
            example: USDC
          twapId:
            type: number
            nullable: true
      example:
        - coin: '@162'
          px: '1.42'
          sz: '0.057423'
          side: A
          time: 1753056000039
          startPosition: '0.057423'
          dir: Spot Dust Conversion
          closedPnl: '0.0'
          hash: '0x0000000000000000000000000000000000000000000000000000000000000000'
          oid: 117789741944
          crossed: true
          fee: '0.0'
          tid: 0
          feeToken: USDC
        - coin: '@188'
          px: '0.0035998'
          sz: '0.917835'
          side: A
          time: 1755216000002
          startPosition: '0.917835'
          dir: Spot Dust Conversion
          closedPnl: '0.0'
          hash: '0x0000000000000000000000000000000000000000000000000000000000000000'
          oid: 134586652141
          crossed: true
          fee: '0.0'
          tid: 0
          feeToken: USDC
        - coin: '@142'
          px: '108376.0'
          sz: '0.000009169'
          side: A
          time: 1756512000046
          startPosition: '0.000009169'
          dir: Spot Dust Conversion
          closedPnl: '0.0'
          hash: '0x0000000000000000000000000000000000000000000000000000000000000000'
          oid: 148186330902
          crossed: true
          fee: '0.0'
          tid: 0
          feeToken: USDC
        - coin: '@142'
          px: '115538.0'
          sz: '0.00000008'
          side: A
          time: 1757635200055
          startPosition: '0.00000008'
          dir: Spot Dust Conversion
          closedPnl: '0.0'
          hash: '0x0000000000000000000000000000000000000000000000000000000000000000'
          oid: 159725296618
          crossed: true
          fee: '0.0'
          tid: 0
          feeToken: USDC
        - coin: '@210'
          px: '0.31764'
          sz: '0.0405'
          side: A
          time: 1762732800049
          startPosition: '0.0405'
          dir: Spot Dust Conversion
          closedPnl: '0.0'
          hash: '0x0000000000000000000000000000000000000000000000000000000000000000'
          oid: 229209068373
          crossed: true
          fee: '0.0'
          tid: 0
          feeToken: USDC
        - coin: '@156'
          px: '164.56'
          sz: '0.000685'
          side: A
          time: 1762732800049
          startPosition: '0.000685'
          dir: Spot Dust Conversion
          closedPnl: '0.0'
          hash: '0x0000000000000000000000000000000000000000000000000000000000000000'
          oid: 229209068363
          crossed: true
          fee: '0.0'
          tid: 0
          feeToken: USDC
        - coin: '@243'
          px: '0.030574'
          sz: '0.09241'
          side: A
          time: 1764028800027
          startPosition: '0.09241'
          dir: Spot Dust Conversion
          closedPnl: '0.0'
          hash: '0x0000000000000000000000000000000000000000000000000000000000000000'
          oid: 247895591441
          crossed: true
          fee: '0.0'
          tid: 0
          feeToken: USDC
        - coin: '@230'
          px: '0.99997'
          sz: '0.00188948'
          side: A
          time: 1766102400067
          startPosition: '0.00188948'
          dir: Spot Dust Conversion
          closedPnl: '0.0'
          hash: '0x0000000000000000000000000000000000000000000000000000000000000000'
          oid: 273606103340
          crossed: true
          fee: '0.0'
          tid: 0
          feeToken: USDC
        - coin: '@166'
          px: '0.9997'
          sz: '0.003306'
          side: A
          time: 1766188800049
          startPosition: '0.003306'
          dir: Spot Dust Conversion
          closedPnl: '0.0'
          hash: '0x0000000000000000000000000000000000000000000000000000000000000000'
          oid: 274644835733
          crossed: true
          fee: '0.0'
          tid: 0
          feeToken: USDC
        - coin: '@206'
          px: '0.1032'
          sz: '0.0496'
          side: A
          time: 1772409600044
          startPosition: '0.0496'
          dir: Spot Dust Conversion
          closedPnl: '0.0'
          hash: '0x0000000000000000000000000000000000000000000000000000000000000000'
          oid: 334663993966
          crossed: true
          fee: '0.0'
          tid: 0
          feeToken: USDC
        - coin: '@166'
          px: '0.99997'
          sz: '0.00702922'
          side: A
          time: 1772755200030
          startPosition: '0.00702922'
          dir: Spot Dust Conversion
          closedPnl: '0.0'
          hash: '0x0000000000000000000000000000000000000000000000000000000000000000'
          oid: 339777806137
          crossed: true
          fee: '0.0'
          tid: 0
          feeToken: USDC
        - coin: '@305'
          px: '0.071916'
          sz: '0.028766'
          side: A
          time: 1779580800038
          startPosition: '0.028766'
          dir: Spot Dust Conversion
          closedPnl: '0.0'
          hash: '0x0000000000000000000000000000000000000000000000000000000000000000'
          oid: 439553311407
          crossed: true
          fee: '0.0'
          tid: 0
          feeToken: USDC
        - coin: '@188'
          px: '0.0017754'
          sz: '0.090505'
          side: A
          time: 1779580800038
          startPosition: '0.090505'
          dir: Spot Dust Conversion
          closedPnl: '0.0'
          hash: '0x0000000000000000000000000000000000000000000000000000000000000000'
          oid: 439553311402
          crossed: true
          fee: '0.0'
          tid: 0
          feeToken: USDC
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: API key to access the API (Optional)

````