Skip to main content

/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
  }
]