Skip to main content

/accounts/:address:/roles/tokens/:identifier:

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
}