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

# Get top holders for markets

> Get top holders for one or more markets.



## OpenAPI

````yaml openapi/polymarket-data.json GET /apis/v1/polymarket/holders
openapi: 3.1.0
info:
  description: ''
  title: Polymarket Data
  version: '1'
  x-aisa-capabilities:
    idempotency: Idempotency-Key
    max_price: X-AISA-Max-Price-USD
    quote:
      header: X-AISA-Cost-Mode
      value: quote
  x-aisa-configured-paths:
    - /apis/v1/polymarket/activity
    - /apis/v1/polymarket/closed-positions
    - /apis/v1/polymarket/holders
    - /apis/v1/polymarket/live-volume
    - /apis/v1/polymarket/oi
    - /apis/v1/polymarket/positions
    - /apis/v1/polymarket/traded
    - /apis/v1/polymarket/v1/accounting/snapshot
    - /apis/v1/polymarket/v1/builders/leaderboard
    - /apis/v1/polymarket/v1/builders/volume
    - /apis/v1/polymarket/v1/leaderboard
    - /apis/v1/polymarket/v1/market-positions
    - /apis/v1/polymarket/value
  x-aisa-document:
    facts_hash: feb7e7e799d9177ec0f8882f97e02989b98ffb3fbe1ccec4889e76a0a2aa653d
    generator_version: '2'
    protocol_version: '1'
    schema_version: '1'
    composer_version: '13'
    response_pending: []
    document_hash: sha256:74a76870f8ab0c802f330a8dabec1556aae0a5e3ff3735553eb70c60d5871dbd
  x-aisa-plans:
    builder: 1
    display_plan: payg
    payg: 1
    similarweb_payg: 1
    team: 1
    version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
  x-aisa-provider: polymarket-data
  x-aisa-catalogs:
    polymarket-data:
      title: Polymarket Data
      description: ''
      x-aisa-document:
        facts_hash: feb7e7e799d9177ec0f8882f97e02989b98ffb3fbe1ccec4889e76a0a2aa653d
        generator_version: '2'
        protocol_version: '1'
        schema_version: '1'
      x-aisa-plans:
        builder: 1
        display_plan: payg
        payg: 1
        similarweb_payg: 1
        team: 1
        version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
      x-aisa-capabilities:
        idempotency: Idempotency-Key
        max_price: X-AISA-Max-Price-USD
        quote:
          header: X-AISA-Cost-Mode
          value: quote
servers:
  - url: https://api.aisa.one
security:
  - bearerAuth: []
paths:
  /apis/v1/polymarket/holders:
    get:
      tags:
        - default
      summary: Get top holders for markets
      description: Get top holders for one or more markets.
      operationId: any_polymarket_data_apis_v1_polymarket_holders
      parameters:
        - in: query
          name: limit
          schema:
            type: integer
            default: 20
            minimum: 0
            maximum: 20
          description: Maximum number of holders to return per token. Capped at 20.
        - in: query
          name: market
          required: true
          style: form
          explode: false
          schema:
            type: array
            items:
              type: string
              description: 0x-prefixed 64-hex string
              pattern: ^0x[a-fA-F0-9]{64}$
              example: >-
                0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917
          description: Comma-separated list of condition IDs.
        - in: query
          name: minBalance
          schema:
            type: integer
            default: 1
            minimum: 0
            maximum: 999999
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Response65D835437A58_MetaHolder'
        default:
          content:
            application/json:
              schema: {}
          description: >-
            Error response; upstream passthrough responses may use provider
            formats
components:
  schemas:
    Response65D835437A58_MetaHolder:
      type: object
      properties:
        token:
          type: string
        holders:
          type: array
          items:
            $ref: '#/components/schemas/Response65D835437A58_Holder'
    Response65D835437A58_Holder:
      type: object
      properties:
        proxyWallet:
          $ref: '#/components/schemas/Response65D835437A58_Address'
        bio:
          type: string
        asset:
          type: string
        pseudonym:
          type: string
        amount:
          type: number
        displayUsernamePublic:
          type: boolean
        outcomeIndex:
          type: integer
        name:
          type: string
        profileImage:
          type: string
        profileImageOptimized:
          type: string
    Response65D835437A58_Address:
      type: string
      description: User Profile Address (0x-prefixed, 40 hex chars)
      pattern: ^0x[a-fA-F0-9]{40}$
      example: '0x56687bf447db6ffa42ffe2204a05edaa20f55839'
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.