> ## Documentation Index
> Fetch the complete documentation index at: https://polymarket-data.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Holders

> Retrieve top holders for specific market outcome tokens.

`client.data.core.getHolders` reveals which wallets hold outcome tokens for the supplied markets.
Great for leaderboards and liquidity dashboards.

## Request

```ts theme={null}
const breakdown = await client.data.core.getHolders(params);
```

### Parameters

| Name         | Type                | Required | Default | Notes                        |
| ------------ | ------------------- | -------- | ------- | ---------------------------- |
| `market`     | `string[]`          | ✅        | –       | Condition IDs (0x + 64 hex). |
| `limit`      | `number` (0–500)    |          | `100`   | Holders per outcome token.   |
| `minBalance` | `number` (0–999999) |          | `1`     | Minimum balance filter.      |

## Response

```ts theme={null}
type HolderData = {
  token: string;
  holders: Array<{
    proxyWallet: string;
    bio: string;
    asset: string;
    pseudonym: string;
    amount: number;
    displayUsernamePublic: boolean;
    outcomeIndex: number;
    name: string;
    profileImage: string;
    profileImageOptimized: string;
  }>;
};
```

## Usage example

```ts theme={null}
const breakdown = await client.data.core.getHolders({
  market: ["0x49252732f0bfe99f2ab09366230607eb9562fa6a56557a10ddcd7dd2198cf588"],
  limit: 10,
});

breakdown.forEach((entry) => {
  console.log(`Token ${entry.token} has ${entry.holders.length} visible holders`);
});
```

## Failure modes

* Missing `market` → validation error.
* `limit` > 500 or malformed condition IDs → validation error.