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

# Get Event Reference Price

> Get the target price and final price for an event window.

Returns one event selected by its event ID.

**Base URL:** `https://api.dexbuilder.com`

**Authentication:** This is a public market-data endpoint and does not require authentication.

## Request

```bash theme={null}
curl -G "https://api.dexbuilder.com/api/v4/event_contracts/events/price_to_beat_final_price/{slug}"
```

`event_id` identifies the event.

The OpenAPI panel below is the source of truth for required parameters, types, enum values, and request-body fields. Timestamps are Unix timestamps unless the field description states otherwise.

## Response

Returns one event object with identifiers, localized title/description, lifecycle state, dates, tags, volume, and related markets.

A successful response uses HTTP 200. Invalid parameters or request bodies return HTTP 400. Private endpoints can return HTTP 401 when authentication fails, and temporary upstream failures can return HTTP 503. The error response contains a machine-readable label and message.

For order, position, claim, transfer, and account operations, treat the response as the current server result and query the resource again when the operation is asynchronous.


## OpenAPI

````yaml openapi/event-contracts-en.yaml GET /api/v4/event_contracts/events/price_to_beat_final_price/{slug}
openapi: 3.0.3
info:
  title: DexBuilder Event Contracts API
  version: 1.0.0
  description: DexBuilder Event Contracts REST API.
servers:
  - url: https://api.dexbuilder.com
security: []
paths:
  /api/v4/event_contracts/events/price_to_beat_final_price/{slug}:
    get:
      summary: Get Event Reference Price
      description: Get the target and final prices for an event window.
      operationId: query_event_reference_price
      parameters:
        - name: slug
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Request succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EventReferencePrice'
        '400':
          description: Invalid request or parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Event not found or reference price unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Service temporarily unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    EventReferencePrice:
      type: object
      properties:
        final_price:
          type: string
        price_to_beat:
          type: string
        slug:
          type: string
        status:
          type: string
          enum:
            - not_ready
            - unsupported
      description: Response object.
    Error:
      type: object
      description: Error response.
      properties:
        label:
          type: string
          example: INVALID_ARGUMENT
        message:
          type: string
          example: invalid request

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.