Tokens

Get GRC20-Token TotalSupply by ContractAddress

Returns the current amount of an GRC-20 token in circulation.

https://gatescan.org/api
   ?module=stats
   &action=tokensupply
   &contractaddress=0x02d06Ff5867C0797d2b9C338838Dc1c3A8BFfca2
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
contractaddress	the contract address of the GRC-20 token

Response

{
   "status":"1",
   "message":"success",
   "data":"100000000000000000"
}

Tip: The result is returned to wei.

Get GRC20-Token Account Balance for TokenContractAddress

Returns the current balance of an GRC-20 token of an address.

https://gatescan.org/api
   ?module=account
   &action=tokenbalance
   &contractaddress=0x02d06Ff5867C0797d2b9C338838Dc1c3A8BFfca2
   &address=0xc6ef7050fBe638ffD992343C4C8271B9aF605D6c
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
contractaddress	the contract address of the GRC-20 token
address	the string representing the address to check for token balance

Response

{
   "status":"1",
   "message":"success",
   "data":"100000000000000000"
}

Tip: The result is returned in the token's smallest decimal representation.
Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398

Get Historical GRC20-Token TotalSupply by ContractAddress & BlockNo

Returns the amount of an GRC-20 token in circulation at a certain block height.

https://gatescan.org/api
   ?module=stats
   &action=tokensupplyhistory
   &contractaddress=0x02d06Ff5867C0797d2b9C338838Dc1c3A8BFfca2
   &blockno=1000001
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
contractaddress	the contract address of the GRC-20 token
address	the string representing the address to check for token balance

Response

{
   "status":"1",
   "message":"success",
   "data":"100000000000000000"
}

Tip: The result is returned in the token's smallest decimal representation.
Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398

Get Historical GRC20-Token Account Balance for TokenContractAddress by BlockNo

Returns the balance of an GRC-20 token of an address at a certain block height.

https://gatescan.org/api
   ?module=account
   &action=tokenbalancehistory
   &contractaddress=0x02d06Ff5867C0797d2b9C338838Dc1c3A8BFfca2
   &address=0xc6ef7050fBe638ffD992343C4C8271B9aF605D6c
   &blockno=1000001
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
contractaddress	the contract address of the GRC-20 token
blockno	the integer block number to check total supply for eg. 1000001
address	the string representing the address to check for token balance

Response

{
   "status":"1",
   "message":"success",
   "data":"100000000000000000"
}

Tip: The result is returned in the token's smallest decimal representation.
Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398

Get Token Holder List by Contract Address

Return the current token holders and number of tokens held.

https://gatescan.org/api
   ?module=token
   &action=tokenholderlist
   &contractaddress=0x02d06Ff5867C0797d2b9C338838Dc1c3A8BFfca2
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
contractaddress	the contract address of the GRC-20 token

Response

{
   "status":"1",
   "message":"success",
   "data":[
      {
        TokenHolderAddress: '0xc6ef7050fbe638ffd992343c4c8271b9af605d6c',
        TokenHolderQuantity: '100000000000000000'
      },
      {
        TokenHolderAddress: '0x0000000000000000000000000000000000000000',
        TokenHolderQuantity: '0'
      }
    ]
}

Get Token Info by ContractAddress

Returns project information and social media links of an GRC20/GRC721/GRC1155 token.

https://gatescan.org/api
   ?module=token
   &action=tokeninfo
   &contractaddress=0x02d06Ff5867C0797d2b9C338838Dc1c3A8BFfca2
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
contractaddress	the contract address of the GRC-20 token

Response

{
   "status":"1",
   "message":"success",
   "data":{
      contract_address: '0x02d06ff5867c0797d2b9c338838dc1c3a8bffca2',
      symbol: 'VEF',
      name: 'Verify',
      total_supply: '100000000000000000',
      decimal: 9,
      holder: 1,
      transfer: 2,
      type: 'GRC20'
    }
}

Get Address GRC20 Token Holding

Returns the GRC-20 tokens and amount held by an address.

https://gatescan.org/api
   ?module=account
   &action=addresstokenbalance
   &address=0xc6ef7050fBe638ffD992343C4C8271B9aF605D6c
   &page=1
   &offset=100
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
address	the string representing the address to check for balance
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page

Response

{
   "status":"1",
   "message":"success",
   "data":[
      {
        TokenAddress: '0x5b118a360e3cb792ce9baf9e31db8a0d433eb64b',
        TokenQuantity: '0',
        TokenName: 'test',
        TokenSymbol: 'TT',
        TokenDivisor: 18
      },
      {
        TokenAddress: '0x99233ca43a0e9aa8ee5711e25e78a3420e6c9a5e',
        TokenQuantity: '0',
        TokenName: 'test',
        TokenSymbol: 'TT',
        TokenDivisor: 18
      },
      ...
    ]
}

Get Address GRC721 Token Holding

Returns the GRC-721 tokens and amount held by an address.

https://gatescan.org/api
   ?module=account
   &action=addresstokennftbalance
   &address=0x1877f7f5d174e154833fe2e2fe9817b37654538d
   &page=1
   &offset=100
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
address	the string representing the address to check for balance
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page

Response

{
   "status":"1",
   "message":"success",
   "data":[
      {
        TokenAddress: '0x12c4394ff84f8cc5ec7d01b4e7c6364f0abf3fb5',
        TokenQuantity: 100,
        TokenName: 'PXX',
        TokenSymbol: 'PXX'
      }
    ]
}

Get Address GRC721 Token Inventory By Contract Address

Returns the GRC-721 token inventory of an address, filtered by contract address.

https://gatescan.org/api
   ?module=account
   &action=addresstokennftinventory
   &address=0x1877f7f5d174e154833fe2e2fe9817b37654538d
   &contractaddress=0x12c4394ff84f8cc5ec7d01b4e7c6364f0abf3fb5
   &page=1
   &offset=100
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
address	the string representing the address to check for balance
contractaddress	the string representing the GRC-20 token contractaddress to check for inventory
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page

Response

{
   "status":"1",
   "message":"success",
   "data":[
      {
        TokenAddress: '0x12c4394ff84f8cc5ec7d01b4e7c6364f0abf3fb5',
        TokenId: '71'
      },
      {
        TokenAddress: '0x12c4394ff84f8cc5ec7d01b4e7c6364f0abf3fb5',
        TokenId: '73'
      },
      ...
    ]
}

Last updated on 2025/06/05