Skip to main content

/accounts/:address:/tokens/:token:

Returns details about a specific fungible token from a given address​

Parameters​

  • address REQUIRED (string) - account bech32 address
  • token REQUIRED (string) - the token identifier (example: WEGLD-bd4d79)

Returns​

Object - a list of all available fungible tokens for a given address

  • identifier: (string) - token identifier
  • name: (string) - The username specific for this account
  • ticker: (string) - a random string 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
  • marketCap : (number) - marketCap value
  • balance: (number) - Account current balance
  • valueUsd : (number)

Example Request and Result for /accounts/:address:/tokens/:token:​

Request:

curl -X 'GET' \
  'https://elrond-api.public.blastapi.io/accounts/erd1xvmata3rkwmp4h4jxr5ngzzq2zm0p2ev6672xvj3mpmvj2zwlttq87uh9q/tokens/ALT' \
  -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,
  "balance": "1480000000000000000",
  "valueUsd": 0
}