> ## 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 事件

> 获取 Polymarket 事件

Events 从 Polymarket Gamma 获取事件/分组数据。AIsa 路由直接返回上游 Gamma 响应，即由事件对象组成的顶层 JSON 数组。

**最适合：** 浏览分组的预测市场事件及其关联市场、交易量、日期、标签和状态。

**端点：** `GET /polymarket/events`

## 示例

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

## 响应

响应是一个 JSON 数组。每一项都是 Polymarket Gamma 事件对象，包含 `id`、`ticker`、`slug`、`title`、`description`、`active`、`closed`、`volume`、`liquidity`、`image`、`tags` 和 `markets` 等字段。


## OpenAPI

````yaml openapi/zh/polymarket-openapi.json GET /polymarket/events
openapi: 3.0.3
info:
  title: AIsa API proxy
  description: 预测市场 API。
  version: 0.0.1
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - BearerAuth: []
paths:
  /polymarket/events:
    get:
      summary: 获取事件
      description: >-
        获取 Polymarket Gamma 事件。此 AIsa 路由直接返回上游 Polymarket Gamma 响应：由事件对象组成的顶层
        JSON 数组。
      operationId: get_polymarket-events
      parameters:
        - name: limit
          in: query
          required: false
          description: 返回的最大事件数。
          schema:
            type: integer
            minimum: 0
            example: 20
        - name: offset
          in: query
          required: false
          description: 基于偏移量分页时要跳过的事件数量。
          schema:
            type: integer
            minimum: 0
            example: 0
        - name: order
          in: query
          required: false
          description: 用于排序的字段列表，以逗号分隔。
          schema:
            type: string
            example: volume
        - name: ascending
          in: query
          required: false
          description: 为 true 时按升序排序。
          schema:
            type: boolean
            example: false
        - name: id
          in: query
          required: false
          description: 按一个或多个事件 ID 筛选。
          schema:
            type: array
            items:
              type: integer
          style: form
          explode: true
        - name: slug
          in: query
          required: false
          description: 按一个或多个事件 slug 筛选。
          schema:
            type: array
            items:
              type: string
          style: form
          explode: true
        - name: tag_id
          in: query
          required: false
          description: 按标签 ID 筛选。
          schema:
            type: integer
        - name: tag_slug
          in: query
          required: false
          description: 按标签 slug 筛选。
          schema:
            type: string
            example: sports
        - name: active
          in: query
          required: false
          description: 按活跃事件筛选。
          schema:
            type: boolean
        - name: archived
          in: query
          required: false
          description: 按已归档事件筛选。
          schema:
            type: boolean
        - name: featured
          in: query
          required: false
          description: 按精选事件筛选。
          schema:
            type: boolean
        - name: closed
          in: query
          required: false
          description: 按事件是否已关闭进行筛选。
          schema:
            type: boolean
        - name: liquidity_min
          in: query
          required: false
          description: 最低流动性。
          schema:
            type: number
        - name: liquidity_max
          in: query
          required: false
          description: 最大流动性。
          schema:
            type: number
        - name: volume_min
          in: query
          required: false
          description: 最小交易量。
          schema:
            type: number
        - name: volume_max
          in: query
          required: false
          description: 最大搜索量。
          schema:
            type: number
        - name: start_date_min
          in: query
          required: false
          description: 筛选在此 ISO 时间戳之后开始的事件。
          schema:
            type: string
            format: date-time
        - name: start_date_max
          in: query
          required: false
          description: 筛选在此 ISO 时间戳之前开始的事件。
          schema:
            type: string
            format: date-time
        - name: end_date_min
          in: query
          required: false
          description: 筛选在此 ISO 时间戳之后结束的事件。
          schema:
            type: string
            format: date-time
        - name: end_date_max
          in: query
          required: false
          description: 筛选在此 ISO 时间戳之前结束的事件。
          schema:
            type: string
            format: date-time
      responses:
        '200':
          description: Polymarket 事件对象的顶层数组
          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: 请求错误 - 参数无效
          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: 内部服务器错误
          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: 您的 AIsa API 密钥，作为 Bearer token 提供。

````