/accounts/{address}/roles/tokens

Returns fungible token roles where the account is owner or has some special roles assigned to it.

Parameters

• address REQUIRED (string) - account bech32 address

• from OPTIONAL (number) - the number of items to skip for the result set

• size OPTIONAL (number) - the number of items to retrieve

• search OPTIONAL (string) - search by collection identifier

• ownerOPTIONAL (string) - filter by collection owner

• canMintOPTIONAL (boolean) - filter by property canMint

• canBurnOPTIONAL (boolean) - filter by property canBurn

Returns

• identifier: (string) - token identifier

• name: (string) - the username specific for this account

• ticker: (string) - a random string that starts with “-” and has 6 more random characters

• owner: (string) - the owner's address

• minted : (number) - minted value

• burnt : (number) - burnt value

• initialMinted : (number) - initial minted value

• decimals: (number) - the number of decimals in order to display balance

• isPaused: (boolean) - specific property flag for smart contract - default value: false

• assets :

  • website : (string)

  • description : (string)

  • status : active/inactive

  • pngUrl : (string)

  • svgUrl : (string)

  • lockedAccounts : (array[string])

  • extraTokens : (array[string])

• transactions: (number) - transactions of the token

• accounts: (number) - account address of the token manager

• canUpgrade: (boolean) - specific property flag for smart contract, the token manager may change these properties - default value: false

• canMint: (boolean) - more units of this token can be minted by the token manager after initial issuance, increasing the supply - default value false

• canBurn: (boolean) - users may "burn" some of their tokens, reducing the supply - default value: false

• canChangeOwner: (boolean) - token management can be transferred to a different account - default value: false

• canPause: (boolean) - the token manager may prevent all transactions of the token, apart from minting and burning - default value: false

• canFreeze: (boolean) - the token manager may freeze the token balance in a specific account, preventing transfers to and from that account - default value: false

• canWipe: (boolean) - the token manager may wipe out the tokens held by a frozen account, reducing the supply - default value: false

• price : (number) - price value

• marketCap : (number) - marketCap value

• canLocalMint : (boolean)

• canLocalBurn : (boolean)

Example Request and Result for /accounts/{address}/roles/tokens

Request:

curl -X 'GET' \
  'https://elrond-api.public.blastapi.io/accounts/erd1m83yu75aw6r0vmznpet78jsguww3fuqll0k2rz64saf8e6p3e24s3zrap2/roles/tokens?from=2&size=1&search=ASTRO&owner=erd1m83yu75aw6r0vmznpet78jsguww3fuqll0k2rz64saf8e6p3e24s3zrap2&canMint=true&canBurn=true' \
  -H 'accept: application/json'

Result:

[
  {
    "identifier": "string",
    "name": "string",
    "ticker": "string",
    "owner": "string",
    "minted": "3940000000000000000",
    "burnt": "1250000000000000000",
    "initialMinted": "4710000000000000000",
    "decimals": 0,
    "isPaused": false,
    "assets": {
      "website": "string",
      "description": "string",
      "status": "inactive",
      "pngUrl": "string",
      "svgUrl": "string",
      "lockedAccounts": [
        "string"
      ],
      "extraTokens": [
        "string"
      ]
    },
    "transactions": 0,
    "accounts": 0,
    "canUpgrade": false,
    "canMint": false,
    "canBurn": false,
    "canChangeOwner": false,
    "canPause": false,
    "canFreeze": false,
    "canWipe": false,
    "price": 0,
    "marketCap": 0,
    "canLocalMint": false,
    "canLocalBurn": false
  }
]