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

# Polymarket Events

> Get Polymarket Events

Events fetches event/group data from Polymarket Gamma. The AIsa route returns the upstream Gamma response directly as a top-level JSON array of event objects.

**Best for:** Browsing grouped prediction-market events and their associated markets, volumes, dates, tags, and status.

**Endpoint:** `GET /polymarket/events`

## Example

```curl theme={null}
curl -X GET "https://api.aisa.one/apis/v1/polymarket/events?limit=5&closed=false" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

## Response

The response is a JSON array. Each item is a Polymarket Gamma event object with fields such as `id`, `ticker`, `slug`, `title`, `description`, `active`, `closed`, `volume`, `liquidity`, `image`, `tags`, and `markets`.


## OpenAPI

````yaml openapi/polymarket-openapi.json GET /polymarket/events
openapi: 3.0.3
info:
  title: AIsa API proxy
  description: APIs for prediction markets.
  version: 0.0.1
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - BearerAuth: []
paths:
  /polymarket/events:
    get:
      summary: Get Events
      description: >-
        Fetches Polymarket Gamma events. This AIsa route returns the upstream
        Polymarket Gamma response directly: a top-level JSON array of event
        objects.
      operationId: get_polymarket-events
      parameters:
        - name: limit
          in: query
          required: false
          description: Maximum number of events to return.
          schema:
            type: integer
            minimum: 0
            example: 20
        - name: offset
          in: query
          required: false
          description: Number of events to skip for offset-based pagination.
          schema:
            type: integer
            minimum: 0
            example: 0
        - name: order
          in: query
          required: false
          description: Comma-separated list of fields to order by.
          schema:
            type: string
            example: volume
        - name: ascending
          in: query
          required: false
          description: Sort ascending when true.
          schema:
            type: boolean
            example: false
        - name: id
          in: query
          required: false
          description: Filter by one or more event IDs.
          schema:
            type: array
            items:
              type: integer
          style: form
          explode: true
        - name: slug
          in: query
          required: false
          description: Filter by one or more event slugs.
          schema:
            type: array
            items:
              type: string
          style: form
          explode: true
        - name: tag_id
          in: query
          required: false
          description: Filter by tag ID.
          schema:
            type: integer
        - name: tag_slug
          in: query
          required: false
          description: Filter by tag slug.
          schema:
            type: string
            example: sports
        - name: active
          in: query
          required: false
          description: Filter by active events.
          schema:
            type: boolean
        - name: archived
          in: query
          required: false
          description: Filter by archived events.
          schema:
            type: boolean
        - name: featured
          in: query
          required: false
          description: Filter by featured events.
          schema:
            type: boolean
        - name: closed
          in: query
          required: false
          description: Filter by whether the event is closed.
          schema:
            type: boolean
        - name: liquidity_min
          in: query
          required: false
          description: Minimum liquidity.
          schema:
            type: number
        - name: liquidity_max
          in: query
          required: false
          description: Maximum liquidity.
          schema:
            type: number
        - name: volume_min
          in: query
          required: false
          description: Minimum volume.
          schema:
            type: number
        - name: volume_max
          in: query
          required: false
          description: Maximum volume.
          schema:
            type: number
        - name: start_date_min
          in: query
          required: false
          description: Filter events starting after this ISO timestamp.
          schema:
            type: string
            format: date-time
        - name: start_date_max
          in: query
          required: false
          description: Filter events starting before this ISO timestamp.
          schema:
            type: string
            format: date-time
        - name: end_date_min
          in: query
          required: false
          description: Filter events ending after this ISO timestamp.
          schema:
            type: string
            format: date-time
        - name: end_date_max
          in: query
          required: false
          description: Filter events ending before this ISO timestamp.
          schema:
            type: string
            format: date-time
      responses:
        '200':
          description: Top-level array of Polymarket event objects
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  additionalProperties: true
                  properties:
                    id:
                      type: string
                    ticker:
                      type: string
                    slug:
                      type: string
                    title:
                      type: string
                    description:
                      type: string
                    active:
                      type: boolean
                    closed:
                      type: boolean
                    archived:
                      type: boolean
                    startDate:
                      type: string
                      format: date-time
                    endDate:
                      type: string
                      format: date-time
                    volume:
                      type: string
                    volume24hr:
                      type: number
                    liquidity:
                      type: number
                    image:
                      type: string
                    icon:
                      type: string
                    markets:
                      type: array
                      items:
                        type: object
                        additionalProperties: true
        '400':
          description: Bad Request - Invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Invalid status parameter
                  message:
                    type: string
                    example: status must be 'open' or 'closed'
              examples:
                invalid_status:
                  summary: Invalid status
                  value:
                    error: Invalid status parameter
                    message: status must be 'open' or 'closed'
                invalid_limit:
                  summary: Invalid limit
                  value:
                    error: Invalid limit parameter
                    message: limit must be a number between 1 and 100
                invalid_offset:
                  summary: Invalid offset
                  value:
                    error: Invalid offset parameter
                    message: offset must be a non-negative number
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Internal Server Error
                  message:
                    type: string
                    example: Failed to fetch events data
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: AISA API Key
      description: Your AIsa API key as a Bearer token.

````