Overview
Every DAS list method (getAssetsByOwner, getAssetsByGroup, getAssetsByCreator, getAssetsByAuthority, searchAssets, getTokenAccounts, getNftEditions and getSignaturesForAsset) returns results in pages. You can page in three ways:
Use one method per request. Mixing
page with cursor, before or after, or cursor with before or after, returns -32602.
Limits
limitsets the page size. The maximum and the default are both 1,000.pagestarts at 1.page: 0is rejected.- Batch methods (
getAssetBatch,getAssetProofBatch) take at most 1,000 IDs.
Page numbers
Passpage and limit. The response echoes page:
limit.
Cursors
When you send nopage, before or after, the API pages by cursor and returns a cursor value with each page. Pass it back to get the next page:
id, which is the default.
Ranges
before and after take asset IDs and return the assets between them. For example, after alone continues from a known asset ID:
id.
Sorting
Methods that list assets acceptsortBy:
string
id (default), created, updated, recent_action or none.string
asc (default) or desc.id works only with page numbers. Combining it with cursor, before or after returns -32602.