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

# List available tags

> List all unique event tags available for discovery filtering.

Tags are normalized to lowercase and sorted alphabetically.
Use the returned tags with the `tags` parameter on series, events, and markets endpoints.



## OpenAPI

````yaml /openapi.json get /v1/tags
openapi: 3.1.0
info:
  title: PolyOrderbooks API
  description: >
    # PolyOrderbooks API


    Historical Polymarket **crypto** market data — discovery, prices, liquidity
    metrics, and L2 order books. Read paths query our historical data store;
    they never call Polymarket live.


    ## Base URL


    `https://api.polyorderbooks.com`


    ## Authentication


    All `/v1/*` data routes require an API key.


    Send `X-API-Key: pob_…` or `Authorization: Bearer pob_…`. Dashboard JWT
    session tokens are **not** accepted on data routes.


    ## Plans (hosted)


    | Plan | Req/min | Req/day | Finest resolution | History |

    | --- | --- | --- | --- | --- |

    | Starter | 60 | 1,000 | 60s | 7 days |

    | Pro | 300 | 50,000 | 1s | 31 days |

    | Scale | 1,000 | 200,000 | 1s | 90 days |


    ## Workflow


    1. `GET /v1/markets` — discover

    2. `GET /v1/markets/{id_or_slug}` — detail

    3. `GET /v1/markets/{id_or_slug}/books` — history
  version: 0.1.0
servers:
  - url: https://api.polyorderbooks.com
    description: Production
security: []
tags:
  - name: Discovery
    description: >-
      Discover series, events, and markets. Use returned ids or slugs in History
      endpoints.
  - name: History
    description: Historical metrics, prices, and L2 order book snapshots.
  - name: Utility
    description: Usage and account metadata.
paths:
  /v1/tags:
    get:
      tags:
        - Discovery
      summary: List available tags
      description: >-
        List all unique event tags available for discovery filtering.


        Tags are normalized to lowercase and sorted alphabetically.

        Use the returned tags with the `tags` parameter on series, events, and
        markets endpoints.
      operationId: list_tags_v1_tags_get
      responses:
        '200':
          description: All unique tags sorted alphabetically.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TagListResponse'
        '401':
          description: API key is missing, invalid, or expired.
          content:
            application/json:
              example:
                detail: Invalid or expired API key.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation error for one or more request parameters.
          content:
            application/json:
              example:
                detail:
                  - loc:
                      - query
                      - limit
                    msg: Input should be less than or equal to 1000
                    type: less_than_equal
        '429':
          description: Rate limit exceeded for the current API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                detail: Rate limit exceeded. Please try again later.
        '500':
          description: Unexpected server-side error.
          content:
            application/json:
              example:
                detail: Failed to fetch data.
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    TagListResponse:
      properties:
        count:
          type: integer
          minimum: 0
          title: Count
          description: Number of unique tags.
        data:
          items:
            type: string
          type: array
          title: Data
          description: Sorted list of unique tag strings.
      type: object
      title: TagListResponse
      description: |-
        Response for `GET /tags`.

        Returns all unique event tags available for discovery filtering.
        Tags are normalized to lowercase and sorted alphabetically.
      example:
        count: 4
        data:
          - bitcoin
          - crypto
          - politics
          - sports
    ErrorResponse:
      properties:
        detail:
          type: string
          title: Detail
          description: Human-readable error description.
      type: object
      title: ErrorResponse
      description: Generic API error response.

````