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

# Market Catalog Stats

> Get complete market counts and open, closed, and inactive status totals.

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

## Request

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

## Response

```json theme={null}
{
  "market_count": 2662678,
  "event_linked_market_count": 2653204,
  "event_count": 900634,
  "status_counts": {
    "open": 544652,
    "closed": 2071666,
    "inactive": 46360
  }
}
```

Counts change as markets are added or their status changes.

| Field                       | Type    | Description                                           |
| --------------------------- | ------- | ----------------------------------------------------- |
| `market_count`              | integer | Markets in the complete catalog.                      |
| `event_linked_market_count` | integer | Markets with a parent event slug.                     |
| `event_count`               | integer | Distinct parent events represented by linked markets. |
| `status_counts.open`        | integer | Open markets.                                         |
| `status_counts.closed`      | integer | Closed markets.                                       |
| `status_counts.inactive`    | integer | Markets 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/markets/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/markets/stats:
    get:
      tags:
        - V3 Markets
      summary: Market catalog stats
      description: Return complete market, linked-market, event, and status counts.
      operationId: v3_market_catalog_stats
      responses:
        '200':
          description: Complete market counts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V3MarketCatalogStats'
        '401':
          description: Unauthorized
        '503':
          description: Markets and events are temporarily unavailable
      security:
        - api_key: []
components:
  schemas:
    V3MarketCatalogStats:
      type: object
      additionalProperties: false
      required:
        - market_count
        - event_linked_market_count
        - event_count
        - status_counts
      properties:
        market_count:
          type: integer
          minimum: 0
        event_linked_market_count:
          type: integer
          minimum: 0
        event_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

````