# Holders

> Intear API holders.get and holders.subscribe: a NEAR token's holders, largest balance first, paged or followed live.

This page is part of the Intear API docs. The Intear API is at `https://api.intea.rs` and `wss://api.intea.rs/ws`, with no API key. https://docs.intear.tech/api/llms-full.txt has all of its pages in one file, and https://docs.intear.tech/llms.txt lists every page of the Intear docs.

## `holders.get`

A page of a token's holders, largest balance first. HTTP: `/holders`.

| Param | Description |
| --- | --- |
| `token` | **Required** |
| `limit` | 1 to 100, default 50 |
| `cursor` | `next_cursor` from the page before |

Result:

```json
{
  "height": 219969899,
  "timestamp_millis": 1792003880287,
  "columns": ["account_id", "balance"],
  "rows": [["intents.near", "16981241773386170753431556038986"], ["omni.bridge.near", "11774926230871993514984106326729"]],
  "next_cursor": "okuTeRxxInKGe4IcSx7QTITIni8r8rF97Sru5STb1pOF4Z9c-zppy40-_EoYgaj2jgVBsoOPvi8kKHMVRVj-ccoacxBKaQbpG7y2obYYxNNXVzgSQ48jqRw",
  "total": 2197
}
```

`total` is the token's `holders`. `next_cursor` is `null` on the last page.

## `holders.subscribe`

| Param | Description |
| --- | --- |
| `token` | **Required** |
| `top` | **Required.** 1 to 1,000 |

The result is the `top` largest holders, as rows with `total`. Each push is `{ "sub", "height", "timestamp_millis", "set", "left" }`:

- `set`: `{ "<account>": "<balance>" }`, the new balances in the top, including accounts that came into it.
- `left`: accounts that fell out of it, when there are any.