User Tokens

get https://api.reservoir.tools/users/{user}/tokens/v10

Get tokens held by a user, along with ownership information such as associated orders and date acquired.

Path Params

user

string

required

Filter to a particular user. Example: 0xF296178d553C8Ec21A2fBD2c5dDa8CA9ac905A00

Query Params

community

string

Filter to a particular community, e.g. artblocks

collectionsSetId

string

Filter to a particular collection set. Example: 8daa732ebe5db23f267e58d52f1c9b1879279bcdf4f78b8fb563390e6946ea65

collection

array of strings

length between 1 and 100

Array of collections. Max limit is 100. Example: collections[0]: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63

collection

excludeCollections

array of strings

length ≤ 100

excludeCollections

contract

string

Filter to a particular contract, e.g. 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63

tokens

array of strings

length ≤ 50

Array of tokens. Max limit is 50. Example: tokens[0]: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63:704 tokens[1]: 0x8d04a8c79ceb0889bdd12acdf3fa9d207ed3ff63:979

tokens

normalizeRoyalties

boolean

If true, prices will include missing royalties to be added on-top. defaults to false

sortBy

string

Order the items are returned in the response. Options are acquiredAt, lastAppraisalValue and floorAskPrice. lastAppraisalValue is the value of the last sale. floorAskPrice is the collection floor ask defaults to acquiredAt

sortDirection

string

Order the items are returned in the response. defaults to desc

continuation

string

Use continuation token to request next offset of items.

limit

integer

1 to 200

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

includeTopBid

boolean

If true, top bid will be returned in the response. defaults to false

includeAttributes

boolean

If true, attributes will be returned in the response. defaults to false

includeLastSale

boolean

If true, last sale data including royalties paid will be returned in the response. defaults to false

includeRawData

boolean

If true, raw data is included in the response. defaults to false

includeDynamicPricing

boolean

If true, dynamic pricing data will be returned in the response. defaults to false

excludeSpam

boolean

If true, will filter any tokens marked as spam. defaults to false

excludeNsfw

boolean

If true, will filter any tokens marked as nsfw. defaults to false

onlyListed

boolean

If true, will filter any tokens that are not listed defaults to false

useNonFlaggedFloorAsk

boolean

If true, will return the collection non flagged floor ask. defaults to false

displayCurrency

string

Input any ERC20 address to return result in given currency. Applies to topBid and floorAsk.

tokenName

string

Filter to a particular token by name. This is case sensitive. Example: token #1

200Successful