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

# Event Catalog Stats

> Get complete event, member-market, and event-status counts.

Returns counts for the complete [event catalog](/data/events/catalog),
independent of any one page.

## Request

```bash theme={null}
curl "https://api.polynode.dev/v3/events/stats" \
  -H "x-api-key: $POLYNODE_API_KEY"
```

## Response

```json theme={null}
{
  "event_count": 900634,
  "member_market_count": 2653204,
  "catalog_market_count": 2662678,
  "status_counts": {
    "open": 99115,
    "closed": 800390,
    "inactive": 1129
  }
}
```

Counts change as events and their member markets change.

| Field                    | Type    | Description                                                                      |
| ------------------------ | ------- | -------------------------------------------------------------------------------- |
| `event_count`            | integer | Events in the complete event catalog.                                            |
| `member_market_count`    | integer | Markets linked to those events.                                                  |
| `catalog_market_count`   | integer | Markets in the complete market catalog, including markets without an event slug. |
| `status_counts.open`     | integer | Open events.                                                                     |
| `status_counts.closed`   | integer | Closed events.                                                                   |
| `status_counts.inactive` | integer | Events that are neither open nor closed.                                         |

## Errors

| Status | Error                     | When it occurs                                  |
| ------ | ------------------------- | ----------------------------------------------- |
| `401`  | authentication error      | The API key is missing or invalid.              |
| `503`  | `temporarily_unavailable` | Markets and events are temporarily unavailable. |


## OpenAPI

````yaml GET /v3/events/stats
openapi: 3.1.0
info:
  title: PolyNode API
  description: >-
    Real-time Polymarket data API with decoded mempool settlements, OHLCV
    candles, and full Polygon JSON-RPC proxy.
  contact:
    name: PolyNode
    url: https://polynode.dev
  license:
    name: ''
  version: 2.0.0
servers:
  - url: https://api.polynode.dev
    description: Production
security:
  - api_key: []
paths:
  /v3/events/stats:
    get:
      tags:
        - V3 Events
      summary: Event catalog stats
      description: Return complete event, member-market, market, and status counts.
      operationId: v3_event_catalog_stats
      responses:
        '200':
          description: Complete event counts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V3EventCatalogStats'
        '401':
          description: Unauthorized
        '503':
          description: Markets and events are temporarily unavailable
      security:
        - api_key: []
components:
  schemas:
    V3EventCatalogStats:
      type: object
      additionalProperties: false
      required:
        - event_count
        - member_market_count
        - catalog_market_count
        - status_counts
      properties:
        event_count:
          type: integer
          minimum: 0
        member_market_count:
          type: integer
          minimum: 0
        catalog_market_count:
          type: integer
          minimum: 0
        status_counts:
          $ref: '#/components/schemas/V3CatalogStatusCounts'
    V3CatalogStatusCounts:
      type: object
      additionalProperties: false
      required:
        - open
        - closed
        - inactive
      properties:
        open:
          type: integer
          minimum: 0
        closed:
          type: integer
          minimum: 0
        inactive:
          type: integer
          minimum: 0
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````