/tokens

Returns all tokens available on the blockchain

Parameters

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

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

• search OPTIONAL (string) - Search by collection identifier

• name OPTIONAL (string) - Search by token name

• identifier OPTIONAL (string) - Search by token identifier

• identifiers OPTIONAL (array[string]) - A comma-separated list of identifiers to filter by

• sort : (string) - Sorting criteria. Available values : accounts, transactions, price, marketCap

• order : (string) - Sorting order (asc / desc)

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

• price : (number) - price value

• marketCap : (number) - marketCap value

• supply : (number)

• circulatingSupply : (number)

• roles : (object)

  • address: (string) Account bech32 address

  • canLocalMint : (boolean)

  • canLocalBurn : (boolean)

  • roles : (array[string])

Example

Request

curl -X 'GET' \
  'https://elrond-api.public.blastapi.io/tokens?name=AstroElrond&identifier=ASTRO-91f2cc&sort=accounts&order=asc' \
  -H 'accept: application/json'

Result

[
  {
    "identifier": "ASTRO-91f2cc",
    "name": "AstroElrond",
    "ticker": "ASTRO-91f2cc",
    "owner": "erd1m83yu75aw6r0vmznpet78jsguww3fuqll0k2rz64saf8e6p3e24s3zrap2",
    "decimals": 18,
    "isPaused": false,
    "transactions": 87,
    "accounts": 62,
    "canUpgrade": true,
    "canMint": true,
    "canBurn": true,
    "canChangeOwner": true,
    "canPause": true,
    "canFreeze": true,
    "canWipe": true
  }
]