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

# Get Prices

> Get ENTSO-E day-ahead electricity prices.

Query parameters accept ISO 8601 or relative shorthand:
  - ISO 8601: ``2025-01-15T12:30:00``
  - Relative: ``now``, ``now-30d``, ``now-1H``, ``now-15m``, etc.

Timezone: All datetimes resolve against server UTC. Response includes
``resolved_datetime_from``/``resolved_datetime_to`` in ``meta`` showing
what the server understood; they are UTC-naive.

Default range: ``datetime_from="now-30d"`` (30 days back), ``datetime_to="now"``.

Params:
  datetime_from: Start of time range (or relative offset). Defaults to now-30d.
  datetime_to: End of time range (or relative offset). Defaults to now.
  zone: Filter by bidding zone(s). Omit for all zones.
  resolution: 1H, 1D, 1W, native, or auto. Default: auto (server picks
    based on range width; native forces raw data regardless of range).

Returns envelope with meta block (provenance, resolved datetimes) and
data array of price rows.



## OpenAPI

````yaml https://api.voltpath.ai/openapi.json get /api/v1/prices
openapi: 3.1.0
info:
  title: Voltpath API
  version: 1.0.0
servers: []
security: []
paths:
  /api/v1/prices:
    get:
      tags:
        - entsoe
      summary: Get Prices
      description: >-
        Get ENTSO-E day-ahead electricity prices.


        Query parameters accept ISO 8601 or relative shorthand:
          - ISO 8601: ``2025-01-15T12:30:00``
          - Relative: ``now``, ``now-30d``, ``now-1H``, ``now-15m``, etc.

        Timezone: All datetimes resolve against server UTC. Response includes

        ``resolved_datetime_from``/``resolved_datetime_to`` in ``meta`` showing

        what the server understood; they are UTC-naive.


        Default range: ``datetime_from="now-30d"`` (30 days back),
        ``datetime_to="now"``.


        Params:
          datetime_from: Start of time range (or relative offset). Defaults to now-30d.
          datetime_to: End of time range (or relative offset). Defaults to now.
          zone: Filter by bidding zone(s). Omit for all zones.
          resolution: 1H, 1D, 1W, native, or auto. Default: auto (server picks
            based on range width; native forces raw data regardless of range).

        Returns envelope with meta block (provenance, resolved datetimes) and

        data array of price rows.
      operationId: get_prices_api_v1_prices_get
      parameters:
        - name: datetime_from
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            default: now-30d
            title: Datetime From
        - name: datetime_to
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            default: now
            title: Datetime To
        - name: zone
          in: query
          required: false
          schema:
            anyOf:
              - items:
                  type: string
                type: array
              - type: 'null'
            title: Zone
        - name: resolution
          in: query
          required: false
          schema:
            enum:
              - auto
              - native
              - 1H
              - 1D
              - 1W
            type: string
            default: auto
            title: Resolution
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope_list_PriceRow__'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    Envelope_list_PriceRow__:
      properties:
        meta:
          $ref: '#/components/schemas/Meta'
        data:
          items:
            $ref: '#/components/schemas/PriceRow'
          type: array
          title: Data
      additionalProperties: false
      type: object
      required:
        - meta
        - data
      title: Envelope[list[PriceRow]]
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    Meta:
      properties:
        provenance:
          type: string
          enum:
            - measured
            - derived
          title: Provenance
        upstream_sources:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Upstream Sources
        resolved_datetime_from:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Resolved Datetime From
        resolved_datetime_to:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Resolved Datetime To
        resolution:
          anyOf:
            - type: string
            - type: 'null'
          title: Resolution
      additionalProperties: false
      type: object
      required:
        - provenance
      title: Meta
    PriceRow:
      properties:
        datetime:
          type: string
          format: date-time
          title: Datetime
        bidding_zone:
          type: string
          title: Bidding Zone
        price_mwh:
          type: number
          title: Price Mwh
        interpolated:
          type: boolean
          title: Interpolated
        year:
          type: integer
          title: Year
      additionalProperties: false
      type: object
      required:
        - datetime
        - bidding_zone
        - price_mwh
        - interpolated
        - year
      title: PriceRow
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````