Owners

get

https://api.reservoir.tools/owners/v2

Get owners with various filters applied, and a summary of their ownership. Useful for exploring top owners in a collection or attribute.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

collectionsSetId

string

Filter to a particular collection set id. Example: 8daa732ebe5db23f267e58d52f1c9b1879279bcdf4f78b8fb563390e6946ea65

collection

string

Filter to a particular collection with collection-id. Example: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63

contract

string

^0x[a-fA-F0-9]{40}$

Filter to a particular contract. Example: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63

token

string

^0x[a-fA-F0-9]{40}:[0-9]+$

Filter to a particular token. Example: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63:123

attributes

string

Filter to a particular attribute. Attributes are case sensitive. Note: Our docs do not support this parameter correctly. To test, you can use the following URL in your browser. Example: https://api.reservoir.tools/owners/v1?collection=0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63&attribute[Type]=Original or https://api.reservoir.tools/owners/v1?collection=0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63&attribute[Type]=Original&attribute[Type]=Sibling

offset

integer

≥ 0

Use offset to request the next batch of items. defaults to 0

limit

integer

1 to 500

Amount of items returned in response. Max limit is 500. defaults to 20

displayCurrency

string

^0x[a-fA-F0-9]{40}$

Input any ERC20 address to return result in given currency

Response

200Successful