Links
Comment on page

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

Last modified 1yr ago