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.

post

/extensions/resource-holders/page

Header parameters

api-keystringrequired

Body

all of

Example: {"limit_per_page":100,"resource_address":"resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd"}

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://xrd-gateway.nownodes.io/extensions/resource-holders/page' \
  --header 'api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "limit_per_page": 100,
    "resource_address": "resource_rdx1tknxxxxxxxxxradxrdxxxxxxxxx009923554798xxxxxxxxxradxrd"
  }'

200

4XX

200

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

Resource holders