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

# List Events

> List Events.

Returns a cursor-paginated list of events.

**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/prediction/events"
```

Use `limit` and `cursor` for pagination. Optional filters include event ID, slug, tag, active, and closed state.

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

The response contains `items` and `next_cursor`. Each event includes identifiers, title/description, lifecycle flags, dates, tags, volume, and (where available) a market summary.

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-markets-en.yaml GET /api/v4/prediction/events
openapi: 3.0.3
info:
  title: DexBuilder Prediction Markets API
  version: 1.0.0
  description: DexBuilder Prediction Markets REST API.
servers:
  - url: https://api.dexbuilder.com
security: []
paths:
  /api/v4/prediction/events:
    get:
      summary: List Events
      description: List Events.
      operationId: query_events
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
        - name: cursor
          in: query
          required: false
          schema:
            type: string
        - name: sort
          in: query
          required: false
          schema:
            type: string
        - name: ascending
          in: query
          required: false
          schema:
            type: boolean
        - name: event_id
          in: query
          required: false
          schema:
            type: string
        - name: slug
          in: query
          required: false
          schema:
            type: string
        - name: tag_slug
          in: query
          required: false
          schema:
            type: string
        - name: active
          in: query
          required: false
          schema:
            type: boolean
        - name: closed
          in: query
          required: false
          schema:
            type: boolean
        - name: start_date_min
          in: query
          required: false
          description: Unix timestamp in milliseconds.
          schema:
            type: integer
            minimum: 0
        - name: start_date_max
          in: query
          required: false
          description: Unix timestamp in milliseconds.
          schema:
            type: integer
            minimum: 0
        - name: end_date_min
          in: query
          required: false
          description: Unix timestamp in milliseconds.
          schema:
            type: integer
            minimum: 0
        - name: end_date_max
          in: query
          required: false
          description: Unix timestamp in milliseconds.
          schema:
            type: integer
            minimum: 0
        - name: tag_id
          in: query
          required: false
          description: Repeatable Tag ID filter.
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
        - name: exclude_tag_id
          in: query
          required: false
          description: Repeatable excluded Tag ID filter.
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
      responses:
        '200':
          description: Request succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EventsPage'
        '400':
          description: Invalid request or parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Service temporarily unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    EventsPage:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/EventSummary'
        next_cursor:
          type: string
          nullable: true
          description: Cursor for the next page; null means there are no more results.
      description: Response object.
    Error:
      type: object
      description: Error response.
      properties:
        label:
          type: string
          example: INVALID_ARGUMENT
        message:
          type: string
          example: invalid request
    EventSummary:
      type: object
      properties:
        active:
          type: boolean
        category:
          type: string
          nullable: true
        closed:
          type: boolean
        closed_time:
          type: integer
          nullable: true
        end_date:
          type: integer
          nullable: true
        event_id:
          type: string
        icon:
          type: string
          nullable: true
        image:
          type: string
          nullable: true
        slug:
          type: string
        start_date:
          type: integer
          nullable: true
        start_time:
          type: integer
          nullable: true
        tags:
          type: array
          items:
            $ref: '#/components/schemas/TagSummary'
        title:
          type: object
          nullable: true
        volume:
          type: string
          nullable: true
      description: Response object.
    TagSummary:
      type: object
      properties:
        label:
          type: object
          nullable: true
        slug:
          type: string
        tag_id:
          type: string
      description: Response object.

````

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