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

> 持币列表支持游标分页；按持仓量从高到低排序。

## SDK Example

<CodeGroup>
  ```typescript SDK
  import { Client } from '@solana-tracker/data-api';

  const client = new Client({ apiKey: 'YOUR_API_KEY' });

  const data = await client.getTokenHoldersPaginated('6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN', 100);

  ```
</CodeGroup>


## OpenAPI

````yaml /cn/data-api/openapi.json get /tokens/{tokenAddress}/holders/paginated
openapi: 3.1.0
info:
  title: Solana Tracker 数据 API
  description: Solana Tracker 数据 API：提供代币价格、持币地址、成交、图表、钱包数据、风险信号与市场分析等能力。
  version: 1.0.0
  contact:
    email: contact@solanatracker.io
servers:
  - url: https://data.solanatracker.io
    description: 生产环境
security:
  - apiKey: []
paths:
  /tokens/{tokenAddress}/holders/paginated:
    get:
      tags:
        - Tokens
      summary: Get All Token Holders (Paginated)
      description: 持币列表支持游标分页；按持仓量从高到低排序。
      parameters:
        - name: tokenAddress
          in: path
          required: true
          description: Solana 代币 mint 地址
          schema:
            type: string
            pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
          example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
        - name: limit
          in: query
          description: 每页返回持币地址条数（最小 1，最大 5000，默认 1000）
          schema:
            type: integer
            minimum: 1
            maximum: 5000
            default: 1000
        - name: cursor
          in: query
          description: 分页游标；使用上一页响应中的 cursor 请求下一页。
          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
      x-codeSamples:
        - lang: typescript
          label: SDK
          source: >
            import { Client } from '@solana-tracker/data-api';


            const client = new Client({ apiKey: 'YOUR_API_KEY' });


            const data = await
            client.getTokenHoldersPaginated('6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN',
            100);
      x-code-samples:
        - lang: typescript
          label: SDK
          source: >
            import { Client } from '@solana-tracker/data-api';


            const client = new Client({ apiKey: 'YOUR_API_KEY' });


            const data = await
            client.getTokenHoldersPaginated('6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN',
            100);
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

````