/accounts/{address}/roles/tokens/{identifier}

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

Parameters

• address REQUIRED (string) - account bech32 address

• identifier REQUIRED (string) - token identifier

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/{identifier}

Request:

curl -X 'GET' \
  'https://elrond-api.public.blastapi.io/accounts/erd160y56egs9q7en67z06jk8ndsgxxuc0srf4kx8gfwc7xmap7zqvtqv973la/roles/tokens/ELPS-c09dd3' \
  -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
}