Page

Get Resource Holders Page

A paginated endpoint to discover which global entities hold the most of a given resource. More specifically, it returns a page of global entities which hold the given resource, ordered descending by the total fungible balance / total count of non-fungibles stored in vaults in the state tree of that entity (excluding unclaimed royalty balances). This endpoint operates only at the current state version, it is not possible to browse historical data. Because of that, it is not possible to offer stable pagination as data constantly changes. Balances might change between pages being read, which might result in gaps or some entries being returned twice. Under default Gateway configuration, up to 100 entries are returned per response. This can be increased up to 1000 entries per page with the limit_per_page parameter.

POSThttps://xrd-gateway.nownodes.io/extensions/resource-holders/page

Header parameters

Body

application/json

cursornullable string

This cursor allows forward pagination, by providing the cursor from the previous request.

limit_per_pagenullable integer

The page size requested.

resource_addressAddress (string)

Bech32m-encoded human readable version of the address.

Response

2004XX

Resource holders

Body

application/json

total_countnullable integer (int64)

Total number of items in underlying collection, fragment of which is available in items collection.

next_cursornullable string

If specified, contains a cursor to query next page of the items collection.

items*array of ResourceHoldersCollectionItem (object)

Request

JavaScriptCurlPython

const response = await fetch('https://xrd-gateway.nownodes.io/extensions/resource-holders/page', {
    method: 'POST',
    headers: {
      "api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "limit_per_page": 100,
      "resource_address": "resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd"
    }),
});
const data = await response.json();

Response

2004XX

{
  "total_count": 0,
  "next_cursor": "text",
  "items": [
    {
      "type": "FungibleResource",
      "holder_address": "text",
      "last_updated_at_state_version": 0
    }
  ]
}