/tokenization/tokenGet Tokens
Outcome - Lists this vault's tokens: fungible tokens (ERC-20, ERC-3643, Solana) and ERC-721 collections. Solana NFTs are listed by Get NFTs.
Query Parameters
pagenumberdefault: 1nullablePage number, starting at 1.
limitnumberdefault: 10nullableNumber of results per page.
sortKeystringdefault: idnullableField to sort by. Allowed values: id.
orderstringnullableSort direction: ASC or DESC.
searchstringnullableSearch by name or symbol.
clientIdstringnullableYour client id (externalId). Returns only tokens owned by this client.
filtersobjectnullableFilters, passed as filters[field]=value. Only the fields listed below are accepted; any other field returns 422.
Show child parameters (5)
networkIdnumbernullableNetwork ID. Example: filters[networkId]=1
statusstringnullablePENDING, DEPLOYED, REVERTED, INSUFFICIENT_GAS, ERROR or NONCE_TOO_LOW
idnumbernullableToken ID
isCollectionbooleannullableNFTs: true for collections
parentIdnumbernullableNFTs: collection ID
Responses
Response attributes
messagestringResponse message
dataarrayThe tokens. Same fields as Get Token by ID, without vault.
Show child attributes (31)
idnumberToken ID. Use it in the token routes (Get Token by ID, Get Token Roles, Token Operations).
networkIdnumberNetwork the contract is deployed on
deployingWalletIdstringID of the vault wallet that sent the deployment
templateVersionstring | nullContract template: erc20-v1, erc721-v1, erc3643-v1 or title-fraction-v1. null for Solana tokens.
namestringToken name
symbolstringToken symbol
decimalsnumberDecimals of the token. Amounts in the API are in whole units with up to this many decimals.
feesstring | nullDeployment fee paid, in the network's coin. null until deployed.
contractAddressstring | nullContract address. null until deployed.
assetIdnumber | nullAsset created for the token once deployed: wallets of this asset hold the token. null until deployed.
vaultIdnumberVault that created the token
internalOwnerTypestring | nullCLIENT when the owner is a client's wallet, MASTER when it is a master wallet of the vault, null when the owner is outside RoxCustody
internalOwnerTargetIdnumber | nullThe RoxCustody client ID when internalOwnerType is CLIENT
ownerAddressstringOwner of the contract (the OWNER role)
recipientAddressstringAddress that received the initial supply (equal to ownerAddress when none was given)
configobjectThe config sent at creation (template settings). Solana and v1 tokens also carry metadataUrl and additional here.
verificationMessagestring | nullThe block explorer's answer to the source-code verification
verificationStatusstringSource-code verification on the block explorer: PENDING, VERIFIED, REJECTED, LimitReached or UNEXPECTED_ERROR
imagestring | nullImage URL, when an image was uploaded
isCollectionbooleantrue for an NFT collection
parentIdnumber | nullFor an NFT, its collection
parentobject | nullFor an NFT, its collection
childrenCountnumberFor a collection, number of NFTs in it
networkobjectThe network
Show child attributes (12)
idnumberNetwork ID
namestringNetwork name
symbolstringSymbol of the network's coin
createdAtstringCreation date
updatedAtstringLast update date
typestringPUBLIC or PRIVATE
statusstringNetwork status, for example ACTIVE
logostringNetwork logo URL
isSwappablebooleanWhether swaps are available on this network
categorystringNetwork family, for example EVM or Solana
chainobjectChain details: id, name, nativeCurrency, rpcUrls, blockExplorers and testnet
addressFormatobjectAddress format: prefixes and lengthRange
createdAtstringCreation date
updatedAtstringLast update date
typestringAsset type of the token: ERC20 for every fungible EVM token (ERC-20 and ERC-3643 alike), NFT_COLLECTION for an ERC-721 collection, TOKEN or NFT on Solana
standardstring | nullToken standard: ERC20, ERC3643, ERC721, SPL_TOKEN or SOLANA_NFT
statusstringDeployment status: PENDING, DEPLOYED, REVERTED, INSUFFICIENT_GAS, ERROR or NONCE_TOO_LOW
tokenExplorerUrlstring | nullLink to the contract on the block explorer. null until deployed.
initialSupplystringSupply minted at creation, in whole units. "0" for ERC-3643 and ERC-721, whose supply comes from later operations.
statusnumberHTTP status code
metaobjectPage pagination. Increase the page query parameter to get the next page.
Show child attributes (6)
totalItemsnumberTotal number of matching items
itemsPerPagenumberPage size used for this request
totalPagesnumberTotal number of pages
currentPagenumberThe page returned
hasPreviousPagebooleantrue if currentPage > 1
hasNextPagebooleantrue if currentPage < totalPages
Was this page helpful?