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

# Get All Token Holders (Paginated)

> Gets token holders with cursor-based pagination support. Returns holders sorted by amount in descending order.



## OpenAPI

````yaml /data-api/openapi.json get /tokens/{tokenAddress}/holders/paginated
openapi: 3.1.0
info:
  title: Solana Tracker Data API
  description: >-
    Solana Tracker Data API for token prices, holders, trades, charts, wallet
    data, risk signals, and market analytics.
  version: 1.0.0
  contact:
    email: contact@solanatracker.io
servers:
  - url: https://data.solanatracker.io
    description: Production server
security:
  - apiKey: []
paths:
  /tokens/{tokenAddress}/holders/paginated:
    get:
      tags:
        - Tokens
      summary: Get All Token Holders (Paginated)
      description: >-
        Gets token holders with cursor-based pagination support. Returns holders
        sorted by amount in descending order.
      parameters:
        - name: tokenAddress
          in: path
          required: true
          description: Solana token mint address
          schema:
            type: string
            pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
          example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        - name: limit
          in: query
          description: >-
            Number of holders to return per page (min: 1, max: 5000, default:
            1000)
          schema:
            type: integer
            minimum: 1
            maximum: 5000
            default: 1000
        - name: cursor
          in: query
          description: >-
            Cursor for pagination. Use the cursor from the previous response to
            get the next page.
          schema:
            type: string
            nullable: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedHoldersResponse'
              example:
                total: 629520
                accounts:
                  - wallet: 2RH6rUTPBJ9rUDPpuV9b8z1YL56k1tYU6Uk5ZoaEFFSK
                    account: HkykUVWTctptXZmRTWearMsH4SaQNmE4Ku3tMJe5v2mH
                    amount: 800000026.912776
                    value:
                      quote: 4794089882.482378
                      usd: 4794089882.482378
                    percentage: 80.00006034693021
                  - wallet: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
                    account: 7DaumTmUaK3xcpd8XJXAjUzDrCqPuj3S1Sc2cbootBUN
                    amount: 29442390.303223
                    value:
                      quote: 176436825.90046737
                      usd: 176436825.90046737
                    percentage: 2.944241152222513
                cursor: Cd3HX8ToTVeJYTN4dB6BuRvnvmTFeXHJ3E4EAfR9s8QA
                hasMore: true
                limit: 10
        '400':
          description: Bad Request - Invalid token address format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Invalid token address
        '404':
          description: Token not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Token not found, please check back later
        '502':
          description: Bad Gateway - Error fetching holders data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Unable to fetch holders data
        '504':
          description: Gateway Timeout - Request timeout while fetching holders data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Request timeout while fetching holders data
components:
  schemas:
    PaginatedHoldersResponse:
      type: object
      properties:
        total:
          type: integer
          description: Total number of token holders
        accounts:
          type: array
          description: Array of holder accounts for current page
          items:
            $ref: '#/components/schemas/PaginatedHolderAccount'
        cursor:
          type: string
          nullable: true
          description: Cursor for retrieving the next page. Null if no more pages.
        hasMore:
          type: boolean
          description: Indicates if there are more pages available
        limit:
          type: integer
          description: Number of items requested per page
      required:
        - total
        - accounts
        - cursor
        - hasMore
        - limit
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Error message
      required:
        - error
    PaginatedHolderAccount:
      type: object
      properties:
        wallet:
          type: string
          description: Owner wallet address
        account:
          type: string
          description: Token account address
        amount:
          type: number
          description: Token amount held
        value:
          type: object
          description: Value of tokens held
          properties:
            quote:
              type: number
              description: Value in quote currency
            usd:
              type: number
              description: Value in USD
          required:
            - quote
            - usd
        percentage:
          type: number
          description: Percentage of total supply held
      required:
        - wallet
        - account
        - amount
        - value
        - percentage
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: API Key for authentication

````