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

# Market Timestamps

> Returns all market window timestamps for a given UTC day and asset. Includes the market slug and Polymarket URL for each window.



## OpenAPI

````yaml GET /api/v1/markets/timestamps
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/markets/timestamps:
    get:
      tags:
        - Markets
      summary: Market window timestamps for a day
      description: >-
        Returns all market window timestamps for a given UTC day and asset.
        Includes the market slug and Polymarket URL for each window.
      operationId: getMarketTimestamps
      parameters:
        - name: asset
          in: query
          required: true
          schema:
            type: string
            enum:
              - btc
              - eth
              - sol
              - xrp
              - hype
              - doge
              - bnb
        - name: intervals
          in: query
          required: false
          schema:
            type: string
            example: 5min,15min,1hour,4hour,daily
          description: >-
            Comma-separated interval types. Defaults to all. Also accepts
            singular `interval`.
        - name: date
          in: query
          required: false
          schema:
            type: string
            example: '2025-04-07'
          description: UTC date in YYYY-MM-DD format. Defaults to today.
      responses:
        '200':
          description: Window timestamps grouped by interval
          content:
            application/json:
              example:
                now: '2025-04-07T12:00:00.000Z'
                asset: btc
                utc_date: '2025-04-07'
                day_start_unix: 1744012800
                day_end_unix: 1744099200
                intervals:
                  - 5min
                data:
                  5min:
                    count: 288
                    chronological_order:
                      - index: 1
                        timestamp_start: 1744012800
                        timestamp_end: 1744013100
                        start_iso: '2025-04-07T00:00:00.000Z'
                        end_iso: '2025-04-07T00:05:00.000Z'
                        slug: btc-updown-5m-1744012800
                        url: https://polymarket.com/event/btc-updown-5m-1744012800
        '400':
          description: Validation error

````