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

# holders

> Fetch token holders with balances, optional sort/filter, and cursor-based pagination.

### Returns

<ResponseField name="holders" type="HoldersResponse!">
  Paginated list of holders for a token. See [HoldersResponse](/api-reference/graphql/types/HoldersResponse).
</ResponseField>

### Arguments

<ResponseField name="input" type="HoldersInput!" required>
  Token and pagination/sort options. See [HoldersInput](/api-reference/graphql/types/HoldersInput).
</ResponseField>

### Example

```graphql theme={null}
query Holders {
  holders(input: {
    tokenId: "0xdac17f958d2ee523a2206206994597c13d831ec7:1",
    limit: 10,
    sort: { attribute: BALANCE, direction: DESC }
  }) {
    count
    cursor
    status
    top10HoldersPercent
    items {
      address
      balance
      shiftedBalance
      balanceUsd
    }
  }
}
```

### Playground

<iframe src={`https://graphql.mobula.io/graphql?query=${encodeURIComponent('query Holders($input: HoldersInput!) { holders(input: $input) { count cursor status top10HoldersPercent items { address balance shiftedBalance balanceUsd } } }')}&variables=${encodeURIComponent('{"input": {"tokenId": "0xdac17f958d2ee523a2206206994597c13d831ec7:1", "limit": 10, "sort": {"attribute": "BALANCE", "direction": "DESC"}}}')}`} title="GraphQL Playground" style={{ width: '100%', minHeight: '600px', border: '1px solid var(--color-border)', borderRadius: '8px' }} />