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

# Hyperliquid Target By Timestamp

> Searches the live Hyperliquid outcome catalog for the market whose active window contains the requested timestamp. Pass an official Hyperliquid trade slug to scope the response to one market, or omit `slug` to rank the full live catalog.

<Note>
  Today this authenticated endpoint searches the live Hyperliquid outcome catalog. Pass an official Hyperliquid trade slug to scope the lookup to one market, or omit `slug` to rank every live market for the requested timestamp. If the timestamp falls inside an active market window, you get an `exact` match. Otherwise you get the nearest currently-known market from the live catalog.
</Note>


## OpenAPI

````yaml GET /api/v1/hyperliquid/targets/timestamp
openapi: 3.1.0
info:
  title: Vatic API
  version: 1.0.0
  description: >-
    Polymarket price targets, Hyperliquid prediction market data, market
    timestamps, fee calculators, and order management for systematic prediction
    market trading.
servers:
  - url: https://api.vatic.trading
    description: Production
security: []
paths:
  /api/v1/hyperliquid/targets/timestamp:
    get:
      tags:
        - Hyperliquid
      summary: Hyperliquid target lookup by timestamp
      description: >-
        Searches the live Hyperliquid outcome catalog for the market whose
        active window contains the requested timestamp. Pass an official
        Hyperliquid trade slug to scope the response to one market, or omit
        `slug` to rank the full live catalog.
      operationId: getHyperliquidTargetsTimestamp
      parameters:
        - name: slug
          in: query
          required: false
          schema:
            type: string
            example: btc-above-78213-yes-may-04-0600
          description: >-
            Optional official Hyperliquid trade slug, or the full Hyperliquid
            trade URL.
        - name: timestamp
          in: query
          required: true
          schema:
            type: integer
            example: 1777788000
          description: Unix timestamp in seconds, unix ms, or an ISO datetime string.
      responses:
        '200':
          description: >-
            The exact or nearest live-catalog Hyperliquid markets for the
            requested timestamp
          content:
            application/json:
              example:
                now: '2026-05-03T10:20:03.513Z'
                slug: btc-above-78213-yes-may-04-0600
                source: hyperliquid
                requestedTimestamp: 1777788000
                requestedTimestampIso: '2026-05-03T06:00:00.000Z'
                results:
                  - matchType: exact
                    distanceSeconds: 0
                    outcomeId: 1
                    marketSlug: btc-above-78213-may-04-0600
                    yesSlug: btc-above-78213-yes-may-04-0600
                    noSlug: btc-above-78213-no-may-04-0600
                    tradeUrls:
                      'yes': >-
                        https://app.hyperliquid.xyz/trade/btc-above-78213-yes-may-04-0600
                      'no': >-
                        https://app.hyperliquid.xyz/trade/btc-above-78213-no-may-04-0600
                    underlying: BTC
                    marketClass: priceBinary
                    period: 1d
                    windowStart: 1777788000
                    windowStartIso: '2026-05-03T06:00:00.000Z'
                    expiry: 1777874400
                    expiryIso: '2026-05-04T06:00:00.000Z'
                    source: hyperliquid
                    price: 78213
                    yesPrice: 0.592455
                    noPrice: 0.407545
                    question: BTC above 78213 at 2026-05-04T06:00:00.000Z
        '400':
          description: Validation error
        '401':
          description: API key required or invalid
        '404':
          description: >-
            No Hyperliquid prediction market found for the requested slug, or
            the live catalog is empty
        '502':
          description: Hyperliquid upstream error
      security:
        - ApiKey: []
components:
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Required for order endpoints. Obtain your API key from the Vatic
        dashboard.

````