Holders

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:

{
  "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.