Qodex.ai

List all owned tokens (paginated)

GET {{baseUrl}}/nfts/ownership/tokens

Returns all tokens and their data in your workspace.

Request Params

KeyDatatypeRequiredDescription
blockchainDescriptorstringBlockchain descriptor filter
vaultAccountIdsstringA comma separated list of Vault Account IDs. Up to 100 are allowed in a single request. This field will be ignored when walletType=END_USER_WALLET or ncwId is provided.
ncwIdstringTenant's Non-Custodial Wallet ID
ncwAccountIdsstringA comma separated list of Non-Custodial account IDs. Up to 100 are allowed in a single request. This field will be ignored when walletType=VAULT_ACCOUNT or ncwId is not provided.
walletTypestringWallet type, it can be VAULT_ACCOUNT or END_USER_WALLET
idsstringA comma separated list of NFT IDs. Up to 100 are allowed in a single request.
collectionIdsstringA comma separated list of collection IDs. Up to 100 are allowed in a single request.
pageCursorstringPage cursor to fetch
pageSizestringItems per page (max 100)
sortstringSort by param, it can be one param or a list of params separated by comma
sortstringSort by param, it can be one param or a list of params separated by comma
orderstringOrder direction, it can be ASC for ascending or DESC for descending
statusstringToken ownership status
searchstringSearch owned tokens and their collections. Possible criteria for search: token name and id within the contract/collection, collection name, blockchain descriptor and name.
spambooleanToken ownership spam status.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{"paging":{"next":"\u003cstring\u003e"},"data":[{"id":"\u003cstring\u003e","tokenId":"\u003cstring\u003e","standard":"\u003cstring\u003e","balance":"\u003cstring\u003e","ownershipStartTime":"\u003cnumber\u003e","ownershipLastUpdateTime":"\u003cnumber\u003e","blockchainDescriptor":"ETHERLINK_TEST","status":"ARCHIVED","metadataURI":"\u003cstring\u003e","cachedMetadataURI":"\u003cstring\u003e","media":[{"url":"\u003cstring\u003e","contentType":"THREE_D"},{"url":"\u003cstring\u003e","contentType":"VIDEO"}],"spam":{"result":"\u003cboolean\u003e","source":"OWNER"},"collection":{"id":"\u003cstring\u003e","name":"\u003cstring\u003e","symbol":"\u003cstring\u003e"},"vaultAccountId":"\u003cstring\u003e","description":"\u003cstring\u003e","name":"\u003cstring\u003e","ncwId":"\u003cstring\u003e","ncwAccountId":"\u003cstring\u003e"},{"id":"\u003cstring\u003e","tokenId":"\u003cstring\u003e","standard":"\u003cstring\u003e","balance":"\u003cstring\u003e","ownershipStartTime":"\u003cnumber\u003e","ownershipLastUpdateTime":"\u003cnumber\u003e","blockchainDescriptor":"GUN_GUNZILLA_TEST","status":"ARCHIVED","metadataURI":"\u003cstring\u003e","cachedMetadataURI":"\u003cstring\u003e","media":[{"url":"\u003cstring\u003e","contentType":"IMAGE"},{"url":"\u003cstring\u003e","contentType":"SVG"}],"spam":{"result":"\u003cboolean\u003e","source":"SYSTEM"},"collection":{"id":"\u003cstring\u003e","name":"\u003cstring\u003e","symbol":"\u003cstring\u003e"},"vaultAccountId":"\u003cstring\u003e","description":"\u003cstring\u003e","name":"\u003cstring\u003e","ncwId":"\u003cstring\u003e","ncwAccountId":"\u003cstring\u003e"}]}