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

# Get token holders

> Returns a ranked list of token holders for a specific denomination, ordered by amount.



## OpenAPI

````yaml /api-reference/rollup-indexer/openapi.yaml get /indexer/richlist/v1/{denom}
openapi: 3.1.0
info:
  title: Indexer API
  description: >-
    Query indexed data including transactions, blocks, NFTs, and token holders
    across Initia Stack chains.
  version: 1.0.0
servers:
  - url: https://rollytics-api-evm-1.anvil.asia-southeast.initia.xyz
    description: evm-1 (testnet)
  - url: https://rollytics-api-move-1.anvil.asia-southeast.initia.xyz
    description: move-1 (testnet)
  - url: https://rollytics-api-wasm-1.anvil.asia-southeast.initia.xyz
    description: wasm-1 (testnet)
security: []
paths:
  /indexer/richlist/v1/{denom}:
    get:
      tags:
        - Rich List
      summary: Get token holders
      description: >-
        Returns a ranked list of token holders for a specific denomination,
        ordered by amount.
      operationId: getTokenHolders
      parameters:
        - name: denom
          in: path
          description: >-
            The token denomination. Use URL encoding for denoms containing `/`
            (e.g., `l2%2F...`).
          required: true
          schema:
            type: string
        - $ref: '#/components/parameters/paginationKey'
        - $ref: '#/components/parameters/paginationOffset'
        - $ref: '#/components/parameters/paginationLimit'
        - $ref: '#/components/parameters/paginationCountTotal'
        - $ref: '#/components/parameters/paginationReverse'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  holders:
                    type: array
                    items:
                      $ref: '#/components/schemas/TokenHolder'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
components:
  parameters:
    paginationKey:
      name: pagination.key
      in: query
      description: Cursor key for pagination.
      required: false
      schema:
        type: string
    paginationOffset:
      name: pagination.offset
      in: query
      description: Number of records to skip.
      required: false
      schema:
        type: integer
    paginationLimit:
      name: pagination.limit
      in: query
      description: Maximum number of records to return. Defaults to 100.
      required: false
      schema:
        type: integer
        default: 100
    paginationCountTotal:
      name: pagination.count_total
      in: query
      description: Whether to return the total count. Defaults to `true`.
      required: false
      schema:
        type: boolean
        default: true
    paginationReverse:
      name: pagination.reverse
      in: query
      description: When `true`, returns results in descending order. Defaults to `true`.
      required: false
      schema:
        type: boolean
        default: true
  schemas:
    TokenHolder:
      type: object
      properties:
        account:
          type: string
          description: Holder address.
        amount:
          type: string
          description: Token balance.
    Pagination:
      type: object
      description: Pagination metadata for list responses.
      properties:
        previous_key:
          type: string
          nullable: true
          description: Cursor key for the previous page.
        next_key:
          type: string
          nullable: true
          description: Cursor key for the next page. Null when there are no more results.
        total:
          type: string
          description: Total number of records matching the query.

````